# Market Data
Public market data — tickers, order books, trades, klines, funding rate history, symbols and coin configuration. No authentication required.
## 24h Tickers
> 24-hour rolling ticker summary. Omit \`symbol\_id\` to return all symbols.
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/tickers":{"get":{"tags":["Market Data"],"summary":"24h Tickers","operationId":"getTickers","description":"24-hour rolling ticker summary. Omit `symbol_id` to return all 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
> L2 order book snapshot.\
> \
> \- \`depth\`: \`5\` / \`10\` / \`20\` / \`50\` / \`100\` / \`200\`, default \`20\`\
> \- \`merge\`: price-step multiplier (integer multiple of \`tick\_size\`). Default \`1\` (no merge). Allowed values are listed in the symbol's \`price\_step\_merge\_multiplier\`.\
> \
> \### Merge rule\
> \
> Effective granularity = \`tick\_size × merge\`. Bids round down, asks round up to the nearest\
> merged price; quantities at the same merged price are summed.
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/l2_book":{"get":{"tags":["Market Data"],"summary":"Order Book Snapshot","operationId":"getOrderBook","description":"L2 order book snapshot.\n\n- `depth`: `5` / `10` / `20` / `50` / `100` / `200`, default `20`\n- `merge`: price-step multiplier (integer multiple of `tick_size`). Default `1` (no merge). Allowed values are listed in the symbol's `price_step_merge_multiplier`.\n\n### Merge rule\n\nEffective granularity = `tick_size × merge`. Bids round down, asks round up to the nearest\nmerged price; quantities at the same merged price are summed.\n","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"}}}}}}
```
## GET /market/trades
> Recent Trades
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/trades":{"get":{"tags":["Market Data"],"summary":"Recent Trades","operationId":"getRecentTrades","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"},"is_buyer_maker":{"type":"boolean"},"time":{"type":"integer","format":"int64"},"tx_hash":{"type":"string"}}}}}}
```
## GET /market/klines
> Klines (Candlestick Data)
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/klines":{"get":{"tags":["Market Data"],"summary":"Klines (Candlestick Data)","operationId":"getKlines","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"}}}}}}
```
## GET /market/funding-rate/history
> Funding Rate History
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/funding-rate/history":{"get":{"tags":["Market Data"],"summary":"Funding Rate History","operationId":"getFundingRateHistory","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"}}}}}}
```
## Symbols Config
> Trading-pair configuration (price/qty precision, leverage, fees, funding parameters).
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/symbols":{"get":{"tags":["Market Data"],"summary":"Symbols Config","operationId":"getSymbols","description":"Trading-pair configuration (price/qty precision, leverage, fees, funding parameters).","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."}}}}}}
```
## Coins Config
> Coin configuration (precision, default leverage, chain configs). \*\*Only returns\
> deposit/withdraw-capable coins\*\* (e.g. USDT).\
> \
> Note: leverage brackets are VIP-tier-dependent — see \`/account/leverage-bracket\`\
> for per-user data.
```json
{"openapi":"3.0.3","info":{"title":"Lynx DEX API","version":"1.5.0"},"tags":[{"name":"Market Data","description":"Public market data — tickers, order books, trades, klines, funding rate history,\nsymbols and coin configuration. No authentication required.\n"}],"servers":[{"url":"http://10.34.8.77:8481/v1","description":"Production"}],"paths":{"/market/coins":{"get":{"tags":["Market Data"],"summary":"Coins Config","operationId":"getCoins","description":"Coin configuration (precision, default leverage, chain configs). **Only returns\ndeposit/withdraw-capable coins** (e.g. USDT).\n\nNote: leverage brackets are VIP-tier-dependent — see `/account/leverage-bracket`\nfor per-user data.\n","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","description":"Only deposit/withdraw-capable coins are returned.","properties":{"coin_id":{"type":"integer"},"precision":{"type":"integer"},"default_leverage":{"type":"integer"},"enable_collateral":{"type":"boolean"},"chains":{"type":"array","items":{"$ref":"#/components/schemas/CoinChain"}}}},"CoinChain":{"type":"object","properties":{"chain_id":{"type":"integer"},"min_deposit":{"type":"string"},"min_withdraw":{"type":"string"},"deposit_fee":{"type":"string"},"withdraw_fee":{"type":"string"},"enable_deposit":{"type":"boolean"},"enable_withdraw":{"type":"boolean"}}}}}}
```
---
# 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://docs.lynxtrade.world/rest-api/market-data.md?ask=
```
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.