finance

Daily, weekly or monthly OHLCV bars for a stock, ETF or index. Returns a normalized Candle page.

Historical bars by interval (1d, 1wk, 1mo) with an optional start / end window. Symbol forms as in finance.quote. A-shares (600519.SH, daily / weekly / monthly) and Hong Kong daily bars (0700.HK) come from Tushare, most recent first, with or without a window; every other market needs start (end optional) and comes from yfinance in chronological order, limit keeping the earliest bars of the window.

Fixed price: 0.1 credits per successful call, whichever provider serves it.

post/v2/ops/finance.price.history

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/finance.price.history
  • Auth
    HTTP bearer

Request body

endstring date

Latest bar date, YYYY-MM-DD (inclusive); default today.

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

interval'1d' | '1wk' | '1mo'

Bar size.

limitinteger

Maximum number of bars to return.

providerstring

Shorthand for routing.only = [provider].

startstring date

Earliest bar date, YYYY-MM-DD. Required for every market except A-shares and Hong Kong daily bars.

symbolstring required

Ticker: AAPL, 0700.HK, 600519.SH, 000001.SZ.

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.