> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ostium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getFillsByTime

> Fetch executed Ostium fills within a time range.

```ts theme={null}
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

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

## Response schema

```ts theme={null}
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;
}>;
```