Trend candles

Query trend candles with optional technical indicators.

GET/api/v1/markets/trend-kline
Domain
Market & Liquidity
Level
Asset
MCP tool
market_data_query (task=trend_kline)

Available data

Returns
Query trend candles with optional technical indicators
What each request returns
Indicator columns are optional; limit is an alias of size.

Authentication

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

Query Parameters

symbolstringqueryExampleBTCrequired

Symbol with market prefix, e.g. US.AAPL; alternative to entity_id

timeframestringqueryExample1hrequired

Candle or indicator interval · 1m / 5m / 15m / 1h / 4h / 1d

periodstringqueryoptional

Query window · 1h / 4h / 24h / 7d / 3d / 5d / 10d · Default: 24h

sizeintegerqueryExample2optional

Row limit · Default: 100 · ≥ 1, ≤ 400

limitintegerqueryoptional

Maximum rows · ≥ 1, ≤ 400

with_indicatorsbooleanqueryExampletrueoptional

Include technical indicator columns · Default: false

start_timestringqueryoptional

Inclusive UTC start; RFC3339, date or Unix seconds. Alias: from

end_timestringqueryoptional

Exclusive UTC end; a date-only value includes that UTC day. Alias: to

Response

countnumber

Returned row count

data_statusDataStatus

Data status

periodstring

Query window

sizenumber

Row limit

totalnumber

Total matching records

items[]object[]

Result rows

close_pricenumber

Close price

deal_cntnumber

Trade count

high_pricenumber

High price

low_pricenumber

Low price

ma7number

Seven-period moving average

macdnumber

MACD value

open_pricenumber

Open price

rsinumber

Relative strength index

timedatetime

Time point

timestampdatetime

Timestamp

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.