链上基础数据 API 提供公链概览、区块、交易、事件日志和地址数据。推荐先查询目标接口的支持链，再调用业务接口；不要因为某条链被一个模块支持，就假设其他模块也支持该链。

API 参考#

快速开始#

调用约定#

• Base URL：https://web3.okx.com
• chainIndex 是数字字符串，例如 Ethereum 为 1、Bitcoin 为 0，不能传链名。
• 时间参数使用 Unix 毫秒时间戳字符串，例如 1597026383085。
• 每次请求都需要 OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP 和 OK-ACCESS-PASSPHRASE。
• 签名必须按本次请求的 method、path、query、body 和 timestamp 生成，不能在不同 URL 或翻页请求之间复用。
• 成功响应使用 code、msg、data 包络，code 是字符串。

推荐调用流程#

1. 把输入的链名转换为 chainIndex。
2. 调用目标模块的 supported-chains 接口。
3. 同时匹配响应中的 apiName 和 chainIndex。
4. 匹配成功后调用目标接口；否则返回“该接口暂不支持此链”。
5. 按接口上限拆分批量参数和区块范围。
6. 分页时原样回传 cursor，直到响应中的 cursor 为空字符串。

组合场景#

支持链映射#

按模块发现实际支持范围#

建议把响应保存为 supported[(module, apiName, chainIndex)] = true 集合。例如，调用 /api/v6/explorer/transaction/transaction-multi 前，应检查 supported[("transaction", "transaction-multi", "1")]。

apiName 与接口映射#

address/information-evm、事件日志接口及标注“仅支持 EVM”的接口，只能在对应支持链接口确认后用于 EVM 链。收到 50038 时应刷新当前模块的支持链缓存，不能把该链永久标记为全局不支持。完整名称映射见文末附录。

分页、批量和范围限制#

cursor 分页#

1. 首次请求不传 cursor。
2. 下一次请求原样传回响应中的 cursor，不要转换成页码。
3. cursor 为空字符串时停止。
4. 日志接口即使返回空 logList，只要 cursor 非空仍需继续请求。
5. 同一条 cursor 链必须串行翻页；不同查询可在限流预算内并行。

调用限制#

超过限制时应先在客户端切片；合并结果时按交易哈希、日志索引或业务唯一键去重。

附录：chainName 与 chainIndex 完整映射#

此表用于将链名或别名转换为候选 chainIndex，包含主网、测试网和历史名称。它不是接口支持清单；调用前仍需通过对应模块的 supported-chains 接口同时确认 apiName 和 chainIndex。

部分名称代表不同网络或历史登记项，例如 CORE=70000025 与 CORE_EVM=1116、CRO=25 与 CRO_COSMOS=394、CFX=1030 与 Conflux=503。遇到重名时应结合网络类型确认，不要仅按显示名称猜测。