Trend candles
Query trend candles with optional technical indicators.
GET/api/v1/markets/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
symbolstringqueryExampleBTCrequiredSymbol with market prefix, e.g. US.AAPL; alternative to entity_id
timeframestringqueryExample1hrequiredCandle or indicator interval · 1m / 5m / 15m / 1h / 4h / 1d
periodstringqueryoptionalQuery window · 1h / 4h / 24h / 7d / 3d / 5d / 10d · Default: 24h
sizeintegerqueryExample2optionalRow limit · Default: 100 · ≥ 1, ≤ 400
limitintegerqueryoptionalMaximum rows · ≥ 1, ≤ 400
with_indicatorsbooleanqueryExampletrueoptionalInclude technical indicator columns · Default: false
start_timestringqueryoptionalInclusive UTC start; RFC3339, date or Unix seconds. Alias: from
end_timestringqueryoptionalExclusive UTC end; a date-only value includes that UTC day. Alias: to
Response
countnumberReturned row count
data_statusDataStatusData status
periodstringQuery window
sizenumberRow limit
totalnumberTotal matching records
items[]object[]
Result rows
close_pricenumberClose price
deal_cntnumberTrade count
high_pricenumberHigh price
low_pricenumberLow price
ma7numberSeven-period moving average
macdnumberMACD value
open_pricenumberOpen price
rsinumberRelative strength index
timedatetimeTime point
timestampdatetimeTimestamp
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.