Equities API reference

Instrument discovery, identity and split-adjusted daily bars through REST and MCP.

Operations

Send Authorization: Bearer YOUR_API_KEY to https://api.narwhalapi.com. MCP is available at /mcp. Use the real instrument ID returned by discovery.

GET path	MCP tool
`/v1/equities/instruments`	`equities_list_instruments`
`/v1/equities/instruments/{instrument_id}`	`equities_get_instrument`
`/v1/equities/instruments/{instrument_id}/bars`	`equities_get_bars`

curl "https://api.narwhalapi.com/v1/equities/instruments?symbol=AAPL" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

Parameters

Discovery accepts optional symbol, mic_code and country, plus page (default 1) and outputsize (default 100, maximum 5,000).

Bars require instrument_id. Supported values are interval=1day and adjust=splits. Optional start_date and end_date use YYYY-MM-DD. outputsize defaults to 30 and has a maximum of 5,000.

Responses and limits

Discovery and detail return count, data and status. Each instrument includes its ID, symbol, name, currency, exchange, MIC, country and common-stock type.

Bars return meta, values and status. Metadata includes currency, exchange timezone and MIC. Values contain datetime, open, high, low, close and volume, ordered newest first. Prices and volume are decimal strings.

The launch covers 102 accepted instruments and closed daily sessions. Intraday quotes, dividends and fundamentals are outside this release. Successful REST and MCP calls consume the same shared quota.

Read methodology and coverage. The runtime OpenAPI schema defines exact validation and error responses.