Common Enum Definitions
Public API Parameters
Terminology
base asset refers to the asset being traded in a trading pair, i.e., the asset listed first. quote asset refers to the pricing asset in a trading pair, i.e., the asset listed second.
Enum Definitions
Trading Pair Type:
FUTURE Futures
Contract Type (contractType):
- PERPETUAL Perpetual Contract
This is the only contract type. Delivery contracts are not offered.
Contract Status (contractStatus, status):
- TRADING Trading
- HALT Trading suspended
- CLOSE Delisted / close-only
Order Status (status):
- NEW New order (accepted, resting or pending)
- PARTIALLY_FILLED Partially filled
- FILLED Fully filled
- CANCELED Canceled
- REJECTED Order rejected
Conditional (algo) orders can additionally report:
- EXPIRED The trigger order expired (e.g. its
goodTillDatepassed) before triggering
The algoStatus field on algo order endpoints uses: NEW, TRIGGERED, FINISHED, CANCELED, EXPIRED, FAILED.
Order Types (orderTypes, type):
- LIMIT Limit Order
- MARKET Market Order
- STOP Stop Limit Order
- STOP_MARKET Stop Market Order
- TAKE_PROFIT Take Profit Limit Order
- TAKE_PROFIT_MARKET Take Profit Market Order
- TRAILING_STOP_MARKET Trailing Stop Order
Order Side (side):
- BUY Buy
- SELL Sell
Position Side (positionSide):
- BOTH One-way position mode (the only accepted value on order placement)
Hedge mode is not available: enabling it via POST /fapi/v1/positionSide/dual returns error -4059, and sending a positionSide other than BOTH on an algo order returns -1130. LONG / SHORT appear only as read-only field values in position query responses (e.g. GET /fapi/v1/positionRisk).
Time in Force (timeInForce):
- GTC - Good Till Cancel: order remains valid until canceled
- IOC - Immediate or Cancel: any portion that cannot be immediately filled (as taker) is canceled
- FOK - Fill or Kill: if the order cannot be fully filled immediately, it is canceled entirely
- GTX - Good Till Crossing (Post Only): if the order cannot be a maker order, it is rejected
- GTD - Good Till Date: supported only on conditional (algo) orders, and requires a
goodTillDatetimestamp at least 600 seconds in the future. Sending GTD on a regular order returns error-1102.
Conditional Price Trigger Type (workingType)
- MARK_PRICE
- CONTRACT_PRICE
Note: this field is currently accepted but ignored — trigger conditions are always evaluated against the mark price. The value is not persisted, so query responses always report CONTRACT_PRICE.
Kline/Candlestick Intervals:
m -> minutes; h -> hours; d -> days; w -> weeks; M -> months
Natively supported intervals (REST GET /fapi/v1/klines and WebSocket kline channels):
- 1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M
On REST, the following Binance-style intervals are accepted but silently mapped to the closest supported interval:
| Requested | Served as |
|---|---|
| 3m | 5m |
| 30m | 15m |
| 2h | 1h |
| 6h | 4h |
| 8h | 4h |
| 12h | 4h |
| 3d | 1d |
Any other interval returns error -1120. On WebSocket, only the eight native intervals produce data — subscribing with any other interval is acknowledged but pushes nothing.
Not Implemented
The following Binance parameters are not implemented on this API:
selfTradePreventionMode(STP modes EXPIRE_TAKER / EXPIRE_MAKER / EXPIRE_BOTH) — see FAQpriceMatch(OPPONENT / QUEUE book-price order modes)newOrderRespType(ACK / RESULT) — accepted on some endpoints but ignored