一目了然
Narwhal 提供国家商品贸易总量，不含伙伴国、产品或服务的细分。Narwhal API 由 Nusantara Ventures, LLC 拥有并运营。
| 需求 | Narwhal API | UN Comtrade |
|---|---|---|
| 免费额度 | ✓ 12 个月内每月 $10 免费额度，无需绑卡 | ✓ 预览；使用密钥的 Free：每天 500 次调用 |
| 最低价付费方案 | $20 起充值，每 1,000 次调用 $2 至 $10 | Premium：价格未公布 |
| 更新速度 | 按数据集的更新计划，保留时间戳 | 报告滞后因国家而异 |
| 历史 | 所有账户均可获取完整历史，仅限可用记录 | 自 1962 年起 |
| 覆盖范围 | 经济数据、汇率、节假日及已公布的大宗商品数据 | 274 个报告国和伙伴国；双边与 HS 明细 |
| 接口 | REST 和 MCP；WebSocket 未公布 | REST；未发现官方 MCP |
| SDK 支持 | ✓ 官方 Python 和 TypeScript SDK | 未说明 |
| 免费额度的商业使用 | ✓ 可用于商业应用，转售需定制协议 | 未说明 |
按用量计价
预览足以满足总量请求：每次调用 500 条记录、一个周期和一种产品，速率为每秒 1 次。
| 每月请求数 | Narwhal API | UN Comtrade |
|---|---|---|
| 1,000 | 按每 1,000 次调用 $2 计，共 $2.00 | 无需密钥的预览：$0 |
| 10,000 | 按每 1,000 次调用 $2 计，共 $20.00 | 无需密钥的预览：$0 |
| 100,000 | 按每 1,000 次调用 $2 计，共 $200.00 | 无需密钥的预览：$0 |
几分钟即可切换
读取美国商品贸易总量
UN Comtrade
# Change: URL
curl --get \
"https://comtradeapi.un.org/public/v1/preview/C/A/HS" \
--data-urlencode "reporterCode=842" \
--data-urlencode "period=2025" \
--data-urlencode "partnerCode=0" \
--data-urlencode "cmdCode=TOTAL" \
--data-urlencode "flowCode=X"Narwhal API
# Change: URL and key
curl \
"https://api.narwhalapi.com/v1/economics/USA/trade" \
-H "Authorization: Bearer YOUR_API_KEY"团队为何切换
免费开始构建
每个 Narwhal 账户都可获得 12 个月、每月 $10 的免费额度，并允许商业应用使用。可以用这笔额度做仪表板、定时数据抓取或智能体集成。用量增长后可从 $20 起追加充值，账户和认证方式保持不变。
连接你的应用和智能体
REST 和托管 MCP 通过同一个账户访问相同的数据。应用可以获取 JSON，智能体则使用托管工具，每次调用只从共享额度余额中扣费一次。只有一个余额，合并后的整体用量也便于做预算。
接入各国数据
Narwhal 的经济数据目录覆盖 37 个国家，每个指标都有覆盖范围表。按国家和指标的路径组织请求，把观测值与汇率、公共假日和发布日期结合，就能在同一账户下搭建国别仪表板。
对方更合适的情形
UN Comtrade 适合不仅需要国家总量，还需要伙伴国流向、HS 产品或转口贸易的贸易研究。其官方商品贸易数据来自各国统计机构，拥有 274 个报告国和伙伴国自 1962 年以来的历史数据。免费个人账户每天最多可调用 500 次，每次最多 100,000 条记录。各国的报告滞后和数据缺口各不相同。报告的出口额可能与伙伴国的进口额不一致，联合国对这类双边不对称有专门说明。
常见问题
有免费的 UN Comtrade 替代方案吗？
是的。Narwhal 为每个账户提供12个月、每月 10 美元的免费额度，允许商业应用使用，并同时支持 REST 和托管 MCP 访问。每个账户都可获取国家商品贸易总量的完整历史数据，不含伙伴国或产品细分。
Narwhal 能按伙伴国或产品筛选商品贸易吗？
不能。Narwhal 返回 35 个国家的国家商品出口、进口和差额，含币种及月度或年度周期。它没有伙伴国或 HS 产品筛选，也不含服务贸易。如需双边流向和产品明细，请选择 UN Comtrade，并留意各国的报告缺口和双边不对称。
我的应用需要改什么？
替换请求 URL 和认证方式，再把 JSON 响应映射到应用的字段即可。示例使用 JavaScript 的标准 fetch 和 Python 的 requests，因此普通的 HTTP 客户端就能完成集成。请把密钥保存在服务端，并在展示或计算中保留响应里的单位、日期和缺失值。
Narwhal 额度用完会怎样？
额度余额由 REST 和 MCP 调用共用。余额为零时，API 会返回 HTTP 402 `insufficient_credits`，且不会向你收取超出余额的费用。免费额度不会结转，付费额度在最后一次充值 12 个月后过期。
已审核: