Crypto API reference

Overview

Prices and price history for crypto pairs. Every request needs a Bearer key, and REST and MCP share one account quota.

A pair id is the coin, a dash and the quote currency, such as BTC-USD or ETH-EUR. Any case works, and a slash in place of the dash is accepted. Every answer carries the canonical pair. Quote currencies are USD, EUR and GBP. Prices are decimal strings with up to 8 significant digits.

Crypto trades all day, so there is no market session. A price is stale when it is more than 5 minutes old.

Base URL: https://api.narwhalapi.com. The MCP tool is crypto, 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 prices are delayed by 15 minutes. A delayed answer carries delayed: true.
• Crypto has no volume. Prices and bars carry no volume field.
• A daily bar is one UTC 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.
• The pair list holds the pairs we price. A pair is listed while it trades at least once every 30 seconds and dropped when it falls below once every 2 minutes.
• Basic reaches back 5 years and Pro has full history. When your plan cuts older rows, start comes back with the first date served.

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.

Crypto pairs we price

GET /v1/crypto/pairs

Every pair we price, by pair (BTC-USD style). Optional quote (USD, EUR or GBP). A pair is listed while it trades at least once every 30 seconds and dropped when it falls below once every 2 minutes. Read from our own pair list, so it is open to every plan and counts one call.

MCP: tool crypto, action pairs.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/pairs?quote=USD"

{
  "pairs": [
    {
      "pair": "BTC-USD",
      "base": "BTC",
      "quote": "USD",
      "name": "Bitcoin"
    },
    {
      "pair": "ETH-EUR",
      "base": "ETH",
      "quote": "EUR",
      "name": "Ethereum"
    }
  ]
}

Latest price of one crypto pair

GET /v1/crypto/{pair}/price

The latest composite price of a pair, with the 24-hour change (left out on Free and when it is not known). Crypto trades all day, so there is no market session; stale is true when the price is more than 5 minutes old. Free sees the price 15 minutes late and the answer carries delayed: true. change_24h_percent is in percent.

MCP: tool crypto, action price.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/BTC-USD/price"

{
  "pair": "BTC-USD",
  "base": "BTC",
  "quote": "USD",
  "price": "68250.5",
  "change_24h": "812.4",
  "change_24h_percent": "1.2",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false
}

Latest prices for up to 50 crypto pairs

GET /v1/crypto/prices

Latest price of each listed pair (Free sees them 15 minutes late). One call is counted for each pair that returns a price, taken in one step: if fewer calls are left than pairs that resolved, the whole request is refused with 429 quota_exceeded. Pairs that return no price are listed in errors (as id) and cost nothing. change_24h_percent is in percent.

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

MCP: tool crypto, action prices.

Parameters

Response fields

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/prices?pairs=BTC-USD,ETH-USD"

{
  "prices": [
    {
      "pair": "BTC-USD",
      "base": "BTC",
      "quote": "USD",
      "price": "68250.5",
      "change_24h": "812.4",
      "change_24h_percent": "1.2",
      "timestamp": "2026-10-26T15:42:00Z",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "XYZ-USD",
      "code": "not_found"
    }
  ]
}

Price bars of one crypto pair

GET /v1/crypto/{pair}/bars

Daily (1d, one UTC day, closing at 00:00 UTC) or one-minute (1m) bars, oldest first. A day's bar is out at 00:00 UTC (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). 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 the prices behind a cursor change, the cursor stops working and returns 409 cursor_expired.

MCP: tool crypto, action bars.

Parameters

Response fields

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

{
  "pair": "BTC-USD",
  "bars": [
    {
      "timestamp": "2026-10-25T00:00:00Z",
      "open": "67210.3",
      "high": "68540.9",
      "low": "66980.1",
      "close": "68100.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.