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

# Market Data

## Symbols Config

> Return tradable symbol configuration and market metadata for supported instruments.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/symbols":{"get":{"tags":["Market Data"],"summary":"Symbols Config","operationId":"getSymbols","description":"Return tradable symbol configuration and market metadata for supported instruments.","parameters":[{"$ref":"#/components/parameters/SymbolIdQuery"}],"responses":{"200":{"description":"Symbol configurations","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/Symbol"}}}}}}]}}}}}}}},"components":{"parameters":{"SymbolIdQuery":{"name":"symbol_id","in":"query","required":false,"schema":{"type":"integer"},"description":"Symbol ID. Omit to match all symbols."}},"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"Symbol":{"type":"object","properties":{"symbol_id":{"type":"integer"},"status":{"type":"string","enum":["pre_launch","trading","suspended","delisted"]},"base_coin_id":{"type":"integer"},"quote_coin_id":{"type":"integer"},"settle_coin_id":{"type":"integer","description":"Settlement coin (perp only)."},"price_precision":{"type":"integer"},"qty_precision":{"type":"integer"},"price_step":{"type":"string"},"qty_step":{"type":"string"},"min_size":{"type":"string"},"max_size":{"type":"string"},"max_leverage":{"type":"integer","nullable":true},"default_leverage":{"type":"integer","nullable":true},"taker_fee_rate":{"type":"string"},"maker_fee_rate":{"type":"string"},"price_limit_pct":{"type":"string","nullable":true},"funding_interval":{"type":"integer","nullable":true},"funding_rate_cap":{"type":"string","nullable":true},"funding_rate_floor":{"type":"string","nullable":true},"clamp_deviation":{"type":"string","nullable":true},"impact_margin_notional":{"type":"string","nullable":true},"price_step_merge_multiplier":{"type":"array","items":{"type":"string"},"description":"Allowed merge multipliers for L2 order book. `\"1\"` = no merge."},"trading_mode":{"type":"string","nullable":true,"enum":["normal","limit_only","post_only","reduce_only","cancel_only",null]}}}}}}
```

## Coins Config

> Return coin configuration for supported deposit and withdrawal assets.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/coins":{"get":{"tags":["Market Data"],"summary":"Coins Config","operationId":"getCoins","description":"Return coin configuration for supported deposit and withdrawal assets.","responses":{"200":{"description":"All deposit/withdraw-capable coin configurations","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/Coin"}}}}}}]}}}}}}}},"components":{"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"Coin":{"type":"object","properties":{"coin_id":{"type":"integer"},"status":{"type":"string","enum":["active","delisted"]},"precision":{"type":"integer"},"default_leverage":{"type":"integer"},"enable_collateral":{"type":"boolean"}}}}}}
```

## 24h Tickers

> Return 24-hour ticker data for one symbol or all supported symbols.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/tickers":{"get":{"tags":["Market Data"],"summary":"24h Tickers","operationId":"getTickers","description":"Return 24-hour ticker data for one symbol or all supported symbols.","parameters":[{"$ref":"#/components/parameters/SymbolIdQuery"}],"responses":{"200":{"description":"Tickers","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/Ticker"}}}}}}]}}}}}}}},"components":{"parameters":{"SymbolIdQuery":{"name":"symbol_id","in":"query","required":false,"schema":{"type":"integer"},"description":"Symbol ID. Omit to match all symbols."}},"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"Ticker":{"type":"object","properties":{"symbol_id":{"type":"integer"},"last_price":{"type":"string"},"mark_price":{"type":"string","nullable":true,"description":"Mark price (perp only)."},"oracle_price":{"type":"string","nullable":true,"description":"Oracle/index price (perp only)."},"best_bid_price":{"type":"string"},"best_bid_quantity":{"type":"string"},"best_ask_price":{"type":"string"},"best_ask_quantity":{"type":"string"},"high_24h":{"type":"string"},"low_24h":{"type":"string"},"volume_24h":{"type":"string","description":"24h volume in base currency."},"turnover_24h":{"type":"string","description":"24h turnover in quote currency."},"price_change_24h":{"type":"string"},"open_interest":{"type":"string","nullable":true,"description":"Open interest (perp only)."},"funding_rate":{"type":"string","nullable":true},"next_funding_time":{"type":"integer","format":"int64","nullable":true},"time":{"type":"integer","format":"int64"}}}}}}
```

## Order Book Snapshot

> Return an L2 order book snapshot for a symbol with configurable depth and price merging.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/l2_book":{"get":{"tags":["Market Data"],"summary":"Order Book Snapshot","operationId":"getOrderBook","description":"Return an L2 order book snapshot for a symbol with configurable depth and price merging.","parameters":[{"name":"symbol_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"depth","in":"query","required":false,"schema":{"type":"integer","enum":[5,10,20,50,100,200],"default":20}},{"name":"merge","in":"query","required":false,"schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Order book snapshot","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/L2Book"}}}]}}}},"400":{"description":"Errors: `222001` (invalid depth), `222002` (invalid merge)"}}}}},"components":{"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"L2Book":{"type":"object","properties":{"symbol_id":{"type":"integer"},"asks":{"type":"array","description":"Ask side `[price, qty]`, sorted ascending by price.","items":{"type":"array","items":{"type":"string"}}},"bids":{"type":"array","description":"Bid side `[price, qty]`, sorted descending by price.","items":{"type":"array","items":{"type":"string"}}},"merge":{"type":"integer","description":"Current merge multiplier applied to the snapshot."},"seq":{"type":"integer","format":"int64","description":"Snapshot version (corresponds to the WS `l2_book` incremental version)."},"time":{"type":"integer","format":"int64"}}}}}}
```

## Recent Trades

> Return recent public trades for a symbol in reverse chronological order.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/trades":{"get":{"tags":["Market Data"],"summary":"Recent Trades","operationId":"getRecentTrades","description":"Return recent public trades for a symbol in reverse chronological order.","parameters":[{"name":"symbol_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":250}}],"responses":{"200":{"description":"Recent trades","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/TradeTick"}}}}}}]}}}}}}}},"components":{"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"TradeTick":{"type":"object","properties":{"trade_id":{"type":"string"},"price":{"type":"string"},"quantity":{"type":"string"},"amount":{"type":"string"},"time":{"type":"integer","format":"int64"},"tx_hash":{"type":"string"},"is_taker_buyer":{"type":"boolean"}}}}}}
```

## Klines (Candlestick Data)

> Return candlestick data for a symbol, interval, and optional time range.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/klines":{"get":{"tags":["Market Data"],"summary":"Klines (Candlestick Data)","operationId":"getKlines","description":"Return candlestick data for a symbol, interval, and optional time range.","parameters":[{"name":"symbol_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"interval","in":"query","required":true,"schema":{"type":"string","enum":["1m","5m","15m","30m","1h","2h","4h","6h","8h","12h","1d","1w","1M"]}},{"$ref":"#/components/parameters/StartTimeQuery"},{"$ref":"#/components/parameters/EndTimeQuery"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":1000,"maximum":5000}}],"responses":{"200":{"description":"Klines sorted ascending by `start`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/Kline"}}}}}}]}}}}}}}},"components":{"parameters":{"StartTimeQuery":{"name":"start_time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"Start time (Unix ms)."},"EndTimeQuery":{"name":"end_time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"End time (Unix ms)."}},"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"Kline":{"type":"object","properties":{"start":{"type":"integer","format":"int64","description":"Open time (ms)."},"interval":{"type":"string"},"open":{"type":"string"},"close":{"type":"string"},"high":{"type":"string"},"low":{"type":"string"},"volume":{"type":"string"},"turnover":{"type":"string"}}}}}}
```

## Funding Rate History

> Return historical funding-rate records for a perpetual symbol.

```json
{"openapi":"3.0.3","info":{"title":"UniX API","version":"1.11.0"},"tags":[{"name":"Market Data"}],"servers":[{"url":"https://api.unixtrade.pro/v1","description":"Production"}],"paths":{"/market/funding-rate/history":{"get":{"tags":["Market Data"],"summary":"Funding Rate History","operationId":"getFundingRateHistory","description":"Return historical funding-rate records for a perpetual symbol.","parameters":[{"name":"symbol_id","in":"query","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/StartTimeQuery"},{"$ref":"#/components/parameters/EndTimeQuery"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"Funding rate history","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/components/schemas/FundingRateHistory"}}}}}}]}}}}}}}},"components":{"parameters":{"StartTimeQuery":{"name":"start_time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"Start time (Unix ms)."},"EndTimeQuery":{"name":"end_time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"End time (Unix ms)."}},"schemas":{"ResponseEnvelope":{"type":"object","description":"Standard response envelope shared by every endpoint.","required":["code","msg","data"],"properties":{"code":{"type":"string","description":"`\"0\"` for success. Non-zero indicates an error code — see [Error Codes](/reference/error-codes)."},"msg":{"type":"string","description":"Empty on success; human-readable error description on failure."},"data":{"description":"Endpoint-specific payload on success; `null` on failure.","nullable":true},"trace_code":{"type":"string","description":"Backend trace identifier. Empty on success; populated on failure for support diagnostics."}}},"FundingRateHistory":{"type":"object","properties":{"symbol_id":{"type":"integer"},"funding_rate":{"type":"string"},"mark_price":{"type":"string"},"time":{"type":"integer","format":"int64"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.unix.market/rest-api/market-data.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.