GET /v1/markets always has the current list.
Symbols
Every market has a short symbol, such asBTC or TSLA. You use it everywhere: in orders, in positions, and in URLs such as /v1/positions/TSLA.
- Symbols are case-insensitive when you send them, and upper case when we return them.
- Orders need the exact symbol.
TESLAis notTSLA: the API refuses the order and suggests the right symbol. It never guesses on an order. - The exchange’s own names for markets never appear in the API. We keep the mapping.
Search
Search is forgiving where orders are strict.q matches symbols, names and common aliases, and tolerates typos:
q, you get every market.
The market object
string
The identifier you use everywhere, for example
BTC.string
A readable name, for example
Bitcoin.string
crypto, equity, index, commodity or fx.string
open: all orders are accepted.reduce_only: only orders that reduce a position are accepted.halted: no orders are accepted.
string
Order sizes are multiples of this, in the asset’s units. An order sized by value is rounded down to it.
string
The smallest order, in USD, after rounding. It is $10. Closing a whole position is exempt.
string
The largest single order, in USD. Your API key can have a lower limit.
string
The current mark price. It is the price your positions are valued at, and the one profit and loss are calculated from.
string
The current hourly funding rate, as a fraction.
Funding
A perpetual future stays close to the asset’s price because longs and shorts pay each other every hour. The payment is called funding. Whenfunding_rate_hourly is positive, longs pay shorts; when it is negative, shorts pay longs.
For example, a rate of 0.0000125 on a 0.0125 an hour, or $0.30 a day. Funding is applied to your balance and appears on your position as funding_since_open.