Orders
The orders API contains a private endpoint for querying order state. Requires a base64-encoded SHA256 HMAC signature as defined in Authentication.
Querying Order State
| HTTP Method | Endpoint |
|---|---|
GET | /orders |
The endpoint supports the following query parameters:
| Parameter | Optionality | Notes |
|---|---|---|
symbol | optional | Filter orders by product symbol, only works in production |
product_id | optional | Filter orders by product ID, only works in production |
product_type | optional | Filter orders by product type, only works in production |
clearing_firm_code | optional | Filter orders by clearing firm code, only works in production |
account_id | optional | Filter orders by account code, only works in production |
connection_id | optional | Filter orders by connection ID, only works in production |
day | optional | Get range for day, overrides begin_time and end_time |
limit | optional | Limit number of orders per page |
begin_time | optional | Begin time for order time range, see Time for more details |
end_time | optional | End time for order time range, see Time for more details |
order | optional | Page order, either asc or desc |
cursor | optional | Cursor string for paginated query |
The endpoint returns a pagination response of the type Pagination<Order, CursorInfo>. More details
on paginated APIs can be found in Pagination.
Order is defined as follows:
export interface Order {
symbol: string;
product_id: number;
product_type: ProductType;
id: string;
connection_id: string;
clearing_firm_code: string;
account_id: string;
open_ack_id: string;
side: Side;
price: number;
quantity_requested: number;
quantity_filled: number;
status: OrderStatus;
time_in_force: TimeInForce;
}
export type ProductType = "Future" | "Spread" | "Option";
export type Side = 'Bid' | 'Ask';
export type OrderStatus = 'Working' | 'Closed';
export type TimeInForce = 'IOC' | 'Day' | 'GTC';
Start Trading
Leveraged spot, perpetuals, futures, options, and prediction markets, all on one CFTC-regulated exchange with crypto margin and settlement.
Signing up with Bitnomial, LLC 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.