# 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"}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.pionex.com/docs/api-docs/zh-hant/futures-api/common.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.