Skip to main content
GET
GET /v2/trade/perps/instruments: Instruments
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
The instruments you can trade, with their mark, index, funding and order rules. Instruments are named by the venue’s numeric instrument_id; order placement also accepts symbol (for example BTC-USD) as an alias. Scope perps.read. This route is always available: it never answers 409 PERPS_CAPABILITY_UNAVAILABLE.

Query Parameters

string
Only this instrument, by its symbol alias, for example BTC-USD.

Response

Each instrument carries, among its fields, the inputs of the order rules. Read the values from here rather than hard-coding them, because they can change.
integer
The venue’s instrument id. Every other Perps route names instruments by it.
string
The alias, for example BTC-USD.
string | null
The mark. price_bounds is measured from it, and an order without a price is valued at it. null when the mark is unavailable.
integer
Maximum decimal places of price.
integer
Maximum decimal places of quantity.
string
A fraction: |price − mark_price| ≤ mark_price × price_bounds. "0.05" would be 5%.
string
Minimum quantity × (price, or the mark without one). Closes are exempt; see Close a position.
string
Maximum notional of an order with a price.
string
Maximum notional of an order without a price.

Example