get_fills

Instructions

Implementation Reference

• src/tools.ts:254-260 (handler)

  Handler for the 'get_fills' tool. Extracts 'address' (required), 'market' (optional), and 'limit' (optional, default 20) from args, calls api.getFills(), and returns JSON-stringified result.

  handler: async (args, api) => {
    const address = requireString(args, "address");
    const market = optionalString(args, "market", "");
    const limit = optionalNumber(args, "limit", 20);
    const data = await api.getFills(address, market, String(limit));
    return JSON.stringify(data, null, 2);
  },

• src/tools.ts:245-253 (schema)

  Input schema for 'get_fills' tool, defining address (required string), market (optional string), and limit (optional number, default 20).

  inputSchema: {
    type: "object",
    properties: {
      address: { type: "string", description: "Wallet address (e.g. 0x...)" },
      market: { type: "string", description: 'Optional market filter — native HL (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")' },
      limit: { type: "number", description: "Number of fills (1-100, default 20)" },
    },
    required: ["address"],
  },

• src/tools.ts:242-261 (registration)

  Tool registration entry for 'get_fills' in the tools array. Contains name, description, inputSchema, and handler.

  {
    name: "get_fills",
    description: "Get trade fills for a specific wallet address, optionally filtered by market",
    inputSchema: {
      type: "object",
      properties: {
        address: { type: "string", description: "Wallet address (e.g. 0x...)" },
        market: { type: "string", description: 'Optional market filter — native HL (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")' },
        limit: { type: "number", description: "Number of fills (1-100, default 20)" },
      },
      required: ["address"],
    },
    handler: async (args, api) => {
      const address = requireString(args, "address");
      const market = optionalString(args, "market", "");
      const limit = optionalNumber(args, "limit", 20);
      const data = await api.getFills(address, market, String(limit));
      return JSON.stringify(data, null, 2);
    },
  },

• src/api.ts:166-170 (helper)

  API helper method 'getFills' on the IronflowAPI class. Builds query params with address, limit, and optionally market, then GETs /v1/fills.

  async getFills(address: string, market: string = "", limit: string = "20"): Promise<unknown> {
    const params: Record<string, string> = { address, limit };
    if (market) params.market = market;
    return this.get("/v1/fills", params);
  }