Skip to main content
GET
Get a market

Authorizations

Authorization
string
header
required

An API key from the account page, sent as Authorization: Bearer tapi_….

Path Parameters

symbol
string
required

A market symbol from GET /v1/markets, for example BTC or TSLA. Case-insensitive.

Response

The market.

object
string
required
Allowed value: "market"
symbol
string
required

The market's identifier everywhere in the API, for example BTC or TSLA.

name
string
required

A human-readable name, for example Bitcoin or Tesla.

category
enum<string>
required
Available options:
crypto,
equity,
index,
commodity,
fx
status
enum<string>
required

open: all orders accepted. reduce_only: only orders that reduce a position. halted: no orders.

Available options:
open,
reduce_only,
halted
size_increment
string
required

Sizes are multiples of this. Orders sized by value are rounded down to it.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
min_value
string
required

The smallest order, in USD, after rounding. Closing a whole position is exempt.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
max_value
string
required

The largest order, in USD. Your key may have a lower limit; see GET /v1/api_key.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
price
string
required

The current mark price, used for your positions' value and profit and loss.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
funding_rate_hourly
string
required

The current hourly funding rate as a fraction. Positive means longs pay shorts.

Pattern: ^-?[0-9]+(\.[0-9]+)?$