Skip to content

List cached native source Klines​

GET
/v2/source-klines

Returns locally cached closed source Klines plus the current active 1m Kline when available. Active 1h and 1d Klines are rolled up from a contiguous cached 1m prefix and the active minute; their is_closed field is false. Active rows stay out of closed history. This read-only endpoint never fetches missing exchange history. Kline prices use nativeQuote. missingRanges lists uncovered [from_ms, to_ms) ranges except for a returned active interval; syntheticOpenTimes identifies locally carried zero-volume bars. A covered range can have no Klines when the exchange returned no data.

Authorizations​

bearerAuth

Required when cp_auth.enabled=true. The token must have the oracle scope.

Type
HTTP (bearer)

Parameters​

Query Parameters

symbol*

Base asset symbol, e.g. BTC.

Type
string
Required
Example"BTC"
source*

Exchange ID from /v2/source-tickers, e.g. sbi_vc_trade.

Type
string
Required
Example"sbi_vc_trade"
pair*

Native market pair from /v2/source-tickers.

Type
string
Required
Example"EX_BTC_JPY"
nativeQuote*

Native quote from /v2/source-tickers; prices are not converted.

Type
string
Required
Example"JPY"
quote

Accepted for parity with /v2/klines and validated (USD or JPY), but it does not convert prices: rows stay in the native market quote.

Type
string
Valid values
"JPY""USD"
interval*

Stored native source interval.

Type
string
Required
Valid values
"1m""1h""1d"
startTime

Inclusive Unix timestamp in milliseconds.

Type
integer
Format
"int64"
endTime

Inclusive Unix timestamp in milliseconds.

Type
integer
Format
"int64"
limit

Defaults to 500; maximum 1000.

Type
integer
Minimum
1
Maximum
1000
Default
500

Responses​

Cached closed and available active source Klines, uncovered ranges, and carried-bar open times.

application/json
JSON
{
  
"klines": [
  
  
[
  
  
]
  
],
  
"missingRanges": [
  
  
[
  
  
]
  
],
  
"syntheticOpenTimes": [
  
  
0
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​