Funds API reference

Overview

Prices, price history, distributions, profiles and search for ETFs and mutual funds. Every request needs a Bearer key, and REST and MCP share one account quota.

An ETF id is its listing id, such as ARCX:SPY. A mutual fund id is FUND, a colon and its ticker, such as FUND:VFIAX. A bare US ticker such as SPY also works when it names one US listing. A stock id on a fund route returns 404 not_found, and a fund id on a stock route moves here with a 301.

An ETF has a price. A mutual fund has a net asset value (NAV) once a day, in nav, previous_nav and date. The price answer has a type field that tells you which one you got.

Base URL: https://api.narwhalapi.com. The MCP tool is funds, 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 ETF prices are delayed by 15 minutes. A delayed answer carries delayed: true and leaves out the day volume.
• A mutual fund NAV is an end-of-day value and is never delayed. It is stale once it is older than the next business day.
• A mutual fund has no one-minute bars. Asking for them returns 400 invalid_interval.
• A mutual fund's daily bar is its NAV: open, high, low and close are the same number, and there is no volume.
• Basic reaches back 5 years and Pro has full history. When your plan cuts older rows, start comes back with the first date served.
• kind on a distribution is left out until our sources give it.

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.

Search ETFs and mutual funds by ticker or name

GET /v1/funds/search

Funds whose ticker or name starts with q, any case: an exact ticker first, then other tickers, then names. Optional type (etf or mutual_fund) and country (three letters) filters. Up to 50 a page, with next_cursor. Read from our own symbol list, so it is open to every plan and counts one call.

MCP: tool funds, action search.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/search?q=vanguard&type=mutual_fund"

{
  "results": [
    {
      "id": "ARCX:SPY",
      "symbol": "SPY",
      "name": "SPDR S&P 500 ETF Trust",
      "type": "etf",
      "mic": "ARCX",
      "country": "USA",
      "currency": "USD"
    },
    {
      "id": "FUND:VFIAX",
      "symbol": "VFIAX",
      "name": "Vanguard 500 Index Fund Admiral Shares",
      "type": "mutual_fund",
      "country": "USA",
      "currency": "USD"
    }
  ],
  "next_cursor": null
}

Profile of one fund

GET /v1/funds/{id}

The fund's symbol, name, type (etf or mutual_fund), exchange (ETFs only), country and currency, as our symbol list holds them. Open to every plan. Fields that are not known are left out.

MCP: tool funds, action profile.

Parameters

Response fields

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

{
  "id": "ARCX:SPY",
  "symbol": "SPY",
  "name": "SPDR S&P 500 ETF Trust",
  "type": "etf",
  "mic": "ARCX",
  "country": "USA",
  "currency": "USD"
}

Latest price of one fund

GET /v1/funds/{id}/price

An ETF's last price, in the stock price shape plus type: etf (Free sees it 15 minutes late and the answer carries delayed: true), or a mutual fund's latest NAV (type: mutual_fund: nav, previous_nav, change, change_percent and the NAV's date; an end-of-day value, never delayed, stale once it is older than the next business day). change_percent is in percent. A stock id is 404 not_found.

MCP: tool funds, action price.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY/price"

{
  "id": "ARCX:SPY",
  "symbol": "SPY",
  "currency": "USD",
  "price": "578.12",
  "previous_close": "576.40",
  "change": "1.72",
  "change_percent": "0.30",
  "volume": "61230500",
  "market_session": "open",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false,
  "type": "etf"
}

Latest prices for up to 50 funds

GET /v1/funds/prices

Latest price of each listed fund: an ETF's last price (Free sees it 15 minutes late) or a mutual fund's latest NAV. 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 and cost nothing. change_percent is in percent.

Send up to 50 ids, ETFs and mutual funds together. 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 funds, action prices.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/prices?ids=ARCX:SPY,FUND:VFIAX"

{
  "prices": [
    {
      "id": "ARCX:SPY",
      "symbol": "SPY",
      "currency": "USD",
      "price": "578.12",
      "previous_close": "576.40",
      "change": "1.72",
      "change_percent": "0.30",
      "volume": "61230500",
      "market_session": "open",
      "timestamp": "2026-10-26T15:42:00Z",
      "stale": false,
      "type": "etf"
    },
    {
      "id": "FUND:VFIAX",
      "symbol": "VFIAX",
      "currency": "USD",
      "type": "mutual_fund",
      "nav": "551.07",
      "previous_nav": "549.80",
      "change": "1.27",
      "change_percent": "0.23",
      "date": "2026-10-23",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "FUND:NOPE",
      "code": "not_found"
    }
  ]
}

Price bars of one fund

GET /v1/funds/{id}/bars

Daily (1d) or one-minute (1m) bars, oldest first, in the stock bar shape. A mutual fund's daily bar is its daily NAV (open, high, low and close are the NAV, no volume); it has no one-minute bars (400 invalid_interval). One-minute bars are for ETFs on Basic and Pro (Free gets 403 plan_upgrade_required). 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; a cursor that no longer matches the prices is 409 cursor_expired. One call a page.

If a split or distribution changes the history between two pages, the cursor stops working and returns 409 cursor_expired.

MCP: tool funds, action bars.

Parameters

Response fields

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

{
  "id": "ARCX:SPY",
  "currency": "USD",
  "adjusted": true,
  "bars": [
    {
      "date": "2026-10-23",
      "timestamp": "2026-10-23T13:30:00Z",
      "open": "575.10",
      "high": "577.60",
      "low": "573.90",
      "close": "576.40",
      "volume": "48210300"
    }
  ],
  "next_cursor": null
}

Distributions of one fund

GET /v1/funds/{id}/distributions

Distributions of one fund, newest ex-date first, paged. The plan sets how far back the past goes: Free 12 months, Basic 5 years, Pro full; start is sent only when older rows were cut off. Each request counts one call. An unknown id is 404 not_found.

MCP: tool funds, action distributions.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY/distributions"

{
  "id": "ARCX:SPY",
  "distributions": [
    {
      "ex_date": "2026-09-18",
      "amount": "1.78",
      "currency": "USD",
      "pay_date": "2026-10-30",
      "record_date": "2026-09-18"
    }
  ],
  "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.