v1

latestOpenAPI 3.1.02026-07-265385123.6 KB
Bulk Orders

Get bulk orders

Retrieve the latest bulk orders for a specific user with optional market filtering. Returns one bulk order per market with current bid/ask levels and fills applied.

get/api/v1/bulk_orders

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.

Response

Bulk orders retrieved successfully

ask_pricesnumber[] required
ask_sizesnumber[] required
bid_pricesnumber[] required
bid_sizesnumber[] required
cancellation_reasonstring required
cancelled_ask_pricesnumber[] required
cancelled_ask_sizesnumber[] required
cancelled_bid_pricesnumber[] required
cancelled_bid_sizesnumber[] required
event_uidinteger required
marketstring required
previous_seq_numinteger nullable
sequence_numberinteger required
transaction_unix_msinteger required
transaction_versioninteger required
userstring required

Example response

[
  {
    "ask_prices": [
      101,
      102,
      103
    ],
    "ask_sizes": [
      1,
      2,
      3
    ],
    "bid_prices": [
      99,
      98,
      97
    ],
    "bid_sizes": [
      1,
      2,
      3
    ],
    "cancelled_ask_prices": [],
    "cancelled_ask_sizes": [],
    "cancelled_bid_prices": [
      100
    ],
    "cancelled_bid_sizes": [
      1
    ],
    "market": "0xmarket123...",
    "previous_seq_num": 12344,
    "sequence_number": 12345,
    "transaction_unix_ms": 1730841600000,
    "transaction_version": 12345,
    "user": "0x123..."
  }
]