币价 · 接口

前缀：https://gateway.gelabs.org/market/api/v1。一律带 X-API-Key。信封见 开始接入。

一览

方法	路径	说明
GET	/chains	支持的链
GET	/chains/{id_or_name}	按 ID 或名称查一条链
GET	/quotes/latest	按代币 ID 最新价
POST	/quotes/batch	按链 + 合约地址报价
GET	/tokens	代币列表
GET	/tokens/search/{keyword}	搜寻代币
POST	/tokens/details	按 ID 查详情
GET	/fiats	法币列表
GET	/fiats/rates/{base}	汇率

最新价

GET /quotes/latest?ids=1,1027&fiat=USD

参数	必填	说明
ids	是	系统代币 ID，逗号分隔
fiat	否	法币代码，默认 USD

data.items[] 主要字段：token_id、symbol、fiat_code、price、percent_change_24h。

按合约报价

POST /quotes/batch

{
  "fiat": "USD",
  "token_addrs": [
    {"chain_type": "evm", "chain_id": 1, "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"}
  ]
}

链与代币

curl -H "X-API-Key: $API_KEY" https://gateway.gelabs.org/market/api/v1/chains
curl -H "X-API-Key: $API_KEY" https://gateway.gelabs.org/market/api/v1/tokens/search/usdt

POST /tokens/details 请求体：{"ids":[1,1027]}。

错误

常见业务码：20001 查询参数非法，20002 路径参数非法或未找到，20003 请求体非法。HTTP 200 + code != 0 与 5xx 都要处理。