Sign in

v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB
Trades

GetUserFills

Returns individual trade-history records (fills) for one wallet, optionally scoped to a time range. Results are ordered oldest first (ascending by block time).

limit defaults to 100 and is capped at 500.

post/fill_history_service.v1.FillHistoryService/GetUserFills

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol. If omitted, use 1.

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

addressstring nullable required

Wallet address to fetch fills for. A blank value returns INVALID_ARGUMENT.

startTimestring date-time
endTimestring date-time
limitinteger nullable

Maximum number of fills to return. Defaults to 100 when omitted; capped at 500.

offsetinteger nullable

Number of matching fills to skip before collecting results. Defaults to 0.

Example request

{
  "startTime": "2023-01-15T01:30:15.01Z",
  "endTime": "2023-01-15T01:30:15.01Z"
}

Response

Success

Example response

{
  "fills": [
    {
      "timestamp": "2023-01-15T01:30:15.01Z"
    }
  ]
}