加密貨幣 API 參考文件

概覽

加密貨幣交易對的價格與歷史價格。每個請求都需要 Bearer 金鑰，REST 與 MCP 共用同一個額度餘額。

交易對 id 由幣種、連字號與計價幣別組成，例如 BTC-USD 或 ETH-EUR。大小寫皆可，也接受以斜線取代連字號。每個回應都會附上標準交易對。計價幣別為 USD、EUR 與 GBP。價格是最多 8 位有效數字的十進位字串。

加密貨幣全天候交易，因此沒有交易時段。價格超過 5 分鐘未更新即為過時。

基礎網址： https://api.narwhalapi.com。 MCP 工具是 crypto, with one action ，適用於下列每個路由。

每個帳戶都能取得的內容

查看 定價 說明每次呼叫的費用。除非路由另有說明，請求依其所屬 API 的價格計費。

• 加密貨幣沒有成交量。價格與 K 線都不含成交量欄位。
• 日 K 線涵蓋一個 UTC 日，於 00:00 UTC 出現。當日尚未完成的 K 線不會顯示。
• 交易對清單包含我們提供報價的交易對。交易對在每 30 秒至少成交一次時列入，低於每 2 分鐘一次時移除。

端點

每個路由都是 GET 請求，並需要將你的金鑰放在以下請求標頭中： Authorization: Bearer 標頭。範例僅展示回應的結構，並非即時資料。

提供報價的加密貨幣交易對

GET /v1/crypto/pairs

我們提供報價的所有交易對，依交易對排序（BTC-USD 格式）。可選用 quote（USD、EUR 或 GBP）。交易對在每 30 秒至少成交一次時列入，低於每 2 分鐘一次時移除。資料來自我們自己的交易對清單，所有帳號皆可使用，計為一次呼叫。

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

單一加密貨幣交易對的最新價格

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

所列每個交易對的最新價格。每個回傳價格的交易對計為一次呼叫，並一次性扣款：若餘額不足以支付已解析的交易對，整個請求會以 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"
    }
  ]
}

單一加密貨幣交易對的價格 K 線

GET /v1/crypto/{pair}/bars

日（1d，一個 UTC 日，於 00:00 UTC 收盤）或一分鐘（1m）K 線，由舊到新排列。某日的 K 線在 00:00 UTC 產生；當日尚未完成的 K 線不會顯示。歷史資料：全部，所有帳號皆可取得。每頁最多 5,000 根 K 線，並附 next_cursor；游標與價格不再相符時會回傳 409 cursor_expired。每頁計為一次呼叫。

若游標所對應的價格有變動，游標會失效並回傳 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
}

錯誤

錯誤使用共用的問題格式，並包含 request_id。查看 API 錯誤 處理：錯誤碼、額度與重試 了解格式與額度標頭。失敗的請求不計費。