Indices API reference

Overview

Levels and level history for 18 stock and volatility indices. Every request needs a Bearer key, and REST and MCP share one account quota.

An id is the index's standard code, such as SPX for the S&P 500, NDX for the Nasdaq-100 or DJI for the Dow Jones Industrial Average. Any case works. The list route returns every id with its name, region and currency.

A price carries the previous close, the change and the change in percent once the index's daily history is in.

Base URL: https://api.narwhalapi.com. The MCP tool is indices, with one action for each route below.

Plans and limits

See pricing for plan prices and monthly request limits. Each request counts as one call unless a route says otherwise.

• Free levels are delayed by 15 minutes. A delayed answer carries delayed: true.
• History starts where we hold it. The S&P 500 starts in February 2023.
• A volatility index (VIX, OVX, GVZ) is not money, so its answers carry no currency.
• market_session is open or closed by the index's published hours. A closed index answers with its last level and is not stale. An open index is stale when its level is more than 15 minutes old.
• A daily bar is one trading day and appears at 00:00 UTC. On Free it appears 15 minutes later, and end comes back when that cut your range. Today's partial bar is never shown.
• Bars carry no volume. One-minute bars are kept for 12 months, and one request covers at most 5 days. Free gets 403 plan_upgrade_required.
• A batch holds up to 50 ids and counts one call for each id that returns a level. An unknown id is listed in errors and is not counted.

Endpoints

Every route is a GET and needs your key in the Authorization: Bearer header. The examples show the shape of an answer, not live data.

Indices we price

GET /v1/indices

Every indices series we price, by id, with its name and unit. Read from our own list, so it is open to every plan and counts one call.

MCP: tool indices, action list.

Parameters

This route takes no parameters.

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices"

{
  "indices": [
    {
      "id": "SPX",
      "name": "S&P 500",
      "region": "us",
      "currency": "USD"
    },
    {
      "id": "VIX",
      "name": "Cboe Volatility Index",
      "region": "us"
    }
  ]
}

Latest price of one indices series

GET /v1/indices/{id}/price

The latest price. market_session is open or closed by the series' hours; a closed series answers with its last price, and stale is true only when an open series has no price from the last 15 minutes. Free sees the price 15 minutes late and the answer carries delayed: true. previous_close is the close of the previous trading day and change_percent is in percent.

MCP: tool indices, action price.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices/SPX/price"

{
  "id": "SPX",
  "name": "S&P 500",
  "currency": "USD",
  "price": "7696.46",
  "previous_close": "7681.2",
  "change": "15.26",
  "change_percent": "0.2",
  "market_session": "open",
  "timestamp": "2026-10-29T18:38:00Z",
  "stale": false
}

Latest prices for up to 50 indices series

GET /v1/indices/prices

Latest price of each listed id (Free sees them 15 minutes late). One call is counted for each id that returns a price, taken in one step: if fewer calls are left than ids that resolved, the whole request is refused with 429 quota_exceeded. Ids that return no price are listed in errors (as id) and cost nothing; if no id resolves the answer is still 200, with an empty prices. previous_close is the close of the previous trading day and change_percent is in percent.

Send up to 50 ids. A batch is charged in one step: if you have fewer calls left than ids that resolve, the whole request returns 429 quota_exceeded.

MCP: tool indices, action prices.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices/prices?ids=SPX,NDX,DJI"

{
  "prices": [
    {
      "id": "SPX",
      "name": "S&P 500",
      "currency": "USD",
      "price": "7696.46",
      "previous_close": "7681.2",
      "change": "15.26",
      "change_percent": "0.2",
      "market_session": "open",
      "timestamp": "2026-10-29T18:38:00Z",
      "stale": false
    },
    {
      "id": "NDX",
      "name": "Nasdaq-100",
      "currency": "USD",
      "price": "27310.5",
      "previous_close": "27264.9",
      "change": "45.6",
      "change_percent": "0.17",
      "market_session": "open",
      "timestamp": "2026-10-29T18:38:00Z",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "XX",
      "code": "not_found"
    }
  ]
}

Price bars of one indices series

GET /v1/indices/{id}/bars

Daily (1d, one bar per trading day) or one-minute (1m) bars, oldest first. A day's bar is out at 00:00 UTC after the day (Free: 15 minutes later, and end comes back when that cut the range); today's partial bar is never shown. One-minute bars are for Basic and Pro (Free gets 403 plan_upgrade_required) and kept for 12 months. History: Free 12 months, Basic 5 years, Pro everything; start is sent back when the plan raised it. Up to 5,000 bars a page, with next_cursor. One call a page.

MCP: tool indices, action bars.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices/SPX/bars?interval=1d&start=2026-10-01"

{
  "id": "SPX",
  "currency": "USD",
  "bars": [
    {
      "timestamp": "2026-10-28T00:00:00Z",
      "open": "7655.1",
      "high": "7702.4",
      "low": "7640.8",
      "close": "7681.2"
    }
  ],
  "next_cursor": null
}

Errors

Errors use the shared problem shape with a request_id. See Errors and quota for the shape and the quota headers. Failed requests are not charged.