幣價 · 接口

前綴：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 都要處理。