交易所與交易對

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。

接口名稱裡常帶「聚合」「幣種」或「交易對」,也可以作為參考。各接口的必填參數以接口頁為準。

📘

名稱請原樣傳入

各交易所的交易對命名規則不同。交易所名稱和交易對名稱都請按「支援的交易所和交易對」接口返回的寫法原樣傳入。

支援的交易所

下表為當前覆蓋的交易所,會隨市場變化調整,程式中請以接口即時返回為準。

市場數量交易所
合約30Binance、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
現貨11Binance、OKX、Bybit、Coinbase、Bitfinex、Kraken、Gate、Bitget、Bitstamp、Crypto.com、Upbit
期權4Deribit、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,可用於對比傳統金融市場與加密原生市場的持倉變化,例如期權最大痛點。

相關文件