跳到主要内容

Token Price API · 简介

服务简介​

服务简介​

Token Price API 是一个多链代币价格聚合查询服务。它提供以下核心能力：

  • 查询系统支持的区块链列表与链基础信息
  • 按代币 ID 或合约地址批量查询实时报价
  • 查询代币资产信息（包括跨链平台分布）
  • 查询法币列表与汇率
  • 搜索 DEX 流动性池数据

所有对外接口均挂载在 /price/api/v1 路径前缀下，使用 HTTP/JSON 协议通信。当前对外服务不提供 WebSocket、SSE 或订阅推送接口。对外接口请求必须携带 X-API-Key，用于接口鉴权和计费。

Base URL​

所有接口请求均以以下生产环境地址为根路径：

https://api.gelabs.org

示例：

https://api.gelabs.org/price/api/v1/chains

统一响应结构​

接口统一使用 { code, msg, data } 响应体。业务成功时 code 固定为 0；常见参数校验失败通常仍返回 HTTP 200 并通过业务错误码区分。服务内部异常可能返回 HTTP 503/500。

响应体结构固定为：

{
  "code": 0,
  "msg": "success",
  "data": {}
}
字段类型说明
codeinteger业务状态码。成功固定为 0，失败为对应错误码
msgstring响应消息。成功时通常为 success
dataobject / string业务数据主体。失败时通常为空字符串 ""

成功响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 1,
    "items": [...]
  }
}

失败响应示例：

{
  "code": 20001,
  "msg": "ids is required",
  "data": ""
}

注意： 请同时关注 HTTP 状态码和响应体 code。业务成功以 code: 0 为准；参数错误多为 HTTP 200 + 业务错误码；服务内部失败可能是 HTTP 503/500。

业务错误码​

错误码含义常见触发场景
0成功正常响应
20001非法查询参数必填的 query 参数缺失或格式不合法
20002非法路径参数路径参数格式不合法或资源未找到
20003非法请求体JSON 格式错误，或请求体中必填字段缺失/为空
30001服务端错误服务内部异常

公共请求头​

所有对外服务接口请求均需要携带以下请求头：

请求头必填说明
X-API-Key是API Key，用于接口鉴权和计费。

部分接口还会返回缓存控制响应头，具体见各接口说明。