GateData.AI

Historical candlesticks (OHLCV)

Query the OHLCV candle series for a trading object over the selected interval and time range.

GET/api/v1/markets/kline
Domain
Market & Liquidity
Level
Listing
MCP tool
market_data_query (task=kline)

Available data

Returns
The OHLCV candle series for a trading object over the selected interval and time range
Market coverage
Crypto and US and Hong Kong equities
Query granularity
One listing and one interval per query; data from different listings is not merged

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Interval

Required.

timeframeTimeframequeryExample1hrequired

Aggregation period for each record

intervalTimeframequeryExample1hoptional

Compatibility alias of timeframe.

Object positioning

Provide at least one of listing_id, asset_id, or query (aliases ticker / symbol / base also work).

listing_idstringqueryExamplelisting_gate_BTC_USDT_spotoptional

Canonical listing identifier

asset_idstringqueryExampleasset_btcoptional

Canonical asset identifier

querystringqueryExampleBTCoptional

Search text used to resolve the query object

tickerstringqueryExampleBTCoptional

Ticker alias of query.

symbolstringqueryExampleBTCoptional

Symbol alias of query.

basestringqueryExampleBTCoptional

Base asset code of the trading pair

Market routing

Equities require market; venue / market_type are mainly for crypto (bare crypto may default to Gate spot).

marketMarketqueryExamplecryptoconditional

Market of the query object

venuestringqueryExamplegateoptional

Trading venue code to query

market_typeMarketTypequeryExamplespotoptional

Type of traded product

quotestringqueryExampleUSDToptional

Quote asset code of the trading pair

Time range

Prefer for equity flows; supports start_time / end_time (aliases from / to).

start_timedatetimequeryExample2026-07-01T00:00:00Zoptional

Start of the query time range

end_timedatetimequeryExample2026-07-31T23:59:59Zoptional

End of the query time range

fromdatetimequeryExample2026-07-01T00:00:00Zoptional

Start date of a custom query range

todatetimequeryExample2026-07-31T23:59:59Zoptional

End date of a custom query range

Response control

All optional.

limitintegerqueryExample100optional

Maximum records returned per request

Equity advanced

include_indicators=true adds indicator columns when available.

adjustmentenumqueryExamplerawoptional

Equity price-adjustment mode.

include_indicatorsbooleanqueryExamplefalseoptional

When true, adds indicator columns when available (default false).

Response

base_currencystringExampleBTC

Base asset or currency code

quote_currencystringExampleUSDT

Quote currency used for prices and amounts

timeframestringExample1h

Aggregation period for each record

volume_unitstringExamplebase

Traded quantity unit

volume_typestringExamplebase_amount

Traded quantity measurement basis

bars[]array[object (KlineBar)]

Candlestick data array

open_timedatetimeExample2026-08-17T17:00:00Z

Start time of the candlestick period

close_timedatetimeExample2026-08-17T18:00:00Z

End time of the candlestick period

opennumberExample64114.5

First traded price in the candlestick period

highnumberExample64119

Highest traded price in the candlestick period

lownumberExample64077

Lowest traded price in the candlestick period

closenumberExample64079.8

Last traded price in the candlestick period

volumenumberExample16.336379

Cumulative traded quantity during the period

volume_unitstringExamplebase

Traded quantity unit

base_currencystringExampleBTC

Base asset or currency code

timeframeTimeframeExample1h

Aggregation period for this record

data_statusDataStatusExampleready

Availability of the business data

data_statusDataStatusExampleready

Availability of the business data

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Availability of the business data

actual_taskstring

Task that was actually executed

route_reasonstring

Reason the task or object was selected

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:12Z

Most recent object or response update time

partialboolean

Whether the response contains only a subset of fields

resolution_reasonstring

Reason code for the object-resolution outcome

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstring

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

listing_idstring

Canonical listing identifier

instrument_idstring

Canonical financial instrument identifier

venue_idstring

Canonical trading venue identifier

event_refstring

Related event identifier

market_idstring

Canonical market object identifier

venuestring

Related platform code

resolved_fromstringExampleasset_entity

Input used to resolve the object

resolution_confidencestringExampleresolved

Object resolution confidence

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.