Stable instrument ID
Use the ID returned by discovery; ticker symbols alone are ambiguous.
Read the methodology →All APIs
Equities API
Stock discovery, daily price history, and quote streaming.
First request
Quickstart →curl --request GET \
--url "https://api.narwhalapi.com/v1/equities/instruments?symbol=AAPL" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Example response Illustrative response · not a live request
{
"count": 1,
"data": [
{
"id": "eq_11111111111111111111111111111111",
"symbol": "AAPL",
"name": "Apple Inc.",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"country": "United States",
"type": "Common Stock"
}
],
"status": "ok"
}Endpoints
GETDiscover accepted instruments/v1/equities/instruments
GETRead instrument identity/v1/equities/instruments/{instrument_id}
GETRead daily OHLCV history/v1/equities/instruments/{instrument_id}/bars
WSStream eight USD stocks · Basic and Pro/v1/equities/stream
Sources and methodology
Closed daily sessions
Dates follow the venue calendar and exchange timezone.
Split-adjusted OHLCV
Open, high, low, close and volume remain decimal strings.
Coverage
View coverage →Daily data covers 102 accepted common-stock instruments. Streaming covers ADSK, ALL, APD, ASML, EBAY, DOW, KMX and DVA. Complete exchange coverage, intraday bars, dividends and fundamentals are outside this release.
REST and MCP share one key and quota. The paid WebSocket stream consumes one quota unit per admitted quote, including snapshots; account rate limits apply.