交易所与交易对

本页要点

项目	内容
币种聚合	`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，可用于对比传统金融市场与加密原生市场的持仓变化，例如期权最大痛点。

交易所与交易对

两种查询方式

名称请原样传入

支持的交易所

用接口获取最新列表

常见问题

按交易所获取加密货币合约数据

Binance、OKX、Bybit 合约数据

Hyperliquid 与去中心化永续合约数据

CME 比特币期货与加密期权数据

相关文档

What’s Next

What’s Next