kline · K-line & Intraday

sdk.kline provides historical K-lines, minute K-lines, and indicator-enriched K-lines for CN / HK / US markets. The first argument is always a symbol string (parsed leniently by normalizeSymbol); the second is an optional options object for period / adjustment / date range.

import { StockSDK } from 'stock-sdk'

const sdk = new StockSDK()

// CN daily K-line (forward-adjusted by default)
const daily = await sdk.kline.cn('600519')

// US 15-minute K-line
const us15 = await sdk.kline.us('AAPL', { period: '15' })

Methods

Method	Description
`kline.cn(symbol, opts?)`	CN historical K-line (daily / weekly / monthly)
`kline.cnMinute(symbol, opts?)`	CN minute K-line / intraday (1 / 5 / 15 / 30 / 60 min)
`kline.hk(symbol, opts?)`	HK historical K-line
`kline.hkMinute(symbol, opts?)`	HK minute K-line / intraday
`kline.us(symbol, opts?)`	US historical K-line
`kline.usMinute(symbol, opts?)`	US minute K-line / intraday
`kline.withIndicators(symbol, opts?)`	Historical K-line + built-in indicators (MA / MACD / KDJ, etc.)
`kline.signals(symbol, opts?)`	Indicator signals over historical K-lines (golden/death crosses, overbought/oversold, breakouts, reversals — 14 types)

Eastmoney is the primary source. Regular CN historical and 5/15/30/60-minute K-lines fall back to Tencent and then Sina when push2his disconnects, times out, or returns data:null; the 1-minute timeline keeps its existing endpoint. HK / US K-lines cover regular trading hours only (no pre-/post-market).
Fallback sources provide OHLCV. change, changePercent, and amplitude are derived from adjacent closes; unavailable amount and turnoverRate fields are null. Tencent historical fallback supports adjustment, while the final Sina fallback and both minute fallbacks are unadjusted. Sina can return up to 10,000 daily or 5,000 minute bars in Node.js; its browser JSONP route is limited to the latest 1,023 bars. If that depth cannot cover the requested window, the SDK preserves the original Eastmoney error instead of returning incomplete data. Special CSI indices also preserve the original error when no fallback mapping exists.
kline.signals chains withIndicators + calcSignals (stock-sdk/signals) and returns each signal's type / date / close / detail. maFast / maSlow (default 5 / 20) tune the MA cross periods, the rest use common default thresholds; omit startDate to scan full history, pass it to narrow the window.

Parameters

Historical K-line options (cn / hk / us):

interface HistoryKlineOptions {
  /** K-line period @default 'daily' */
  period?: 'daily' | 'weekly' | 'monthly'
  /** Adjustment type @default 'qfq' */
  adjust?: '' | 'qfq' | 'hfq'
  /** Start date YYYYMMDD */
  startDate?: string
  /** End date YYYYMMDD */
  endDate?: string
}

Minute K-line options (cnMinute / hkMinute / usMinute):

interface MinuteKlineOptions {
  /** Period (minutes) @default '1' */
  period?: '1' | '5' | '15' | '30' | '60'
  /** Adjustment (only 5/15/30/60; 1-min intraday is never adjusted) @default 'qfq' */
  adjust?: '' | 'qfq' | 'hfq'
  startDate?: string
  endDate?: string
}

Exact fields follow the final implementation.

Period

Scope	Values	Meaning
Historical	`'daily'` / `'weekly'` / `'monthly'`	Daily (default) / weekly / monthly
Minute	`'1'` / `'5'` / `'15'` / `'30'` / `'60'`	1 (default) / 5 / 15 / 30 / 60 minutes

With period: '1', the minute methods return an intraday structure (with avgPrice); with '5' | '15' | '30' | '60' they return a standard minute K-line structure (with amplitude / changePercent / turnoverRate).

Adjustment

Value	Meaning	When to use
`'qfq'`	Forward-adjusted (default)	Past prices rebased to the latest price; best for charting and trend viewing
`'hfq'`	Backward-adjusted	Past prices fixed, dividends/splits rolled forward; best for backtesting / long-term return / compounding
`''`	Unadjusted	Raw exchange prices

For backtesting or return calculations, explicitly pass 'hfq' or '' rather than relying on the forward-adjusted default — see Adjustment. The 1-minute intraday series is never adjusted.

Examples

// CN weekly, backward-adjusted, bounded date range
const cnWeekly = await sdk.kline.cn('600519', {
  period: 'weekly',
  adjust: 'hfq',
  startDate: '20240101',
  endDate: '20241231',
})

// CN 5-minute K-line
const cn5m = await sdk.kline.cnMinute('600519', { period: '5' })

// CN intraday (period defaults to '1')
const cnTimeline = await sdk.kline.cnMinute('600519')

// HK daily (symbol may be '00700' / 'hk00700' / '00700.HK')
const hk = await sdk.kline.hk('00700')

// US daily, unadjusted
const us = await sdk.kline.us('AAPL', { adjust: '' })

// K-line with indicators
const withInd = await sdk.kline.withIndicators('600519', { period: 'daily' })

Return shape

Historical K-line methods return an array, one item per bar, sorted ascending by time. Core fields:

Field	Type	Description
`date`	`string`	Date `YYYY-MM-DD` (market local tz)
`timestamp`	`number \| null`	UTC ms of 00:00 that day; `null` if unparseable
`tz`	`string`	Market timezone, e.g. `Asia/Shanghai`
`code`	`string`	Instrument code
`open` / `close` / `high` / `low`	`number \| null`	OHLC
`volume` / `amount`	`number \| null`	Volume / turnover
`amplitude` / `changePercent` / `change` / `turnoverRate`	`number \| null`	Amplitude% / change% / change / turnover rate%

HK / US historical K-lines additionally carry currency ('HKD' / 'USD') and name; HK also carries lotSize (not returned by the K-line endpoint, fixed null — use sdk.quotes.hk for lot size).

Minute K-lines ('5'~'60') mirror historical fields but use a time field (YYYY-MM-DD HH:mm); the intraday series ('1') carries time + OHLC + volume/amount + avgPrice.

Percentage fields are expressed as percentages (e.g. 5.2 means 5.2%). Amount / price / volume have unified target units, but in the current beta runtime values still follow each provider's raw convention. timestamp is null when invalid (no more NaN). Exact fields follow the implementation.

K-line with indicators

kline.withIndicators attaches built-in technical indicators (MA / MACD / BOLL / KDJ / RSI, etc.) on top of the historical K-line, returning a KlineWithIndicators structure and saving you the wiring.

const klines = await sdk.kline.withIndicators('600519', {
  period: 'daily',
  adjust: 'hfq',
})

If you already have a K-line array, you can compute indicators with the pure functions from the subpath export — no network involved:

import { calcMACD, addIndicators } from 'stock-sdk/indicators'
import { calcSignals } from 'stock-sdk/signals'

const macd = calcMACD(klines)
const enriched = addIndicators(klines, { ma: [5, 20], macd: true })
const signals = calcSignals(enriched, { ma: { fast: 5, slow: 20 }, macd: true })

See indicators and signals.

kline · K-line & Intraday ​

Methods ​

Parameters ​

Period ​

Adjustment ​

Examples ​

Return shape ​

K-line with indicators ​

See also ​