Block Trades

The block trades API contains private endpoints for querying block trades. It requires a Base64-encoded SHA256 HMAC signature as defined in Authentication.

HTTP MethodEndpoint
GET/block-trades

The endpoint supports the following query parameters:

ParameterNotes
symbolFilter by product symbol, only works in production
product_idFilter by product ID, only works in production
product_typeFilter by product type, only works in production
clearing_firm_codeFilter by clearing firm code, only works in production
account_idFilter by account code, only works in production
connection_idFilter by connection ID, only works in production
statusBlock trade status filter
dayGet range for day, overrides begin_time and end_time
limitLimit number of block trades per page
begin_timeBegin time for block trade execution time range, see Time for more details
end_timeEnd time for block trade execution time range, see Time for more details
orderPage order, either asc or desc
cursorCursor string for paginated query

The endpoint returns a pagination response of the type Pagination<BlockTrade, CursorInfo>. More details on paginated APIs can be found in Pagination. BlockTrade is defined as follows:

For more information on block trades, see Block Trades. For specifics on the status of a block trade, see Block Trade Statuses.

export interface BlockTrade {
  account_id: string;
  block_trade_id: number;
  counterparty_id: string;
  counterparty_email: string | null;
  symbol: string;
  side: Side;
  price: number;
  product_id: number;
  quantity: number;
  exec_time: string;
  report_time: string;
  status: BlockTradeStatus;
  status_reason: string | null;
  status_time: string | null;
}

export type BlockTradeStatus = 'Pending' | 'Canceled' | 'Rejected' | 'Confirmed' | 'Accepted';

Start Trading

Trade US Perpetual Futures, Physical Futures, and Options on the Bitcoin Complex®, XRP, ETH, SOL, and more.