暗号資産APIリファレンス

概要

暗号資産ペアの価格と価格履歴。すべてのリクエストに Bearer キーが必要で、REST と MCP は同じクレジット残高を使います。

ペア ID は、コイン、ハイフン、建値通貨の順で、たとえば BTC-USD や ETH-EUR です。大文字小文字は問わず、ハイフンの代わりにスラッシュも使えます。レスポンスには必ず正規のペアが入ります。建値通貨は USD、EUR、GBP です。価格は有効数字最大8桁の10進数文字列です。

暗号資産は終日取引されるため、市場セッションはありません。価格は5分より古くなると古い値(stale)になります。

ベースURL： https://api.narwhalapi.com。 MCP ツールは次のとおりです： crypto, with one action 以下の各ルートに対応します。

すべてのアカウントで利用できるもの

参照： 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

• 暗号資産には出来高がありません。価格とバーに出来高フィールドはありません。
• 日次バーは UTC の1日分で、00:00 UTC に現れます。当日の途中のバーは表示されません。
• ペア一覧には、価格を提供しているペアが載ります。ペアは30秒に1回以上取引されている間は載り、2分に1回を下回ると外れます。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

価格を提供している暗号資産ペア

GET /v1/crypto/pairs

価格を提供しているすべてのペアを、ペア順(BTC-USD 形式)に返します。任意の quote(USD、EUR、GBP)を指定できます。ペアは30秒に1回以上取引されている間は載り、2分に1回を下回ると外れます。自社のペア一覧から読むため、すべてのアカウントで利用でき、1回の呼び出しとして数えます。

MCP: ツール crypto, action pairs。

パラメータ

レスポンスフィールド

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"
    }
  ]
}

暗号資産ペア1件の最新価格

GET /v1/crypto/{pair}/price

ペアの最新の複合価格を、24時間の変化とともに返します(不明な場合は省略)。暗号資産は終日取引されるため、市場セッションはありません。価格が5分より古い場合、stale は true です。change_24h_percent はパーセント単位です。

MCP: ツール crypto, action price。

パラメータ

レスポンスフィールド

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
}

最大50の暗号資産ペアの最新価格

GET /v1/crypto/prices

指定した各ペアの最新価格を返します。価格を返したペアごとに1回の呼び出しとして数え、一括で課金します。解決できたペアの分を残高で支払えない場合、リクエスト全体が 402 insufficient_credits で拒否されます。価格を返さなかったペアは errors に(id として)並び、課金されません。change_24h_percent はパーセント単位です。

最大50ペアを送れます。バッチは一括で課金されます。解決できたペアの分を残高で支払えない場合、リクエスト全体が 402 insufficient_credits を返します。

MCP: ツール crypto, action prices。

パラメータ

レスポンスフィールド

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"
    }
  ]
}

暗号資産ペア1件の価格バー

GET /v1/crypto/{pair}/bars

日次(1d。UTC の1日分で、00:00 UTC に確定)または1分(1m)のバーを古い順に返します。1日のバーは 00:00 UTC に出ます。当日の途中のバーは表示されません。履歴はすべてのアカウントで全期間を取得できます。1ページ最大5,000バーで、next_cursor を返します。価格と一致しなくなったカーソルは 409 cursor_expired です。1ページにつき1回の呼び出しです。

カーソルの元になっている価格が変わると、カーソルは使えなくなり、409 cursor_expired を返します。

MCP: ツール crypto, action bars。

パラメータ

レスポンスフィールド

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
}

エラー

エラーは共通の problem 形式で返され、次のコードを含みます: request_id。参照： APIエラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。