Skip to main content
GET
Get trades

Path Parameters

account
string<hex>
required

Account address (hex-encoded, 0x...). Required if instrument is not provided.

instrument
null | string<decimal>
required

Instrument id (hex string, 0x...). Required if account is not provided. An instrument identifier (8-byte hash).

Example:

"42"

startTime
null | integer<int64>
required

Start timestamp in milliseconds (optional, defaults to 24h ago).

Required range: x >= 0
endTime
null | integer<int64>
required

End timestamp in milliseconds (optional, defaults to now).

Required range: x >= 0
limit
integer | null
default:500
required

Maximum number of trades to return (optional, defaults to 500, max 1000).

Required range: x >= 0
count
integer | null
required

Alternative to startTime/endTime: number of latest trades per page (max 100).

Required range: 0 <= x <= 100
cursor
string | null
required

Opaque cursor returned by the previous count mode response.

Response

Trades

trades
object[]
required

Fill events for the requested account and/or instrument.

count
integer | null

Number of trades requested per page when count pagination mode is used.

Required range: x >= 0
Example:

50

nextCursor
string | null

Cursor for the next page when count pagination mode is used.

Example:

"eyJ0aW1lc3RhbXAiOjE3NzQzNjgxMDc1OTAsInJvdW5kIjoyOTA4MzQwMSwidHhJbmRleCI6MCwiZXZlbnRJbmRleCI6MCwiZXZlbnRJZCI6IjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAifQ"