CoinGlass API 的數據有兩種查詢方式:按幣種查詢全市場聚合數據,或按某個交易所的某個交易對查詢明細數據。本頁說明兩者的區別、參數寫法,以及如何獲取支援的交易所和交易對列表。
| 項目 | 內容 |
|---|---|
| 幣種聚合 | symbol=BTC,返回該幣種跨交易所的合計數據;部分接口用 exchange_list 指定參與聚合的交易所 |
| 交易對 | exchange=Binance&symbol=BTCUSDT,返回單個交易所單個交易對的數據 |
| 覆蓋交易所 | 合約 30 家、現貨 11 家、期權 4 家 |
| 名稱寫法 | 以「支援的交易所和交易對」接口返回的寫法為準 |
兩種查詢方式
| 查詢方式 | 用途 | 說明 |
|---|---|---|
| 幣種聚合 | 一個幣在所有交易所的合計 | 適合看全市場:比特幣總持倉、全網爆倉金額。 參數範例: symbol=BTC接口範例:聚合持倉歷史(K 線)、幣種爆倉歷史 |
| 交易對 | 某個交易所的某個合約 | 適合看單一市場:Binance 上 BTCUSDT 永續合約的資金費率。 參數範例: exchange=Binance、symbol=BTCUSDT接口範例:持倉歷史(K 線)、資金費率歷史(K 線) |
怎麼判斷一個接口屬於哪種查詢方式?看它的參數:
- 幣種聚合:
symbol填幣種,例如BTC。部分接口還要用exchange_list指定參與彙總的交易所,例如Binance,OKX,Bybit,如幣種爆倉歷史。 - 交易對:同時要傳
exchange和交易對形式的symbol,例如exchange=Binance、symbol=BTCUSDT。
接口名稱裡常帶「聚合」「幣種」或「交易對」,也可以作為參考。各接口的必填參數以接口頁為準。
名稱請原樣傳入各交易所的交易對命名規則不同。交易所名稱和交易對名稱都請按「支援的交易所和交易對」接口返回的寫法原樣傳入。
支援的交易所
下表為當前覆蓋的交易所,會隨市場變化調整,程式中請以接口即時返回為準。
| 市場 | 數量 | 交易所 |
|---|---|---|
| 合約 | 30 | Binance、OKX、Bybit、CME、Bitget、Deribit、BitMEX、Bitfinex、Gate、Kraken、KuCoin、dYdX、CoinEx、BingX、Coinbase、Crypto.com、Hyperliquid、Bitunix、MEXC、HTX、WhiteBIT、Aster、Lighter、EdgeX、Drift、Paradex、Extended、ApeX Omni、LBank、tradeXYZ |
| 現貨 | 11 | Binance、OKX、Bybit、Coinbase、Bitfinex、Kraken、Gate、Bitget、Bitstamp、Crypto.com、Upbit |
| 期權 | 4 | Deribit、Binance、OKX、Bybit |
用接口獲取最新列表
| 接口 | 返回內容 | 建議刷新頻率 |
|---|---|---|
| 支援的幣種 | 所有可查詢的合約幣種 | 每天 |
| 支援的交易所 | 所有合約交易所 | 每天 |
| 支援的交易所和交易對 | 每個交易所的交易對名稱 | 每小時 |
| 下架的交易所和交易對 | 已下架、不再更新的交易對 | 每天 |
把這些列表快取在服務端,按上表頻率刷新即可,不需要每次請求前都重新獲取。
curl --request GET \
--url 'https://open-api-v4.coinglass.com/api/futures/supported-exchange-pairs' \
--header 'CG-API-KEY: YOUR_API_KEY'import os
import requests
resp = requests.get(
"https://open-api-v4.coinglass.com/api/futures/supported-exchange-pairs",
headers={"CG-API-KEY": os.environ["COINGLASS_API_KEY"]},
timeout=10,
)
print(resp.json())常見問題
幣種聚合數據包含哪些交易所?
帶 exchange_list 參數的聚合接口,只彙總你指定的交易所;沒有這個參數的,彙總本接口已接入、且有數據的市場。兩種情況下,沒有對應交易對或沒有數據的交易所都不計入,所以結果不一定包含所有交易所的全部市場。exchange_list 中寫錯或不支援的交易所名稱會被忽略,不一定報錯,請先用「支援的交易所和交易對」核對名稱。
持倉數據可以分別用「聚合穩定幣保證金持倉」和「聚合幣本位保證金持倉」查看 U 本位和幣本位。支援的交易所和交易對:合約可透過「支援的交易所和交易對」接口獲取支援的交易所和交易對列表,現貨可透過「現貨支援的交易所和交易對」接口獲取。
查詢交易對時返回空數據怎麼辦?
先用「支援的交易所和交易對」確認交易所和交易對的名稱寫法,再檢查該交易對是否在「下架的交易所和交易對」列表中。部分交易對尚未接入時也會返回空陣列,例如 Binance 現貨 BTCUSD。
按交易所獲取加密貨幣合約數據
Binance、OKX、Bybit 合約數據
在交易對類接口中傳入 exchange=Binance 和對應的交易對,即可查詢該交易所的持倉量、資金費率、多空比和爆倉數據;不區分交易所時,使用幣種聚合接口。
Hyperliquid 與去中心化永續合約數據
除中心化交易所外,還覆蓋 Hyperliquid、dYdX、Aster、Lighter、Drift、Paradex 等鏈上永續合約平台。Hyperliquid 另有巨鯨提醒、錢包盈虧分佈等專屬接口。
CME 比特幣期貨與加密期權數據
合約數據包含 CME 比特幣期貨;期權數據覆蓋 Deribit、Binance、OKX、Bybit,可用於對比傳統金融市場與加密原生市場的持倉變化,例如期權最大痛點。
相關文件
- 時間週期與 interval:K 線週期 interval 的取值
- 聚合持倉歷史(K 線):全市場持倉量 API
- 資金費率套利:跨交易所資金費率對比
- 錯誤碼與頻率限制:返回碼與限流說明
