Production API ReferenceBlock Trades

List block trades

Get a paginated list of block trades with filtering.

Returns block trades where user is initiator, required signer, or has submitted an offer.

Filters:

  • Status: CREATED, OFFER_COLLECTION, READY_TO_EXECUTE, EXECUTING, COMPLETED, CANCELLED
  • Market: Specific market symbol (e.g., BTC-USD-PERP)

Returns: Paginated list with block trade details and navigation metadata.

Query parameters

statusenumOptional
Block trade status filter
marketstringOptional

Market symbol filter, ex: BTC-USD-PERP

Response

OK
nextstring or null

The pointer to fetch next set of records (null if there are no records left)

prevstring or null

The pointer to fetch previous set of records (null if there are no records left)

resultslist of objects or null

Errors