Skip to main content

Symbols And Exchanges

Most quote routes accept a symbol in the path:

/v1/quote/AAPL/summary
/v1/quote/MSFT/details
/v1/quote/NVDA/financials

For U.S. equities, pass exchange=NASDAQ or exchange=NYSE when you know the listing venue:

curl "https://api.gfin.dev/v1/quote/AAPL/summary?exchange=NASDAQ"

The SDKs pass the same query parameters through:

client.quote_summary("AAPL", exchange="NASDAQ")
await client.quoteSummary("AAPL", { exchange: "NASDAQ" });

Exchange-Prefixed Symbols​

You can also pass symbols in exchange-prefixed form where it is more natural in your app:

NASDAQ:AAPL
NYSE:IBM

The explicit exchange= query parameter is clearer for public APIs and is the recommended form for user-entered symbols.

Search First​

If the user enters a company name, run search before requesting quote views:

curl "https://api.gfin.dev/v1/search?q=apple"

Search output can include labels, symbols, exchanges, entity IDs, and other source-provided hints. Store the display fields your app needs, but keep your gfin calls on public route names.

Entity IDs​

Realtime routes accept entity_ids for snapshots and trend lines:

curl "https://api.gfin.dev/v1/realtime/snapshots?entity_ids=/m/0cqyw,/m/016yss"

Use search or quote responses to discover entity IDs when your workflow depends on realtime route inputs.