Financial instruments
Live market data for a stock, ETF, index, mutual fund, or currency pair — quote, price movement, fundamentals, news, and price history in one call.
Financial instruments
One call answers "how is this company's stock doing?" Send a stock, ETF, index, mutual fund, or currency pair and we return live market data: the latest quote and price movement, company facts, financial statements, related news, and a price history series for the window you choose.
It's built for agents and dashboards that need real-world market state next to company data.
Inputs
Pick the instrument type and identify it:
type | Fields | Example |
|---|---|---|
stockOrEtf | ticker, exchange | GOOGL on NASDAQ |
index | index | SP_500, DOW_JONES, NASDAQ_100, NASDAQ_COMPOSITE, RUSSELL_1000, RUSSELL_2000, RUSSELL_3000, FTSE_100 |
mutualFund | ticker | A fund ticker |
currencyPair | base, quote | USD / EUR |
customSymbol | symbol | Any symbol the others don't cover |
Set window for the price history: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y,
or MAX.
{
"apiKey": "sk_live_...",
"instrument": { "type": "stockOrEtf", "ticker": "GOOGL", "exchange": "NASDAQ" },
"window": "1Y"
}What comes back
- Identity: name, ticker, exchange, and currency.
- Quote: the latest price, when it was quoted, and the change since the prior session (amount, percentage, and direction).
- Session stats: open, high, low, market cap, and related figures.
- Fundamentals: company facts and financial statements, for stocks.
- News: recent articles about the instrument.
- Price history: a series covering your
window.
Operations
| Operation | What it does | Reference |
|---|---|---|
| Financial instrument lookup | Live quote, fundamentals, news, and price history for one instrument | financialInstrumentLookup |
The endpoint allows 120 requests per minute.
Using it effectively
- Pass the exchange for stocks and ETFs; the same ticker can trade in more than one place.
- Choose the shortest window you need.
1Dor5Dfor "how is it doing today",1Yor longer for trends. - Pair it with company data. Resolve the company with Kitchen Sink and add the market view here for a full account picture.
Credits
2 credits per lookup. A ticker or symbol we can't find (404) is still billed, because the lookup ran; a request that fails on our side is refunded. See Billing & credits.
Credit amounts are defaults — custom pricing is available for bulk use cases.
Related: Market intelligence