Token Price API · 快速上手

快速接入流程

开始前请先准备服务分配的 X-API-Key，并确认调用环境可以访问 https://api.gelabs.org。完整响应结构、错误码和字段说明见 接口详情。

设置 API Key

建议在服务端环境变量中保存 API Key，避免在前端或公开仓库中暴露。

export API_KEY="your-api-key"

获取 BTC 与 ETH 最新 USD 报价

curl -H "X-API-Key: $API_KEY" "https://api.gelabs.org/price/api/v1/quotes/latest?ids=1,1027"

切换目标法币

通过 fiat 参数可以指定报价法币，例如查询 CNY 报价：

curl -H "X-API-Key: $API_KEY" "https://api.gelabs.org/price/api/v1/quotes/latest?ids=1,1027&fiat=CNY"

后续接入

• 已知系统内部代币 ID 时，优先使用 GET /price/api/v1/quotes/latest。
• 已知链和合约地址时，使用 GET /price/api/v1/quotes/contract-addresses。
• 需要资产列表、法币列表或 DEX 池信息时，继续查看 接口详情。