Skip to main content

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 goodTillDate passed) 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 goodTillDate timestamp 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:

RequestedServed as
3m5m
30m15m
2h1h
6h4h
8h4h
12h4h
3d1d

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 FAQ
  • priceMatch (OPPONENT / QUEUE book-price order modes)
  • newOrderRespType (ACK / RESULT) — accepted on some endpoints but ignored