AGagentkey
finance

Annual or quarterly income statement, balance sheet or cash flow with normalized line items. Returns a FinancialStatement page, most recent period first.

One statement per call (statement=income|balance|cashflow), annual or quarterly. Line items are normalized to a fixed vocabulary (revenue, net_income, total_assets, operating_cash_flow …); a line the vendor does not report is null. A-shares come from Tushare (CNY), US filers from Finnhub (SEC XBRL facts; quarterly rows are 10-Q year-to-date figures) and AlphaVantage (single quarters).

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

post/v2/ops/finance.financials

Request

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

Request body

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).

limitinteger

Maximum number of periods to return.

period'annual' | 'quarterly'

Reporting frequency (quarterly = single-quarter figures where the vendor distinguishes them, year-to-date where it does not).

providerstring

Shorthand for routing.only = [provider].

statement'income' | 'balance' | 'cashflow'

Which statement to return.

symbolstring required

Ticker: AAPL, 600519.SH.

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.