> ## 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 configuration.

```bash theme={null}
curl "https://api.polynode.dev/v3/perps/instruments?key=$POLYNODE_API_KEY"
```

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.

```json theme={null}
{
  "data": [
    {
      "instrument_id": 6,
      "instrument_type": "perpetual",
      "category": "crypto",
      "symbol": "BTC-USD",
      "base_asset": "BTC",
      "quote_asset": "pUSD",
      "funding_interval": "1h",
      "quantity_decimals": 5,
      "price_decimals": 0,
      "min_notional": "10",
      "max_leverage": 20,
      "risk_tiers": [
        { "lower_bound": "0", "max_leverage": 20 },
        { "lower_bound": "250000", "max_leverage": 10 }
      ],
      "first_seen": 1783569304465
    }
  ]
}
```

## 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.