Yahoo Finance

Get Yahoo Finance instrument

Get Yahoo Finance instrument quote record and quote type.

GET/v1/yahoo-finance/instruments/{symbol}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
symbolstringrequiredpath

Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.

min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$

regionstringoptionalquery

Market region, a two-letter code such as `US`, `GB` or `JP`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Language tag for names and news, e.g. `en-US` or `ja-JP`.

max 24 chars · pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$

Response fields
12

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

The symbol the quote resolved to, in Yahoo Finance's own capitalisation; the asked-for symbol when the lookup found nothing.

datainstrument
objectnullable

The quote record, normalised.

dataquoteType
objectnullable

The quote-type record, normalised.

Status of each part of the result.

datasourcesquote
string

Status of the quote record.

one of: ok, empty, not_found

datasourcesquoteType
string

Status of the quote-type record.

one of: ok, empty, unavailable

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/AAPL" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Yahoo Finance instrument.