BlockTrades
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.
get/block-trades
Query parameters
status'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'COMPLETED' | 'CANCELLED'
Block trade status filter
marketstring
Market symbol filter, ex: BTC-USD-PERP
Response
OK
Example response
{
"next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
"prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
"results": [
{
"block_expiration": 1640995800000,
"block_id": "block_456",
"created_at": 1640995200000,
"initiator": "0x123...abc",
"last_updated_at": 1640995400000,
"nonce": "67890",
"parent_block_id": "block_123"
}
]
}