Unusual Whales API - Stock Directory endpoint
Layer mapping: L1 (reference data). Single endpoint, ticker-to- exchange mapping. Reference data only - not signal substrate. Pull once at install, cache forever (refresh quarterly when listings change).
1. Endpoint
GET /api/stock-directory/ticker-exchanges
Ticker-to-exchange directory.
No documented parameters.
Authentication: Bearer token.
Response per record:
| Field | Type | Description |
|---|---|---|
ticker | string | Stock ticker symbol |
exchange | string | Listing exchange (e.g. nasdaq, nyse) |
Example: AAPL → nasdaq, JPM → nyse.
2. MK3 use
Use case 1: Venue analysis. Combine with uw-api-lit-flow to
know which exchange a ticker’s primary listing is on. The market_center
code on lit prints identifies the trade venue; the directory tells
you the listing venue. Material when analyzing routing decisions.
Use case 2: Cross-listing checks. Some tickers trade on multiple venues. For SPY (NYSE Arca listing, trades on every venue), this is trivial. For per-name strategies on lower-volume tickers, useful for identifying primary-listing volume vs other-venue volume.
Cadence: pull once at install. Refresh quarterly (when new listings happen, or when a name moves between exchanges). Cache in Postgres or a static JSON.
3. Nautilus integration shape
- One-time bootstrap call.
- Cached as a
Dict[str, str]mapping in memory. - Or written to a Nautilus
InstrumentProviderextension if Nautilus needs the listing-venue at instrument creation.
4. Known gaps
- Exchange code taxonomy not enumerated in docs - first fetch
should catalog. Expected values:
nasdaq,nyse,nysearca,cboe,nyseamerican, plus regional / OTC venues. - No
is_activeflag - delisted tickers may or may not appear. - No corporate action history - if a ticker changed exchanges historically, this endpoint only returns its current state.
5. Source URL
https://api.unusualwhales.com/docs/operations/PublicApi.StockDirectoryController.ticker_exchanges
cortana-north-star uw-api-lit-flow uw-api-darkpool uw-api-etfs