加密货币 API 文档参考

概览

加密货币交易对的价格和价格历史。每个请求都需要 Bearer 密钥，REST 和 MCP 共用同一余额。

交易对 id 由币种、连字符和计价货币组成，例如 BTC-USD 或 ETH-EUR。不区分大小写，也可用斜杠代替连字符。每个响应都带有规范交易对。计价货币为 USD、EUR 和 GBP。价格是十进制字符串，最多 8 位有效数字。

加密货币全天候交易，没有市场时段。价格超过 5 分钟未更新即为过期。

基础 URL： 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
}

错误

错误使用通用的 problem 结构，并带有 request_id。查看 API 错误码与额度 了解该结构和额度相关的响应头。失败的请求不计费。