Markets

Discover markets (symbols, instruments) and get order book or mid market price for order entry. The low latency Trader API spec exposes endpoints that will list symbols, list instruments, get instrument metadata, and subscribe to streaming market data (e.g. order book, best bid/ask). Use the account from Account where required.

---

Markets, instruments, and symbols

Market and instrument are the same thing: a tradable pair (e.g. ETH-USD). The symbol is the identifier for that pair — the market id you pass in order entry and in both APIs.

Term	Meaning
Symbol	Market id (e.g. ETH-USD). Use this in order entry, GetInstrumentMetadata, and subscription requests.
Market	The tradable pair. Used in the Public API: GET /v1/markets, GET /v1/markets/{symbol}, GET /v1/markets/{symbol}/orderbook.
Instrument	Same as market. The Trader API spec uses "instrument" (ListInstruments, GetInstrumentMetadata); it refers to the same tradables.

The same symbol (e.g. ETH-USD) is used in the Public API and in the Trader API. A market from GET /v1/markets or from List symbols / List instruments is the same tradable; use the symbol consistently in Orders and in the endpoints below.

Order entry: Only markets in your market location are available for order entry by default; see Orders. Some markets (e.g. stock-based assets on Figure Securities ATS) require additional onboarding (e.g. Figure Securities onboarding on the web) before the user can trade them.

---

List symbols

POST /api/v1/list_symbols

Returns the list of symbols (market ids) available for trading. Use these symbol values in order entry.

Key response: symbols list per spec.

---

List instruments

POST /api/v1/list_instruments

Returns instrument metadata for tradable markets. Use for symbol discovery and instrument-level details (e.g. precision, limits) in addition to or instead of List symbols. Supports optional pagination (page_size, page_token) per spec.

---

Get instrument metadata

POST /api/v1/get_instrument_metadata

Returns metadata for a single instrument by symbol. Use when you need details for one market (e.g. tick size, price bounds) before placing orders.

Key response: instrument metadata for order validation.

Example request body:

{
  "symbol": "ETH-USD"
}

---

Subscribe to market data

POST /api/v1/create_market_data_subscription — stream (application/x-ndjson)

Subscribe to streaming data for markets (e.g. order book, instrument state, stats). Use for low-latency order book or pricing instead of polling. The request may include optional symbols, unaggregated, depth, and snapshot_only per spec.

Example request body:

{
  "symbols": ["ETH-USD", "BTC-USD"],
  "depth": 10
}

Key stream messages: update (and optional heartbeat) per spec.

---

Public API alternative

For a list of markets and order book without Trader API authentication, the Public API — Markets provides GET /v1/markets, GET /v1/markets/{symbol}/orderbook, and GET /v1/markets/{symbol}. That API may not be low latency; for order book and pricing in the trading path, prefer the endpoints above. Only markets in your market location (e.g. filter by location in the Public API) are valid for order entry — see Orders.

Full request/response shapes: Trader API spec (low-latency).