AGagentkey
finance

Latest news for a ticker (optionally within a date window) or a market category (general, forex, crypto, merger). Returns a normalized NewsArticle page.

symbol lists a company's news — the last seven days by default, or the start … end window when both are given; category alone lists the latest market news. Articles are normalized to NewsArticle with the tagged tickers; lang is not supplied by the current provider.

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

post/v2/ops/finance.news

Request

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

Request body

category'general' | 'forex' | 'crypto' | 'merger'

Market news category when no symbol is given.

endstring date

Latest publish date, YYYY-MM-DD.

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 articles to return.

providerstring

Shorthand for routing.only = [provider].

startstring date

Earliest publish date, YYYY-MM-DD (give start and end together; default the last seven days).

symbolstring

Ticker to filter by (AAPL). Omit for market-wide news.

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.