Finance

Market data.
One bounded response.

Retrieve a latest available market snapshot and configurable price history for equities, indices, cryptocurrency pairs, and currency pairs. Keep the native listing currency or request a three-letter quote currency such as EUR in the same call. Data may be delayed.

Request

curl --get 'https://extractor.sh/api/finance' \
  --data-urlencode 'symbol=AAPL' \
  --data-urlencode 'timeframe=3mo' \
  --data-urlencode 'quote=EUR' \
  --data-urlencode 'format=json'

Parameter	Required	Description
`symbol`	Yes	1–32 characters. Examples: `AAPL`, `^GSPC`, `BTC-USD`, `EURUSD=X`.
`timeframe`	No	`1d`, `5d`, `1mo`, `3mo`, `6mo`, `1y`, `5y`, or `max`. Default: `1mo`.
`quote`	No	Three-letter output currency such as `EUR`. Omit it to retain the native listing currency.
`format`	No	`json` (default) or `markdown`.

Response

JSON uses schema version 1 with a provider-neutral finance document. Available attributes include the symbol, exchange, effective currency, instrument type, latest price, change, ranges, volume, market state, timezone, selected timeframe and interval, up to 512 OHLCV history points, and bounded dividend or split events. Converted responses additionally expose listingCurrency, quoteCurrency, exchangeRate, and exchangeRateTimestamp.

{
  "schemaVersion": 1,
  "type": "document",
  "source": "finance",
  "id": "AAPL",
  "attributes": {
    "tickerSymbol": "AAPL",
    "currency": "EUR",
    "listingCurrency": "USD",
    "quoteCurrency": "EUR",
    "exchangeRate": 0.91,
    "marketPrice": 200.07,
    "historyTimeframe": "3mo",
    "historyInterval": "1d",
    "history": [{ "timestamp": "2026-08-04T13:30:00.000Z", "close": 219.86 }]
  }
}

Behavior

The history interval is selected automatically for the requested timeframe.
Without quote, every monetary value remains in the instrument’s native listing currency.
With quote, the snapshot and chart-ready history are converted in the same public operation. Historical points use corresponding historical exchange rates when available.
A converted AAPL&quote=EUR response is a synthetic EUR view of the Nasdaq listing. To request an actual EUR-traded venue, use that listing’s symbol instead.
History is capped at 512 points and market events at 128 entries.
Successful responses may be cached for up to five minutes. One successful uncached request costs one allowance slot or credit.
Use market data for research, not order execution or investment advice.

Search stocks

When the company name is known but its symbol is not, call GET /api/finance/search. It returns an ordered schema-v1 finance feed of equity listings without fetching every quote.

curl --get 'https://extractor.sh/api/finance/search' \
  --data-urlencode 'q=Apple' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'format=json'

q accepts a company name, brand, or partial ticker up to 200 characters. limit is 1–10 and defaults to 10. Successful stock searches may be cached for one hour; an empty valid search is HTTP 200.

Ordinary public Yahoo Finance quote and price-history URLs remain supported by /api/extract and keep their one-month daily-history default.

Market data.One bounded response.

Request

Response

Behavior

Search stocks

Market data.
One bounded response.