Skip to main content

Markets

Markets are the trading pairs we offer on Figure Markets. Each market is available in one or more market locations (e.g. US, Cayman). In each market, the denom is the asset being bought or sold. The quote (quoteDenom) is the currency used to price trades (e.g. USD).

Use these endpoints to list markets, get a market by symbol, order book, and candles. All read-only. No authentication.

See Public API (REST) — Base path. Paths below are relative to that base (for example GET /api/v1/markets).

Request and response shapes are in the Public API spec (Markets).

Important response fields (markets)​

  • symbol — Market id (e.g. ETH-USD). Use this in REST paths and WebSocket subscriptions.
  • denom / quoteDenom — Denom is the asset being bought or sold; quoteDenom is the currency used to price it (e.g. USD).
  • sizeIncrement / priceIncrement — Smallest allowed step for order quantity and price. Orders must be multiples of these.
  • minTradeQuantity — Minimum order size for the market.
  • denomExponent / quoteExponent — Decimal precision for the asset and quote. Amounts are often returned as integers; divide by 10^exponent for display (e.g. exponent 8 → divide by 10^8 for human-readable).
  • orderLimits — Min/max order size and notional, and optional price bands. Use when validating orders.
  • marketLocations — Where the market is available (e.g. US, CAYMAN). Matches the location filter.
  • Fees (e.g. makerFee, takerFee) — Fee structure (rate, basis points, minimum notional). Applied when orders execute.

Endpoints​

Get all markets​

Returns a paginated list of markets (trading pairs). Each market includes symbol, displayName, denom, quoteDenom, best bid/ask, last traded price, volume, and metadata (precision, fees, schedule). Markets can be in one or more locations; use the location query param to filter by market location (e.g. US, CAYMAN). Other filters: market_type, base_asset, quote_asset, and more.

Get all markets: GET /api/v1/markets — optional: page, size, location, market_type, base_asset, quote_asset, etc.

Get a market​

Returns a single market by symbol (e.g. ETH-USD) with full details: order book summary, fees, trading schedule, and limits.

Get a market: GET /api/v1/markets/{symbol}

Get order book​

Returns the current order book for a market (bids and asks). Optional depth and level control how many levels and aggregation; level 1 is best bid/ask only.

Get order book: GET /api/v1/markets/{symbol}/orderbook — optional: depth, level

Get market candles​

Returns OHLCV candle data for a market over a time range. Periods with no activity have no candle. Use interval_in_minutes and candle_type (e.g. MID_MARKET, TRADE) to shape the series.

Get market candles: GET /api/v1/markets/{symbol}/candles — optional: start_date, end_date, interval_in_minutes, candle_type

Symbols (e.g. ETH-USD) are market ids. For real-time data, use the WebSocket API. Full request/response shapes: Public API spec.