> For the complete documentation index, see [llms.txt](https://www.pionex.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.pionex.com/docs/api-docs/futures-api/common.md).

# Common

Futures common information (public)

## Get futures symbols info

> Get all futures trading pair information. Weight: 5.

```json
{"openapi":"3.0.3","info":{"title":"Pionex Futures Open API","version":"1.0.0"},"tags":[{"name":"Common","description":"Futures common information (public)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"paths":{"/api/v1/common/symbols":{"get":{"tags":["Common"],"summary":"Get futures symbols info","description":"Get all futures trading pair information. Weight: 5.","operationId":"getFuturesSymbols","parameters":[{"name":"symbols","in":"query","description":"Comma-separated symbol list, e.g. BTC_USDT_PERP,ETH_USDT_PERP. When specified, `type` parameter is ignored.","schema":{"type":"string"}},{"name":"type","in":"query","description":"Market type. Defaults to SPOT. Only effective when `symbols` is not specified.","schema":{"type":"string","enum":["SPOT","PERP"]}},{"name":"status","in":"query","description":"Filter by status. Defaults to ALL. Only effective for PERP type.","schema":{"type":"string","enum":["ALL","TRADING","OFFLINE"],"default":"ALL"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"type":"object","properties":{"symbols":{"type":"array","items":{"$ref":"#/components/schemas/FuturesSymbolInfo"}}}}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Request success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"}}},"FuturesSymbolInfo":{"type":"object","properties":{"symbol":{"type":"string","description":"Futures symbol identifier (displaySymbol)"},"name":{"type":"string","description":"Futures symbol display name"},"contractType":{"type":"string","description":"Contract type","enum":["PERPETUAL"]},"baseCurrency":{"type":"string","description":"Base asset"},"quoteCurrency":{"type":"string","description":"Quote asset"},"basePrecision":{"type":"integer","description":"Base asset decimal places"},"quotePrecision":{"type":"integer","description":"Quote asset decimal places"},"minNotional":{"type":"string","description":"Minimum notional value"},"baseStep":{"type":"string","description":"Quantity step size (base asset)"},"quoteStep":{"type":"string","description":"Price step size (quote asset)"},"minSizeLimit":{"type":"string","description":"Minimum quantity for limit orders"},"maxSizeLimit":{"type":"string","description":"Maximum quantity for limit orders"},"maxImpactLimit":{"type":"string","description":"Maximum impact price ratio for limit orders"},"minSizeMarket":{"type":"string","description":"Minimum quantity for market orders"},"maxSizeMarket":{"type":"string","description":"Maximum quantity for market orders"},"maxImpactMarket":{"type":"string","description":"Maximum impact price ratio for market orders"},"maxOrderNum":{"type":"integer","description":"Maximum number of orders per user"},"status":{"type":"string","description":"Symbol trading status","enum":["TRADING","OFFLINE"]},"liquidationFeeRate":{"type":"string","description":"Liquidation fee rate"}}},"ErrorResponse":{"type":"object","properties":{"result":{"type":"boolean"},"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"timestamp":{"type":"integer","format":"int64"}}}},"responses":{"BadRequest":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}
```

## Get risk table

> Get risk limit tiers for futures symbols. Weight: 5.

```json
{"openapi":"3.0.3","info":{"title":"Pionex Futures Open API","version":"1.0.0"},"tags":[{"name":"Common","description":"Futures common information (public)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"paths":{"/api/v1/common/riskTable":{"get":{"tags":["Common"],"summary":"Get risk table","description":"Get risk limit tiers for futures symbols. Weight: 5.","operationId":"getRiskTable","parameters":[{"name":"symbol","in":"query","description":"Futures symbol. Returns all symbols if not specified.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"type":"object","properties":{"symbols":{"type":"array","items":{"$ref":"#/components/schemas/RiskTableEntry"}}}}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Request success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"}}},"RiskTableEntry":{"type":"object","properties":{"symbol":{"type":"string","description":"Futures symbol (displaySymbol)"},"rows":{"type":"array","description":"Risk tier rows","items":{"type":"object","properties":{"rowNum":{"type":"integer","description":"Tier level number"},"notionalLimit":{"type":"string","description":"Maximum notional value for this tier"},"maxLeverage":{"type":"string","description":"Maximum leverage for this tier"},"maintMarginRatio":{"type":"string","description":"Maintenance margin ratio"},"quickDeduction":{"type":"string","description":"Quick deduction amount"}}}}}},"ErrorResponse":{"type":"object","properties":{"result":{"type":"boolean"},"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"timestamp":{"type":"integer","format":"int64"}}}},"responses":{"BadRequest":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}
```