v1

latestOpenAPI 3.1.02026-07-265385123.6 KB
Bulk Orders

Get bulk order fills

Retrieve fills for bulk orders with optional filtering by market, sequence number, or range. Shows execution details including price, size, and timestamp for each fill.

get/api/v1/bulk_order_fills

Query parameters

accountstring required

User account address (user query alias is also accepted)

marketstring

Filter by specific market address. Use all to disable market filtering.

sequence_numberinteger

Single sequence number to query. Mutually exclusive with start_sequence_number/end_sequence_number.

start_sequence_numberinteger

Start of sequence number range. Mutually exclusive with sequence_number.

end_sequence_numberinteger

End of sequence number range. Requires start_sequence_number when provided.

limitinteger

Effective page size (clamped to 1..=1000 at runtime)

offsetinteger

Page offset

Response

Bulk order fills retrieved successfully

event_uidinteger required
filled_sizenumber double required
is_bidboolean required
marketstring required
pricenumber double required
sequence_numberinteger required
trade_idstring required
transaction_unix_msinteger required
transaction_versioninteger required
userstring required

Example response

[
  {
    "market": "0xmarket123...",
    "sequence_number": 12345,
    "trade_id": "3647276",
    "transaction_unix_ms": 1730841600000,
    "transaction_version": 12345,
    "user": "0x123..."
  }
]