getFills - Ostium

const fills = await client.getFills({ limit: 100 });

Filter by pair:

const fills = await client.getFills({ pairId: 0, limit: 100 });

Across all traders:

const fills = await client.getFills({ user: 'ALL', pairId: 0 });

Parameters

interface GetFillsParams {
  user?: `0x${string}` | 'ALL';
  pairId?: string | number;
  limit?: number;
}

On OstiumClient, user defaults to the connected trader. Pass user: 'ALL' to remove the trader filter. oid is the on-chain keeper order id formatted as a base-10 numeric string. It uses the same id space as Order.oid and the value returned by extractOrderIdFromReceipt().

Response schema

type Response = Array<{
  pairTo: string;
  pairFrom: string;
  pairId: string;
  oid: string;
  pid: string;
  trader: string;
  side: 'B' | 'S';
  action: 'Open' | 'Close' | 'Liquidation' | 'StopLoss' | 'TakeProfit' | 'RemoveCollateral' | 'CloseDayTrade';
  type: 'Market' | 'Limit' | 'REMOVE_COLLATERAL';
  px: string;
  szi: string;
  ntl: string;
  collateralUsed: string;
  builder: string;
  fees: {
    opening: string;
    rollover: string;
    liquidation: string;
    builder: string;
    priceImpact: string;
  };
  closedPnl: string;
  hash: string;
  time: number;
  timestamp: number;
}>;