getFillsByTime - Ostium

const fills = await client.getFillsByTime({
  startTime: Date.now() - 7 * 24 * 60 * 60 * 1000,
  endTime: Date.now(),
});

This method supports the same user and pair filters as getFills(). startTime and endTime are Unix milliseconds. endTime defaults to Date.now(). 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().

Parameters

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

Response schema

type Response = Array<{
  pairTo: string;
  pairFrom: string;
  pairId: string;
  oid: string;
  pid: string;
  limitId?: string;        // limit slot that opened the position; only on the Open fill of a triggered limit or stop
  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;
  leverage: string;        // position leverage, e.g. "10"
  profitPercent: string;   // price PnL percent, "10" = 10%; "0" on opens and collateral edits
  builder: string;
  fees: {
    opening: string;
    rollover: string;
    liquidation: string;
    builder: string;
    priceImpact: string;
    oracle: string;        // oracle fee actually charged on this order
  };
  closedPnl: string;
  hash: string;
  time: number;
  timestamp: number;
}>;