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 Method | Endpoint |
|---|---|
GET | /block-trades |
The endpoint supports the following query parameters:
| Parameter | Notes |
|---|---|
symbol | Filter by product symbol, only works in production |
product_id | Filter by product ID, only works in production |
product_type | Filter by product type, only works in production |
clearing_firm_code | Filter by clearing firm code, only works in production |
account_id | Filter by account code, only works in production |
connection_id | Filter by connection ID, only works in production |
status | Block trade status filter |
day | Get range for day, overrides begin_time and end_time |
limit | Limit number of block trades per page |
begin_time | Begin time for block trade execution time range, see Time for more details |
end_time | End time for block trade execution time range, see Time for more details |
order | Page order, either asc or desc |
cursor | Cursor 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.
Signing up with Bitnomial, Inc. requires additional verification with an FCM to trade futures. Futures accounts are offered by Bitnomial Clearing, LLC, a CFTC-registered FCM and NFA member. Trading in futures involves substantial risks. You should only trade in financial products that you are familiar with and understand the associated risks, and after carefully considering whether such trading is suitable in light of your investment experience, financial position, and investment objectives. Leverage in futures trading can work for you or against you. The risk of loss using leverage can exceed your initial investment amount. See Bitnomial entity affiliation and registration disclosures and FCM financial and risk disclosures.