Get Instruments

Changed on

Get enabled instruments. When instrument_id is supplied, a permanently settled instrument is also returned, including its final settlement record. Other disabled instruments remain excluded. The presence of settlement means the instrument is delisted and cannot trade.

get/v1/info/instruments

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/info/instruments
  • Auth: none required

Query parameters

instrument_idinteger

Instrument ID

instrument_type'perpetual'

Instrument type

category'equity' | 'commodity' | 'index' | 'crypto'

Instrument category

Response

Instruments response.

instrument_idinteger required

Instrument ID

instrument_type'perpetual' required

Instrument type

category'equity' | 'commodity' | 'index' | 'crypto' required

Instrument category

isolated_onlyboolean required

Whether the instrument supports only isolated account margin. When false, both cross and isolated account margin modes are supported.

symbolstring required

Instrument symbol

display_symbolstring

Optional presentation override for the full instrument symbol, such as USA500-USD. Use display_symbol when present and fall back to symbol otherwise. This is a label, not an identifier; use instrument_id for trading and storage. Canonical symbol, base_asset, and price-feed identifiers are unchanged. Metadata normally refreshes once per minute; HTTP caching can add delay.

base_assetstring required

Base asset name

quote_assetstring required

Quote asset name

funding_intervalstring required

Funding interval

quantity_decimalsinteger required

Number of decimal places for quantity.

price_decimalsinteger required

Number of decimal places for price. Non-integer prices have a maximum of 5 significant figures; integer prices are allowed regardless of significant figures.

price_boundsstring required

Price bounds percentage

liquidation_feestring required

Liquidation fee rate

max_order_countinteger required

Maximum open order count

min_notionalstring required

Minimum notional value in USD

max_market_notionalstring required

Maximum market order notional value in USD

max_limit_notionalstring required

Maximum limit order notional value in USD

max_leverageinteger required

Maximum leverage

ui_live_timeinteger nullable required

Unix timestamp in milliseconds when first-party interfaces may display the instrument. A null value means hidden. This advisory field does not affect trading availability.

close_onlyboolean required

Whether user orders must be reduce-only. Pricing, funding, and risk management continue until settlement.

Example response

[
  {
    "symbol": "NVDA-USDC",
    "display_symbol": "USA500-USD",
    "base_asset": "NVDA",
    "quote_asset": "USDC",
    "funding_interval": "1h",
    "quantity_decimals": 2,
    "price_decimals": 2,
    "price_bounds": "0.05",
    "liquidation_fee": "0.025",
    "max_order_count": 200,
    "min_notional": "1.00",
    "max_market_notional": "1000000.00",
    "max_limit_notional": "10000000.00",
    "max_leverage": 20,
    "risk_tiers": [
      {
        "lower_bound": "0",
        "max_leverage": 20
      }
    ],
    "ui_live_time": 1786032000000
  }
]

Changes

  • 734bf911b1beRevision changes
    • breaking

      for the query request parameter instrument_id, the format changed from no format to int64

    • warning

      for the query request parameter instrument_id, the max was set to 4294967295.00

    • warning

      for the query request parameter instrument_id, the min was set to 0.00

    • info

      added the required property / to the response with the status

  • 953ba055eaebRevision changes
    • info

      added the required property / to the response with the status