> ## Documentation Index > Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt > Use this file to discover all available pages before exploring further. # Instruments > Every listed perps instrument with full contract config (leverage, risk tiers, precision, funding interval), plus `first_seen`. Filter with `?category=` (crypto, index, commodity, equity). Returns the complete exchange configuration for each instrument — symbol, category, leverage and risk tiers, precision, order size limits, funding interval — plus `first_seen`, the timestamp we first observed the listing. ## Query parameters | Parameter | Description | | ---------- | ---------------------------------------------------------------- | | `category` | Filter to one category: `crypto`, `index`, `commodity`, `equity` | New instruments appear automatically as Polymarket lists them — poll this endpoint (or watch `perps_tickers` on the WebSocket for unfamiliar ids) to pick up new listings. ## OpenAPI ````yaml GET /v3/perps/instruments openapi: 3.1.0 info: title: PolyNode API description: >- Real-time Polymarket data API with decoded mempool settlements, OHLCV candles, and full Polygon JSON-RPC proxy. contact: name: PolyNode url: https://polynode.dev license: name: '' version: 2.0.0 servers: - url: https://api.polynode.dev description: Production security: - api_key: [] paths: /v3/perps/instruments: get: tags: - Perps summary: List instruments description: >- Every listed perps instrument with full contract config (leverage, risk tiers, precision, funding interval), plus `first_seen`. Filter with `?category=` (crypto, index, commodity, equity). operationId: perps_instruments parameters: - name: category in: query required: false description: 'Filter to one category: crypto, index, commodity, equity.' schema: type: string - name: sort in: query required: false description: Sort by funding | oi | volume schema: type: string - name: min_funding in: query required: false description: Only instruments with funding rate >= this schema: type: number responses: '200': description: Success content: application/json: example: data: - base_asset: SP500 category: index first_seen: 1783598256140 funding_interval: 1h instrument_id: 1 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 1 quantity_decimals: 5 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: SP500-USD - base_asset: GOLD category: commodity first_seen: 1783598256140 funding_interval: 1h instrument_id: 2 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 1 quantity_decimals: 5 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: GOLD-USD - base_asset: WTIOIL category: commodity first_seen: 1783598256140 funding_interval: 1h instrument_id: 3 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 3 quantity_decimals: 3 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: WTIOIL-USD - base_asset: NAS100 category: index first_seen: 1783598256140 funding_interval: 1h instrument_id: 4 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 2 quantity_decimals: 4 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: NAS100-USD - base_asset: SILVER category: commodity first_seen: 1783598256140 funding_interval: 1h instrument_id: 5 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 3 quantity_decimals: 3 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: SILVER-USD - base_asset: BTC category: crypto first_seen: 1783598256140 funding_interval: 1h instrument_id: 6 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 1 quantity_decimals: 5 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: BTC-USD - base_asset: ETH category: crypto first_seen: 1783598256140 funding_interval: 1h instrument_id: 7 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 2 quantity_decimals: 4 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: ETH-USD - base_asset: SOL category: crypto first_seen: 1783598256140 funding_interval: 1h instrument_id: 8 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 4 quantity_decimals: 2 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: SOL-USD - base_asset: SPCX category: equity first_seen: 1783598256140 funding_interval: 1h instrument_id: 9 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 10 max_limit_notional: '250000' max_market_notional: '50000' max_order_count: 200 min_notional: '10' price_bounds: '0.10' price_decimals: 2 quantity_decimals: 4 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 10 - lower_bound: '200000' max_leverage: 5 - lower_bound: '500000' max_leverage: 3 - lower_bound: '1000000' max_leverage: 2 - lower_bound: '2000000' max_leverage: 1 symbol: SPCX-USD - base_asset: HYPE category: crypto first_seen: 1783598256140 funding_interval: 1h instrument_id: 10 instrument_type: perpetual liquidation_fee: '0.005' max_leverage: 20 max_limit_notional: '500000' max_market_notional: '100000' max_order_count: 200 min_notional: '10' price_bounds: '0.05' price_decimals: 3 quantity_decimals: 3 quote_asset: pUSD risk_tiers: - lower_bound: '0' max_leverage: 20 - lower_bound: '250000' max_leverage: 10 - lower_bound: '1000000' max_leverage: 8 - lower_bound: '2500000' max_leverage: 6 - lower_bound: '5000000' max_leverage: 5 - lower_bound: '7500000' max_leverage: 2 - lower_bound: '10000000' max_leverage: 1 symbol: HYPE-USD components: securitySchemes: api_key: type: apiKey in: header name: x-api-key ````