跳至主要内容

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，用於介面鑑權和計費。

部分介面還會返回快取控制回應頭，具體見各介面說明。