Skip to main content
A market is a perpetual future on one asset, quoted in US dollars. You can go long or short on it without owning the asset, and without an expiry date. The catalog includes major crypto assets, such as BTC, ETH and SOL, and real-world assets, such as TSLA. GET /v1/markets always has the current list.

Symbols

Every market has a short symbol, such as BTC 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. TESLA is not TSLA: 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 is forgiving where orders are strict. q matches symbols, names and common aliases, and tolerates typos:
The list is short, so it is never paged. Without 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. When funding_rate_hourly is positive, longs pay shorts; when it is negative, shorts pay longs. For example, a rate of 0.0000125 on a 1,000longcostsabout1,000 long costs about 0.0125 an hour, or $0.30 a day. Funding is applied to your balance and appears on your position as funding_since_open.

Trading hours

Every market trades around the clock, every day, including real-world assets such as TSLA.