> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol.mdx>

---

# Yahoo Finance Instrument API

One ticker's quote record and instrument kind, with the exchange delay attached.

`GET /v1/yahoo-finance/instruments/{symbol}` returns `data.instrument`, the quote record, and `data.quoteType`, the instrument kind. The quote carries fields such as `symbol`, `shortName`, `longName`, `currency`, `exchange`, `marketState`, `regularMarketPrice`, `regularMarketChange`, `regularMarketChangePercent`, `regularMarketTime` and `exchangeDataDelayedBy`.

`data.sources.quote` and `data.sources.quoteType` report which parts are available, so a found quote with an unavailable quote type is visible rather than silent. An unknown ticker returns `lookupStatus: not_found` with both records null. A stub quote with no name and no price is also `not_found`; note that a dotted US class such as `BRK.B` is a stub, while the real ticker is `BRK-B`. Use the chart route when you need price history and the quotes route when you have a list of symbols.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## FAQ

### How do I pass a symbol?

Use the ticker as Yahoo Finance writes it: AAPL, ^GSPC, EURUSD=X, BTC-USD or 7203.T. The symbol goes in the path, not the query string.

### What is the difference between instrument and quoteType?

data.instrument is the quote record with price and market fields. data.quoteType is the instrument kind record, useful when you need to know whether the symbol is an equity, ETF, index or currency before you call another route.

### What if the quote type is unavailable?

data.lookupStatus can still be found while data.sources.quoteType is unavailable. The quote record is returned and data.quoteType is null; retry later rather than treating the whole lookup as missing.

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.