info_marketdetail_get_kline
Read-only Gate candlesticks for a trading pair or contract. Inputs: symbol (required), timeframe (validated per market_type; delivery excludes 1s|3d), market_type spot|futures|delivery|options (default spot), limit 1–400 (default 100; over-limit rejected) for latest N only, optional paired start_time/end_time Unix seconds (mutually exclusive with limit; range returns up to 400 latest candles and may set truncated/actual_start_time/actual_end_time), settle for futures/delivery. Each candle includes t, open, high, low, close; volume and quote_volume only when upstream provides them. Invalid timeframe or unknown symbol returns an error. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>",
"timeframe": "<timeframe>"
},
"name": "info_marketdetail_get_kline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max candles when no time range; omit for default 100; minimum 1, maximum 400. Over-limit rejected. Cannot combine with start_time/end_time. | |
| settle | No | futures/delivery settlement; default usdt. | |
| symbol | Yes | Pair or contract e.g. BTC_USDT. | |
| end_time | No | End Unix seconds; must be paired with start_time. Range queries return up to 400 latest candles and may set truncated. | |
| timeframe | Yes | Candle interval. start_time/end_time are Unix seconds. | |
| start_time | No | Start Unix seconds; must be paired with end_time. Omit both with limit for latest N candles. Mutually exclusive with explicit limit. | |
| market_type | No | Market venue; default spot when omitted. Allowed: spot|futures|delivery|options. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| items | Yes | Candles with t, open, high, low, close required; volume/quote_volume when upstream provides them; times UTC. | |
| total | Yes | ||
| settle | No | ||
| symbol | Yes | Echo input. Candle times are UTC (+00:00); convert for local display. | |
| cex_tool | No | Upstream route label (omitted on open surface). | |
| end_time | No | Echoed range end when start_time/end_time were provided. | |
| timeframe | Yes | ||
| truncated | No | True when a range query returned only the latest MaxKlineLimit candles. | |
| start_time | No | Echoed range start when start_time/end_time were provided. | |
| duration_ms | No | Server timing (omitted on open surface). | |
| market_type | Yes | ||
| actual_end_time | No | Latest candle t in items (Unix seconds) after truncation. | |
| actual_start_time | No | Earliest candle t in items (Unix seconds) after truncation. |