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。
• 已知系統內部代幣 ID 且需要基礎詳情時，使用 POST /price/api/v1/tokens/details。
• 已知鏈和合約地址時，使用 GET /price/api/v1/quotes/contract-addresses。
• 需要資產列表、法幣列表或 DEX 池資訊時，繼續查看 介面詳情。