获取 Chaingateway 的 API 规范

Chaingateway OpenAPI 规范是用 OpenAPI 3.0.3 格式对 REST API 所做的机器可读描述。它列出了全部七条链的接口、请求和响应结构,以及 Bearer 令牌认证方式。Chaingateway 是 REST API,所以无需安装任何应用。

OpenAPI 规范包含什么?

它描述了 164 个路径上的 202 个操作:一个账户接口、一个价格接口,以及七条链的地址、交易、余额、区块和 webhook 接口。其中 116 个操作是 GET,68 个是 POST,12 个是 DELETE,6 个是 PUT。

链 操作数 代币标准 webhook 操作数
Bitcoin 21 无 8
Ethereum 31 ERC-20, ERC-721 8
BNB Smart Chain 31 BEP-20, BEP-721 8
TRON 40 TRC-10, TRC-20, TRC-721 8
Solana 15 SPL 无
Polygon 31 ERC-20, ERC-721 8
Arbitrum 31 ERC-20, ERC-721 8

文件是 YAML,约 1 MB,规范版本为 2.1.0。服务器是 https://app.chaingateway.io。每个接口都使用 HTTP Bearer 认证,令牌在控制台的 API tokens 下创建。这些数量截至 2026 年 11 月 5 日,新增接口后会变化。

如何用规范生成客户端?

用 OpenAPI 代码生成器处理该文件。下面的命令用 OpenAPI Generator 创建 TypeScript 客户端,-g 选项用来选择语言。

npx @openapitools/openapi-generator-cli generate \
  -i https://chaingateway.io/openapi.yaml \
  -g typescript-fetch \
  -o ./chaingateway-client

把 typescript-fetch 换成你所用语言的生成器,例如 python 或 php。依赖生成的代码之前,先在测试网跑一次调用。 OpenAPI Generator:生成器列表

如何把规范导入 Postman 或 Insomnia?

两个工具都可以直接导入 OpenAPI 文件。选择导入选项,然后粘贴 URL https://chaingateway.io/openapi.yaml,或选择已下载的文件。把 Authorization 头设为你的 Bearer 令牌,测试时再加上 X-Network: testnet。

没有生成的客户端时,如何调用 API?

把 Bearer 令牌放在 Authorization 头中,发送到 https://app.chaingateway.io。添加 X-Network: testnet 使用测试网。省略该头,或设为 mainnet,则使用主网。

curl https://app.chaingateway.io/api/account \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Network: testnet"

GET /api/account 可以快速检查令牌是否有效。

规范中的响应和错误是什么样的?

成功的操作返回 HTTP 200 或 201,示例把结果包在含 status、ok、message 和 data 字段的信封里。在 202 个操作中,规范记录了 401(未认证)50 次,422(例如数据验证失败或余额不足)70 次,404 五次,400 一次。

401 的示例在 message 字段中是「Unauthenticated.」。先看状态码,再看消息。

有可读版本的规范吗?

有。交互式 API 参考页面渲染的就是同一份文件,所以在生成任何代码之前,你就可以阅读接口、试用请求并复制示例。 打开 API 参考

规范中哪些部分已弃用?

Tron Paymaster 操作仍在文件中,共五个。Paymaster 已弃用,由 TronFuel 取代,所以新的集成请不要使用它们。Solana 完全没有 webhook 接口。

准备好开始开发了吗?

每一次集成都运行在同一个 Chaingateway REST API 上 — 7 天免费试用,无需信用卡,无需 KYC。套餐起价 49 欧元/月,涵盖全部 7 条支持的链。