Skip to main content
GET

Authorizations

API-Key
string
header
required

Your public API key. Identifies the partner making the request.

API-Sign
string
header
required

HMAC signature over the request, computed with your API secret.

API-Timestamp
string
header
required

Time the request was signed, as Unix milliseconds. Included in the request signature. Requests signed too far from the server's time are rejected.

Path Parameters

account_id
string
required

Globally unique public identifier for an account.

Required string length: 14 - 42

Query Parameters

asset_type
enum<string>
default:perpetual

Classification of the trading instrument.

Available options:
perpetual
Example:

"perpetual"

page_size
integer<int32>
default:20

Maximum number of results to return. Ignored when page_token is present.

Required range: 1 <= x <= 100
Example:

20

page_token
string

Opaque token returned as next_page_token in the previous response. Omit to request the first page.

Required string length: 1 - 256
client_order_id
string<uuid>

Available for the International/EEA offering.

Filter by the reference supplied when creating an order. Use a lowercase, hyphenated UUID. Reused references can match multiple orders and fills. Other filters still apply. Partner-provided reference for tracking an order.

Example:

"550e8400-e29b-41d4-a716-446655440000"

order_id
string

Filter trades by the server-issued order identifier returned as id when creating or retrieving an order in the selected account. Treat it as an opaque value and pass it unchanged.

Required string length: 1 - 64
Example:

"FOPCDC6-PQIPJ-JLEIRY"

symbol
string

Filter trades by instrument symbol, ignoring case.

Required string length: 1 - 64
Pattern: ^\S+$
Example:

"PBTCUCZ0.BTNL"

start_timestamp
string<date-time>

Exclusive lower bound for executed_at. Sub-millisecond values are rejected. Must not be later than end_timestamp. RFC 3339 timestamp.

Example:

"2026-08-03T10:00:02.123Z"

end_timestamp
string<date-time>

Inclusive upper bound for executed_at. Sub-millisecond values are rejected. RFC 3339 timestamp.

Example:

"2026-08-03T10:00:02.124Z"

Response

Trades for the selected asset type.

data
object[]
required

Trades matching the selected filters.

next_page_token
string

Opaque token for retrieving the next page. Absent when there are no more results.

Required string length: 1 - 256