rest-api_CN.md

# CoinGlass Rest API 列表

## 合约 - 交易市场

| 名称         | github链接                                                         | 文档链接                                                                         |
| ---------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| 支持的币种      | [Link](./rest_CN/futu/trading-market/coins.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/coins)                   |
| 支持的交易所     | [Link](./rest_CN/futu/trading-market/supported-exchanges.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/supported-exchanges)     |
| 支持的交易所和交易对 | [Link](./rest_CN/futu/trading-market/instruments.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/instruments)             |
| 币种市场列表     | [Link](./rest_CN/futu/trading-market/coins-markets.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/coins-markets)           |
| 交易对市场列表    | [Link](./rest_CN/futu/trading-market/pairs-markets.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/pairs-markets)           |
| 币种涨跌幅      | [Link](./rest_CN/futu/trading-market/coins-price-change.md)      | [Link](https://docs.coinglass.com/v4.0-zh/reference/coins-price-change)      |
| 交易对K线历史    | [Link](./rest_CN/futu/trading-market/price-ohlc-history.md)      | [Link](https://docs.coinglass.com/v4.0-zh/reference/price-ohlc-history)      |
| 下架的交易所和交易对 | [Link](./rest_CN/futu/trading-market/delisted-exchange-pairs.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/delisted-exchange-pairs) |
| 交易所列表      | [Link](./rest_CN/futu/trading-market/exchange-rank.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-rank)           |

## 合约 - 持仓

| 名称             | github链接                                                                             | 文档链接                                                                                              |
| -------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| 持仓历史(K线)       | [Link](./rest_CN/futu/open-interest/oi-ohlc-histroy.md)                              | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-ohlc-histroy)                              |
| 聚合持仓历史(K线)     | [Link](./rest_CN/futu/open-interest/oi-ohlc-aggregated-history.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-ohlc-aggregated-history)                   |
| 聚合稳定币保证金持仓(K线) | [Link](./rest_CN/futu/open-interest/oi-ohlc-aggregated-stablecoin-margin-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-ohlc-aggregated-stablecoin-margin-history) |
| 聚合币本位保证金持仓(K线) | [Link](./rest_CN/futu/open-interest/oi-ohlc-aggregated-coin-margin-history.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-ohlc-aggregated-coin-margin-history)       |
| 币种交易所持仓        | [Link](./rest_CN/futu/open-interest/oi-exchange-list.md)                             | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-exchange-list)                             |
| 币种交易所持仓历史      | [Link](./rest_CN/futu/open-interest/oi-exchange-history-chart.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-exchange-history-chart)                    |

## 合约 - 资金费率

| 名称              | github链接                                                        | 文档链接                                                                          |
| --------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| 资金费率历史(K线)      | [Link](./rest_CN/futu/funding-rate/fr-ohlc-histroy.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/fr-ohlc-histroy)          |
| 持仓加权资金费率历史(K线)  | [Link](./rest_CN/futu/funding-rate/oi-weight-ohlc-history.md)   | [Link](https://docs.coinglass.com/v4.0-zh/reference/oi-weight-ohlc-history)   |
| 成交量加权资金费率历史(K线) | [Link](./rest_CN/futu/funding-rate/vol-weight-ohlc-history.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/vol-weight-ohlc-history)  |
| 币种资金费率-交易所列表    | [Link](./rest_CN/futu/funding-rate/fr-exchange-list.md)         | [Link](https://docs.coinglass.com/v4.0-zh/reference/fr-exchange-list)         |
| 累计资金费率-交易所列表    | [Link](./rest_CN/futu/funding-rate/cumulative-exchange-list.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/cumulative-exchange-list) |
| 资金费率套利          | [Link](./rest_CN/futu/funding-rate/fr-arbitrage.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/fr-arbitrage)             |

## 合约 - 多空比

| 名称         | github链接                                                                      | 文档链接                                                                                    |
| ---------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| 交易对账户多空比历史 | [Link](./rest_CN/futu/long-short-ratio/global-longshort-account-ratio.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/global-longshort-account-ratio)     |
| 大户账户数多空比历史 | [Link](./rest_CN/futu/long-short-ratio/top-longshort-account-ratio.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/top-longshort-account-ratio)        |
| 大户持仓多空比历史  | [Link](./rest_CN/futu/long-short-ratio/top-longshort-position-ratio.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/top-longshort-position-ratio)       |
| 币种主动买卖比    | [Link](./rest_CN/futu/long-short-ratio/taker-buysell-volume-exchange-list.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/taker-buysell-volume-exchange-list) |
| 净持仓        | [Link](./rest_CN/futu/long-short-ratio/净持仓.md)                                | [Link](https://docs.coinglass.com/v4.0-zh/reference/净持仓)                                |
| 净持仓(v2)    | [Link](./rest_CN/futu/long-short-ratio/净持仓v2.md)                              | [Link](https://docs.coinglass.com/v4.0-zh/reference/净持仓v2)                              |

## 合约 - 爆仓与清算

| 名称            | github链接                                                                    | 文档链接                                                                                       |
| ------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| 交易对爆仓历史       | [Link](./rest_CN/futu/liquidation/liquidation-history.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-history)                   |
| 币种爆仓历史        | [Link](./rest_CN/futu/liquidation/aggregated-liquidation-history.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/aggregated-liquidation-history)        |
| 交易所币种爆仓列表     | [Link](./rest_CN/futu/liquidation/liquidation-coin-list.md)                 | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-coin-list)                 |
| 币种交易所爆仓列表     | [Link](./rest_CN/futu/liquidation/liquidation-exchange-list.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-exchange-list)             |
| 爆仓订单          | [Link](./rest_CN/futu/liquidation/liquidation-order.md)                     | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-order)                     |
| 交易对清算热力图(模型1) | [Link](./rest_CN/futu/liquidation/liquidation-heatmap.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-heatmap)                   |
| 交易对清算热力图(模型2) | [Link](./rest_CN/futu/liquidation/liquidation-heatmap-model2.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-heatmap-model2)            |
| 交易对清算热力图(模型3) | [Link](./rest_CN/futu/liquidation/liquidation-heatmap-model3.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-heatmap-model3)            |
| 币种清算热力图(模型1)  | [Link](./rest_CN/futu/liquidation/liquidation-aggregate-heatmap.md)         | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-aggregate-heatmap)         |
| 币种清算热力图(模型2)  | [Link](./rest_CN/futu/liquidation/liquidation-aggregate-heatmap-model2.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-aggregate-heatmap-model2)  |
| 币种清算热力图(模型3)  | [Link](./rest_CN/futu/liquidation/liquidation-aggregated-heatmap-model3.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-aggregated-heatmap-model3) |
| 交易对清算地图       | [Link](./rest_CN/futu/liquidation/liquidation-map.md)                       | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-map)                       |
| 币种清算地图        | [Link](./rest_CN/futu/liquidation/liquidation-aggregated-map.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-aggregated-map)            |
| 清算最大痛点        | [Link](./rest_CN/futu/liquidation/liquidation-max-pain.md)                  | [Link](https://docs.coinglass.com/v4.0-zh/reference/liquidation-max-pain)                  |

## 合约 - 订单薄

| 名称              | github链接                                                                  | 文档链接                                                                                      |
| --------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 交易对挂单深度历史(±范围)  | [Link](./rest_CN/futu/order-book/futures-orderbook-history.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-orderbook-history)            |
| 币种聚合挂单深度历史(±范围) | [Link](./rest_CN/futu/order-book/futures-aggregated-orderbook-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-aggregated-orderbook-history) |
| 订单薄历史(热力图)      | [Link](./rest_CN/futu/order-book/orderbook-heatmap.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/orderbook-heatmap)                    |
| 大额订单薄           | [Link](./rest_CN/futu/order-book/large-orderbook.md)                      | [Link](https://docs.coinglass.com/v4.0-zh/reference/large-orderbook)                      |
| 大额订单薄历史         | [Link](./rest_CN/futu/order-book/large-orderbook-history.md)              | [Link](https://docs.coinglass.com/v4.0-zh/reference/large-orderbook-history)              |

## 合约 - Hyperliquid 仓位

| 名称               | github链接                                                             | 文档链接                                                                            |
| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Hyperliquid 鲸鱼提醒 | [Link](./rest_CN/futu/whale-positions/hyperliquid-whale-alert.md)    | [Link](https://docs.coinglass.com/v4.0-zh/reference/hyperliquid-whale-alert)    |
| Hyperliquid 鲸鱼持仓 | [Link](./rest_CN/futu/whale-positions/hyperliquid-whale-position.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/hyperliquid-whale-position) |
| Hyperliquid 仓位   | [Link](./rest_CN/futu/whale-positions/hyperliquid-position.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/hyperliquid-position)       |
| Hyperliquid 用户仓位 | [Link](./rest_CN/futu/whale-positions/hyperliquid-user-position.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/hyperliquid-user-position)  |

## 合约 - 主动买卖

| 名称             | github链接                                                                          | 文档链接                                                                                         |
| -------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| 交易对主动买卖历史      | [Link](./rest_CN/futu/trading-history/taker-buysell-volume.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/taker-buysell-volume)                    |
| 币种主动买卖历史       | [Link](./rest_CN/futu/trading-history/aggregated-taker-buysell-volume-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/aggregated-taker-buysell-volume-history) |
| 足迹图历史(90天)     | [Link](./rest_CN/futu/trading-history/futures-footprint-history.md)               | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-footprint-history)               |
| 累计成交量差值（CVD）   | [Link](./rest_CN/futu/trading-history/futures-cvd-history.md)                     | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-cvd-history)                     |
| 聚合累计成交量差值（CVD） | [Link](./rest_CN/futu/trading-history/futures-aggregated-cvd-history.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-aggregated-cvd-history)          |

## 现货 - 交易市场

| 名称          | github链接                                                                 | 文档链接                                                                              |
| ----------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| 支持的币种       | [Link](./rest_CN/spots/trading-market-1/spot-supported-coins.md)         | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-supported-coins)         |
| 支持的交易所和交易对  | [Link](./rest_CN/spots/trading-market-1/spot-suported-exchange-pairs.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-suported-exchange-pairs) |
| 币种市场列表      | [Link](./rest_CN/spots/trading-market-1/spot-coins-markets.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-coins-markets)           |
| 交易对市场列表     | [Link](./rest_CN/spots/trading-market-1/spot-pairs-markets.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-pairs-markets)           |
| 交易对价格历史(K线) | [Link](./rest_CN/spots/trading-market-1/price-history-1.md)              | [Link](https://docs.coinglass.com/v4.0-zh/reference/price-history-1)              |

## 现货 - 订单薄

| 名称              | github链接                                                          | 文档链接                                                                           |
| --------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| 交易对挂单深度历史(±范围)  | [Link](./rest_CN/spots/order-book-1/spot-orderbook-history.md)    | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-orderbook-history)    |
| 币种聚合挂单深度历史(±范围) | [Link](./rest_CN/spots/order-book-1/spot-aggregated-history.md)   | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-aggregated-history)   |
| 订单薄历史(热力图)      | [Link](./rest_CN/spots/order-book-1/orderbook-history-1.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/orderbook-history-1)       |
| 大额订单薄           | [Link](./rest_CN/spots/order-book-1/large-limit-order-1.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/large-limit-order-1)       |
| 大额订单薄历史         | [Link](./rest_CN/spots/order-book-1/large-orderbook-history-1.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/large-orderbook-history-1) |

## 现货 - 主动买卖

| 名称             | github链接                                                                       | 文档链接                                                                                       |
| -------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| 交易对主动买卖历史      | [Link](./rest_CN/spots/taker-buysell/spot-taker-buysell-ratio-history.md)      | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-taker-buysell-ratio-history)      |
| 币种主动买卖历史       | [Link](./rest_CN/spots/taker-buysell/spot-aggregated-taker-buysell-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-aggregated-taker-buysell-history) |
| 足迹图历史          | [Link](./rest_CN/spots/taker-buysell/足迹图历史-1.md)                               | [Link](https://docs.coinglass.com/v4.0-zh/reference/足迹图历史-1)                               |
| 累计成交量差值（CVD）   | [Link](./rest_CN/spots/taker-buysell/spot-cvd-history.md)                      | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-cvd-history)                      |
| 聚合累计成交量差值（CVD） | [Link](./rest_CN/spots/taker-buysell/spot-aggregated-cvd-history.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/spot-aggregated-cvd-history)           |

## 期权

| 名称       | github链接                                                    | 文档链接                                                                                |
| -------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| 期权最大痛点   | [Link](./rest_CN/options/option-max-pain.md)                | [Link](https://docs.coinglass.com/v4.0-zh/reference/option-max-pain)                |
| 期权相关数据   | [Link](./rest_CN/options/info.md)                           | [Link](https://docs.coinglass.com/v4.0-zh/reference/info)                           |
| 交易所持仓历史  | [Link](./rest_CN/options/exchange-open-interest-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-open-interest-history) |
| 交易所成交量历史 | [Link](./rest_CN/options/exchange-volume-history.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-volume-history)        |

## 链上 - 交易所数据

| 名称       | github链接                                                           | 文档链接                                                                        |
| -------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| 交易所资产透明度 | [Link](./rest_CN/on-chain/exchange-data/exchange-assets.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-assets)        |
| 交易所余额列表  | [Link](./rest_CN/on-chain/exchange-data/exchange-balance-list.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-balance-list)  |
| 交易所余额图表  | [Link](./rest_CN/on-chain/exchange-data/exchange-balance-chart.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-balance-chart) |

## 链上 - 链上转账

| 名称              | github链接                                                              | 文档链接                                                                            |
| --------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| 交易所链上转账（ERC-20） | [Link](./rest_CN/on-chain/transactions/exchange-onchain-transfers.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange-onchain-transfers) |
| 大额转账            | [Link](./rest_CN/on-chain/transactions/whale-transfer.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/whale-transfer)             |

## 链上 - 代币

| 名称     | github链接                                             | 文档链接                                                                  |
| ------ | ---------------------------------------------------- | --------------------------------------------------------------------- |
| 代币解锁列表 | [Link](./rest_CN/on-chain/token/coin-unlock-list.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/coin-unlock-list) |
| 代币解锁详情 | [Link](./rest_CN/on-chain/token/coin-vesting.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/coin-vesting)     |

## ETF - 比特币 ETF

| 名称          | github链接                                                                  | 文档链接                                                                                      |
| ----------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 比特币ETF列表    | [Link](./rest_CN/etf/bitcoin-etf/bitcoin-etfs.md)                         | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-etfs)                         |
| 香港ETF流入流出历史 | [Link](./rest_CN/etf/bitcoin-etf/hong-kong-bitcoin-etf-flow-history.md)   | [Link](https://docs.coinglass.com/v4.0-zh/reference/hong-kong-bitcoin-etf-flow-history)   |
| ETF净资产历史    | [Link](./rest_CN/etf/bitcoin-etf/bitcoin-etf-netassets-history.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-etf-netassets-history)        |
| ETF流入流出历史   | [Link](./rest_CN/etf/bitcoin-etf/etf-flows-history.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/etf-flows-history)                    |
| ETF溢价/折扣历史  | [Link](./rest_CN/etf/bitcoin-etf/bitcoin-etf-premium-discount-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-etf-premium-discount-history) |
| 比特币ETF历史    | [Link](./rest_CN/etf/bitcoin-etf/etf-history.md)                          | [Link](https://docs.coinglass.com/v4.0-zh/reference/etf-history)                          |
| ETF价格历史     | [Link](./rest_CN/etf/bitcoin-etf/etf-price-ohlc-history.md)               | [Link](https://docs.coinglass.com/v4.0-zh/reference/etf-price-ohlc-history)               |
| 比特币ETF详情    | [Link](./rest_CN/etf/bitcoin-etf/etf-detail.md)                           | [Link](https://docs.coinglass.com/v4.0-zh/reference/etf-detail)                           |
| ETF资产管理规模   | [Link](./rest_CN/etf/bitcoin-etf/etf-spot-net-inflow.md)                  | [Link](https://docs.coinglass.com/v4.0-zh/reference/etf-spot-net-inflow)                  |

## ETF - 以太坊 ETF

| 名称           | github链接                                                        | 文档链接                                                                                |
| ------------ | --------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| 以太坊ETF净资产历史  | [Link](./rest_CN/etf/eth-etf/ethereum-etf-netassets-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/ethereum-etf-netassets-history) |
| 以太坊ETF列表     | [Link](./rest_CN/etf/eth-etf/ethereum-etf-list.md)              | [Link](https://docs.coinglass.com/v4.0-zh/reference/ethereum-etf-list)              |
| 以太坊ETF流入流出历史 | [Link](./rest_CN/etf/eth-etf/ethereum-etf-flows-history.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/ethereum-etf-flows-history)     |

## ETF - 灰度基金

| 名称     | github链接                                                     | 文档链接                                                                           |
| ------ | ------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| 灰度持仓列表 | [Link](./rest_CN/etf/grayscale/grayscale-holding-list.md)    | [Link](https://docs.coinglass.com/v4.0-zh/reference/grayscale-holding-list)    |
| 灰度溢价历史 | [Link](./rest_CN/etf/grayscale/grayscale-premium-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/grayscale-premium-history) |

## ETF - 索拉纳 ETF

| 名称           | github链接                                                  | 文档链接                                                                          |
| ------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------- |
| 索拉纳ETF流入流出历史 | [Link](./rest_CN/etf/索拉纳-etf/solana-etf-flows-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/solana-etf-flows-history) |

## ETF - XRP ETF

| 名称            | github链接                                                       | 文档链接                                                                       |
| ------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------- |
| XRP ETF流入流出历史 | [Link](./rest_CN/etf/copy-of-索拉纳-etf/xrp-etf-flows-history.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/xrp-etf-flows-history) |

## 指标 - 合约指标

| 名称                | github链接                                                     | 文档链接                                                                         |
| ----------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------- |
| 币种RSI列表           | [Link](./rest_CN/indic/futures-1/futures-rsi-list.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-rsi-list)        |
| 交易对RSI            | [Link](./rest_CN/indic/futures-1/futures-indicators-rsi.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-indicators-rsi)  |
| 移动平均线 (MA)        | [Link](./rest_CN/indic/futures-1/futures-indicators-ma.md)   | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-indicators-ma)   |
| 指数移动平均线 (EMA)     | [Link](./rest_CN/indic/futures-1/futures-indicators-ema.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-indicators-ema)  |
| 布林带指标 (BOLL)      | [Link](./rest_CN/indic/futures-1/futures-indicators-boll.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-indicators-boll) |
| 移动平均收敛发散指标 (MACD) | [Link](./rest_CN/indic/futures-1/futures-indicators-macd.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/futures-indicators-macd) |
| 合约基差              | [Link](./rest_CN/indic/futures-1/basis.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/basis)                   |
| 鲸鱼指数              | [Link](./rest_CN/indic/futures-1/鲸鱼指数.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/鲸鱼指数)                    |
| CGDI 指数           | [Link](./rest_CN/indic/futures-1/cgdi-指数.md)                 | [Link](https://docs.coinglass.com/v4.0-zh/reference/cgdi-指数)                 |
| CDRI 指数           | [Link](./rest_CN/indic/futures-1/cdri-index.md)              | [Link](https://docs.coinglass.com/v4.0-zh/reference/cdri-index)              |

## 指标 - 现货

| 名称             | github链接                                                      | 文档链接                                                                            |
| -------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Coinbase溢价指数   | [Link](./rest_CN/indic/spots-1/coinbase-premium-index.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/coinbase-premium-index)     |
| Bitfinex杠杆多空仓位 | [Link](./rest_CN/indic/spots-1/bitfinex-margin-long-short.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitfinex-margin-long-short) |
| 借贷利率           | [Link](./rest_CN/indic/spots-1/borrow-interest-rate.md)       | [Link](https://docs.coinglass.com/v4.0-zh/reference/borrow-interest-rate)       |

## 指标 - 其他指标

| 名称                  | github链接                                                             | 文档链接                                                                                     |
| ------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| 比特币Ahr999指标         | [Link](./rest_CN/indic/other/ahr999.md)                              | [Link](https://docs.coinglass.com/v4.0-zh/reference/ahr999)                              |
| 普尔倍数                | [Link](./rest_CN/indic/other/puell-multiple.md)                      | [Link](https://docs.coinglass.com/v4.0-zh/reference/puell-multiple)                      |
| 比特币流通量与年产量          | [Link](./rest_CN/indic/other/stock-flow.md)                          | [Link](https://docs.coinglass.com/v4.0-zh/reference/stock-flow)                          |
| Pi循环顶部指示器           | [Link](./rest_CN/indic/other/pi.md)                                  | [Link](https://docs.coinglass.com/v4.0-zh/reference/pi)                                  |
| 比特币黄金比例乘数           | [Link](./rest_CN/indic/other/golden-ratio-multiplier.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/golden-ratio-multiplier)             |
| 比特币盈利日期             | [Link](./rest_CN/indic/other/bitcoin-profitable-days.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-profitable-days)             |
| 比特币彩虹图              | [Link](./rest_CN/indic/other/bitcoin-rainbow-chart.md)               | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-rainbow-chart)               |
| 恐惧与贪婪指数             | [Link](./rest_CN/indic/other/cryptofear-greedindex.md)               | [Link](https://docs.coinglass.com/v4.0-zh/reference/cryptofear-greedindex)               |
| 稳定币市值历史             | [Link](./rest_CN/indic/other/stablecoin-marketcap-history.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/stablecoin-marketcap-history)        |
| 比特币泡沫指数             | [Link](./rest_CN/indic/other/bitcoin-bubble-index.md)                | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-bubble-index)                |
| 牛市逃顶信号清单            | [Link](./rest_CN/indic/other/bull-market-peak-indicator.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/bull-market-peak-indicator)          |
| 两年MA乘数指标            | [Link](./rest_CN/indic/other/tow-year-ma-multiplier.md)              | [Link](https://docs.coinglass.com/v4.0-zh/reference/tow-year-ma-multiplier)              |
| 200周移动平均热力图         | [Link](./rest_CN/indic/other/tow-hundred-week-moving-avg-heatmap.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/tow-hundred-week-moving-avg-heatmap) |
| 山寨币季节指数             | [Link](./rest_CN/indic/other/altcoin-season.md)                      | [Link](https://docs.coinglass.com/v4.0-zh/reference/altcoin-season)                      |
| 比特币短期持有者已实现利润率      | [Link](./rest_CN/indic/other/bitcoin-sth-sopr.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-sth-sopr)                    |
| 比特币长期持有者已实现利润率      | [Link](./rest_CN/indic/other/bitcoin-lth-sopr.md)                    | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-lth-sopr)                    |
| 比特币短期持有者平均持仓成本      | [Link](./rest_CN/indic/other/bitcoin-sth-realized-price.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-sth-realized-price)          |
| 比特币长期持有者平均持仓成本      | [Link](./rest_CN/indic/other/bitcoin-lth-realized-price.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-lth-realized-price)          |
| 短期持有者持有比特币数量        | [Link](./rest_CN/indic/other/bitcoin-short-term-holder-supply.md)    | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-short-term-holder-supply)    |
| 长期持有者持有比特币数量        | [Link](./rest_CN/indic/other/bitcoin-long-term-holder-supply.md)     | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-long-term-holder-supply)     |
| 比特币 RHODL 比值        | [Link](./rest_CN/indic/other/bitcoin-rhodl-ratio.md)                 | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-rhodl-ratio)                 |
| 比特币新地址              | [Link](./rest_CN/indic/other/bitcoin-new-addresses.md)               | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-new-addresses)               |
| 比特币活跃地址             | [Link](./rest_CN/indic/other/bitcoin-active-addresses.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-active-addresses)            |
| 比特币储备风险             | [Link](./rest_CN/indic/other/bitcoin-reserve-risk.md)                | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-reserve-risk)                |
| 比特币未实现净盈亏 (NUPL)    | [Link](./rest_CN/indic/other/bitcoin-net-unrealized-profit-loss.md)  | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-net-unrealized-profit-loss)  |
| 比特币相关性              | [Link](./rest_CN/indic/other/bitcoin-correlation.md)                 | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-correlation)                 |
| 比特币宏观震荡指标(BMO)      | [Link](./rest_CN/indic/other/bitcoin-macro-oscillator.md)            | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-macro-oscillator)            |
| 期权持仓 vs 合约持仓        | [Link](./rest_CN/indic/other/option-vs-futures-oi-ratio.md)          | [Link](https://docs.coinglass.com/v4.0-zh/reference/option-vs-futures-oi-ratio)          |
| 比特币 vs 全球 M2 货币供应增长 | [Link](./rest_CN/indic/other/bitcoin-vs-global-m2-growth.md)         | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-vs-global-m2-growth)         |
| 比特币 vs 美国 M2 货币供应增长 | [Link](./rest_CN/indic/other/bitcoin-vs-us-m2-growth.md)             | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-vs-us-m2-growth)             |
| 比特币市值占比             | [Link](./rest_CN/indic/other/bitcoin-dominance.md)                   | [Link](https://docs.coinglass.com/v4.0-zh/reference/bitcoin-dominance)                   |
| 交易所资产透明度证明          | [Link](./rest_CN/indic/other/exchange_assets_transparency.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/exchange_assets_transparency)        |

## 其他 - 财经日历

| 名称   | github链接                                             | 文档链接                                                                         |
| ---- | ---------------------------------------------------- | ---------------------------------------------------------------------------- |
| 经济数据 | [Link](./rest_CN/其他/财经日历/economic-data.md)           | [Link](https://docs.coinglass.com/v4.0-zh/reference/economic-data)           |
| 财经事件 | [Link](./rest_CN/其他/财经日历/financial-events.md)        | [Link](https://docs.coinglass.com/v4.0-zh/reference/financial-events)        |
| 央行动态 | [Link](./rest_CN/其他/财经日历/central-bank-activities.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/central-bank-activities) |

## 其他 - 新闻、快讯

| 名称 | github链接                                  | 文档链接                                                                |
| -- | ----------------------------------------- | ------------------------------------------------------------------- |
| 新闻 | [Link](./rest_CN/其他/新闻/article-list.md)   | [Link](https://docs.coinglass.com/v4.0-zh/reference/article-list)   |
| 快讯 | [Link](./rest_CN/其他/新闻/newsflash-list.md) | [Link](https://docs.coinglass.com/v4.0-zh/reference/newsflash-list) |

# CoinGlass Rest API接口
# 合约 - 交易市场 - 支持的币种


```
GET /api/futures/supported-coins
```


该接口用于查询 CoinGlass 支持的所有合约币种。

***缓存 / 更新频率:*** 每 1 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
      "BTC",
      "ETH",
      "SOL",
      "XRP",
      ...
  ]
}
```


# 合约 - 交易市场 - 支持的交易所


```
GET /api/futures/supported-exchanges
```


该接口用于查询 CoinGlass 支持的所有合约交易所。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    "OKX",
    "Binance",
    "HTX",
    "Bitmex",
    "Bitfinex",
    "Bybit",
    "Deribit",
    "Gate",
    "Kraken",
    "KuCoin",
    "CME",
    "Bitget",
    "dYdX",
    "CoinEx",
    "BingX",
    "Coinbase",
    "Gemini",
    "Crypto.com",
    "Hyperliquid",
    "Bitunix",
    "MEXC",
    "WhiteBIT",
    "Aster",
    "Lighter",
    "EdgeX",
    "Drift",
    "Paradex",
    "Extended",
    "ApeX Omni"
  ]
}
```


# 合约 - 交易市场 - 支持的交易所和交易对


```
GET /api/futures/supported-exchange-pairs
```


该接口允许你查询 CoinGlass 上支持的所有合约交易所及其对应的交易对。

***缓存 / 更新频率:*** 每 1 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "Binance": [ // 交易所名称
      {
        "instrument_id": "BTCUSD_PERP",// 合约交易对
        "base_asset": "BTC",// 基础币种
        "quote_asset": "USD"// 计价币种
      },
      {
        "instrument_id": "BTCUSD_250627",
        "base_asset": "BTC",
        "quote_asset": "USD"
      },
      ....
      ],
    "Bitget": [
      {
        "instrument_id": "BTCUSDT_UMCBL",
        "base_asset": "BTC",
        "quote_asset": "USDT"
      },
      {
        "instrument_id": "ETHUSDT_UMCBL",
        "base_asset": "ETH",
        "quote_asset": "USDT"
      },
      ...
      ]
      ...
   }
}
```

 **Parameters:**
| 名称       | 类型     | 必填 | 描述                 |
| -------- | ------ | -- | ------------------ |
| exchange | string | NO | 筛选结果，仅返回指定交易所的交易对。 |


# 合约 - 交易市场 - 币种市场列表


```
GET /api/futures/coins-markets
```


该接口提供合约币种的相关指标信息。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",  
  "msg": "success",  
  "data": [
    {
      "symbol": "BTC",  // 币种符号
      "current_price": 84773.6,  // 当前价格（单位：USD）
      "avg_funding_rate_by_oi": 0.00196,  // 按持仓量加权的平均资金费率
      "avg_funding_rate_by_vol": 0.002647,  // 按成交量加权的平均资金费率
      "market_cap_usd": 1683310500117.051,  // 市值（单位：USD）
      "open_interest_market_cap_ratio": 0.0327,  // 未平仓量与市值的比值
      "open_interest_usd": 55002072334.9376,  // 未平仓量（单位：USD）
      "open_interest_quantity": 648525.0328,  // 未平仓合约数量
      "open_interest_volume_ratio": 0.7936,  // 未平仓量与成交量的比值
      "price_change_percent_5m": -0.02,  // 价格5分钟变化百分比
      "price_change_percent_15m": 0.06,  // 价格15分钟变化百分比
      "price_change_percent_30m": 0.03,  // 价格30分钟变化百分比
      "price_change_percent_1h": -0.1,  // 价格1小时变化百分比
      "price_change_percent_4h": -0.15,  // 价格4小时变化百分比
      "price_change_percent_12h": 0.15,  // 价格12小时变化百分比
      "price_change_percent_24h": 1.06,  // 价格24小时变化百分比
      "open_interest_change_percent_5m": 0,  // 未平仓量5分钟变化百分比
      "open_interest_change_percent_15m": 0.04,  // 未平仓量15分钟变化百分比
      "open_interest_change_percent_30m": 0,  // 未平仓量30分钟变化百分比
      "open_interest_change_percent_1h": -0.01,  // 未平仓量1小时变化百分比
      "open_interest_change_percent_4h": 0.17,  // 未平仓量4小时变化百分比
      "open_interest_change_percent_24h": 4.58,  // 未平仓量24小时变化百分比
      "volume_change_percent_5m": -0.03,  // 成交量5分钟变化百分比
      "volume_change_percent_15m": -0.73,  // 成交量15分钟变化百分比
      "volume_change_percent_30m": -1.13,  // 成交量30分钟变化百分比
      "volume_change_percent_1h": -2.33,  // 成交量1小时变化百分比
      "volume_change_percent_4h": -5.83,  // 成交量4小时变化百分比
      "volume_change_percent_24h": -26.38,  // 成交量24小时变化百分比
      "volume_change_usd_1h": 69310404660.3795,  // 成交量1小时变化（单位：USD）
      "volume_change_usd_4h": -4290959532.4414644,  // 成交量4小时变化（单位：USD）
      "volume_change_usd_24h": -24835757605.82467,  // 成交量24小时变化（单位：USD）
      "long_short_ratio_5m": 1.2523,  // 多空比（近5分钟）
      "long_short_ratio_15m": 0.9928,  // 多空比（近15分钟）
      "long_short_ratio_30m": 1.0695,  // 多空比（近30分钟）
      "long_short_ratio_1h": 1.0068,  // 多空比（近1小时）
      "long_short_ratio_4h": 1.0504,  // 多空比（近4小时）
      "long_short_ratio_12h": 1.0317,  // 多空比（近12小时）
      "long_short_ratio_24h": 1.0313,  // 多空比（近24小时）
      "liquidation_usd_1h": 33621.85192,  // 总爆仓金额（近1小时，单位：USD）
      "long_liquidation_usd_1h": 22178.4681,  // 多头爆仓金额（近1小时，单位：USD）
      "short_liquidation_usd_1h": 11443.38382,  // 空头爆仓金额（近1小时，单位：USD）
      "liquidation_usd_4h": 222210.47117,  // 总爆仓金额（近4小时，单位：USD）
      "long_liquidation_usd_4h": 179415.77249,  // 多头爆仓金额（近4小时，单位：USD）
      "short_liquidation_usd_4h": 42794.69868,  // 空头爆仓金额（近4小时，单位：USD）
      "liquidation_usd_12h": 11895453.392145,  // 总爆仓金额（近12小时，单位：USD）
      "long_liquidation_usd_12h": 10223351.23772,  // 多头爆仓金额（近12小时，单位：USD）
      "short_liquidation_usd_12h": 1672102.154425,  // 空头爆仓金额（近12小时，单位：USD）
      "liquidation_usd_24h": 27519292.973646,  // 总爆仓金额（近24小时，单位：USD）
      "long_liquidation_usd_24h": 17793322.595016,  // 多头爆仓金额（近24小时，单位：USD）
      "short_liquidation_usd_24h": 9725970.37863  // 空头爆仓金额（近24小时，单位：USD）
    },
    {
      "symbol": "ETH",  // 币种符号
      "current_price": 1582.55,  // 当前价格（单位：USD）
      "avg_funding_rate_by_oi": 0.001631,  // 持仓量加权平均资金费率
      "avg_funding_rate_by_vol": -0.000601,  // 成交量加权平均资金费率
      "market_cap_usd": 190821695398.62064,  // 市值（单位：USD）
      "open_interest_market_cap_ratio": 0.0925,  // 未平仓量与市值比值
      "open_interest_usd": 17657693967.0459,  // 未平仓量（单位：USD）
      "open_interest_quantity": 11160428.5065,  // 未平仓合约数量
      "open_interest_volume_ratio": 0.5398,  // 未平仓量与成交量比值
      "price_change_percent_5m": 0.07,  // 价格5分钟变化百分比
      "price_change_percent_15m": 0.25,  // 价格15分钟变化百分比
      "price_change_percent_30m": 0.07,  // 价格30分钟变化百分比
      "price_change_percent_1h": -0.11,  // 价格1小时变化百分比
      "price_change_percent_4h": -0.05,  // 价格4小时变化百分比
      "price_change_percent_12h": -0.02,  // 价格12小时变化百分比
      "price_change_percent_24h": 0.16  // 价格24小时变化百分比
      // ...后续字段依此类推
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填 | 描述                                                                            |
| ------------- | ------- | -- | ----------------------------------------------------------------------------- |
| exchange_list | string  | NO | 以逗号分隔的交易所名称（例如："binance, okx, bybit"）。可通过 `support-exchange-pair` 接口获取支持的交易所。 |
| per_page      | integer | NO | 每页返回的结果数量。                                                                    |
| page          | integer | NO | 分页的页码，默认值为 1。                                                                 |


# 合约 - 交易市场 - 交易对市场列表


```
GET /api/futures/pairs-markets
```


该接口提供合约交易对的相关指标信息。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "instrument_id": "BTCUSDT", // 合约交易对
      "exchange_name": "Binance", // 交易所名称
      "symbol": "BTC/USDT", // 币种对

      "current_price": 84604.3, // 当前价格
      "index_price": 84646.66222222, // 指数价格
      "price_change_percent_24h": 0.67, // 24小时价格变化(%)

      "volume_usd": 11317580109.5041, // 24小时交易量(USD)
      "volume_usd_change_percent_24h": -32.13, // 24小时交易量变化(%)

      "long_volume_usd": 5800829746.047, // 多单成交价值(USD)
      "short_volume_usd": 5516750363.4571, // 空单成交价值(USD)
      "long_volume_quantity": 1130850, // 多单成交笔数
      "short_volume_quantity": 1162710, // 空单成交笔数

      "open_interest_quantity": 77881.234, // 未平仓合约数量
      "open_interest_usd": 6589095073.8296, // 未平仓合约价值(USD)
      "open_interest_change_percent_24h": 1.9, // 24小时未平仓合约变化(%)

      "long_liquidation_usd_24h": 3654182.12, // 近24小时多单爆仓金额(USD)
      "short_liquidation_usd_24h": 4099047.79, // 近24小时空单爆仓金额(USD)

      "funding_rate": 0.002007, // 当前资金费率
      "next_funding_time": 1744963200000, // 下一次资金费率时间戳

      "open_interest_volume_radio": 0.5822, // 未平仓合约与交易量比率
      "oi_vol_ratio_change_percent_24h": 50.13 // 24小时比率变化(%)
    },
    {
      "instrument_id": "BTC_USDT", // 合约交易对
      "exchange_name": "Gate.io", // 交易所名称
      "symbol": "BTC/USDT", // 币种对

      "current_price": 84616.3, // 当前价格
      "index_price": 84643.36, // 指数价格
      "price_change_percent_24h": 0.69, // 24小时价格变化(%)

      "volume_usd": 1711484049.255, // 24小时交易量(USD)
      "volume_usd_change_percent_24h": -67.03, // 24小时交易量变化(%)

      "long_volume_usd": 870432407.5966, // 多单成交价值(USD)
      "short_volume_usd": 841051641.6584, // 空单成交价值(USD)
      "long_volume_quantity": 210027, // 多单成交笔数
      "short_volume_quantity": 218777, // 空单成交笔数

      "open_interest_quantity": 69477.278, // 未平仓合约数量
      "open_interest_usd": 5878785139.331, // 未平仓合约价值(USD)
      "open_interest_change_percent_24h": 3.82, // 24小时未平仓合约变化(%)

      "long_liquidation_usd_24h": 1502896.68, // 近24小时多单爆仓金额(USD)
      "short_liquidation_usd_24h": 1037959.7, // 近24小时空单爆仓金额(USD)

      "funding_rate": 0.0022, // 当前资金费率

      "open_interest_volume_radio": 3.4349, // 未平仓合约与交易量比率
      "oi_vol_ratio_change_percent_24h": 214.93 // 24小时比率变化(%)
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                            |
| ------ | ------ | --- | --------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 'support-coins' 接口获取支持的币种列表。 |


# 合约 - 交易市场 - 币种涨跌幅


```
GET /api/futures/coins-price-change
```


该接口提供币种在多个时间周期内的涨跌幅和振幅数据。

***缓存/ 更新频率 :*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "BTC", // 币种
      "current_price": 84518.4, // 当前价格

      "price_change_percent_5m": -0.04, // 5分钟价格涨跌幅 (%)
      "price_change_percent_15m": -0.09, // 15分钟价格涨跌幅 (%)
      "price_change_percent_30m": -0.11, // 30分钟价格涨跌幅 (%)
      "price_change_percent_1h": -0.17, // 1小时价格涨跌幅 (%)
      "price_change_percent_4h": -0.54, // 4小时价格涨跌幅 (%)
      "price_change_percent_12h": -0.6, // 12小时价格涨跌幅 (%)
      "price_change_percent_24h": 0.24, // 24小时价格涨跌幅 (%)

      "price_amplitude_percent_5m": 0.07, // 5分钟价格振幅 (%)
      "price_amplitude_percent_15m": 0.16, // 15分钟价格振幅 (%)
      "price_amplitude_percent_30m": 0.18, // 30分钟价格振幅 (%)
      "price_amplitude_percent_1h": 0.26, // 1小时价格振幅 (%)
      "price_amplitude_percent_4h": 0.63, // 4小时价格振幅 (%)
      "price_amplitude_percent_12h": 1.17, // 12小时价格振幅 (%)
      "price_amplitude_percent_24h": 2.06 // 24小时价格振幅 (%)
    },
    {
      "symbol": "ETH", // 币种
      "current_price": 1573.45, // 当前价格

      "price_change_percent_5m": -0.04, // 5分钟价格涨跌幅 (%)
      "price_change_percent_15m": -0.34, // 15分钟价格涨跌幅 (%)
      "price_change_percent_30m": -0.38, // 30分钟价格涨跌幅 (%)
      "price_change_percent_1h": -0.54, // 1小时价格涨跌幅 (%)
      "price_change_percent_4h": -0.77, // 4小时价格涨跌幅 (%)
      "price_change_percent_12h": -1.99, // 12小时价格涨跌幅 (%)
      "price_change_percent_24h": -1.41, // 24小时价格涨跌幅 (%)

      "price_amplitude_percent_5m": 0.13, // 5分钟价格振幅 (%)
      "price_amplitude_percent_15m": 0.4, // 15分钟价格振幅 (%)
      "price_amplitude_percent_30m": 0.47, // 30分钟价格振幅 (%)
      "price_amplitude_percent_1h": 0.66, // 1小时价格振幅 (%)
      "price_amplitude_percent_4h": 0.9, // 4小时价格振幅 (%)
      "price_amplitude_percent_12h": 2.74, // 12小时价格振幅 (%)
      "price_amplitude_percent_24h": 3.47 // 24小时价格振幅 (%)
    }
  ]
}

```


# 合约 - 交易市场 - 交易对K线历史


```
GET /api/futures/price/history
```


该接口提供加密货币在指定时间周期内的历史开盘价、最高价、最低价和收盘价（OHLC）数据。

***缓存 / 更新频率:*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1745366400000,
      "open": "93404.9",
      "high": "93864.9",
      "low": "92730",
      "close": "92858.2",
      "volume_usd": "1166471854.3026"
    },
    {
      "time": 1745370000000,
      "open": "92858.2",
      "high": "93464.8",
      "low": "92552",
      "close": "92603.8",
      "volume_usd": "871812560.3437"
    },
    ...
 ]
}    
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 合约交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口查询支持的交易对。         |
| interval   | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。        |
| limit      | integer | YES | 每次请求返回的数据条数。默认值：1000，最大值：1000。                                |
| start_time | integer | NO  | 起始时间戳，单位为毫秒（例如：1641522717000）。                                |
| end_time   | integer | NO  | 结束时间戳，单位为毫秒（例如：1641522717000）。                                |


# 合约 - 交易市场 - 下架的交易所和交易对


```
GET /api/futures/delisted-exchange-pairs
```


此接口查询已下线的合约交易所和交易对。

***缓存 / 更新频率:*** 每30分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "Binance": [ // 交易所名称
      {
        "instrument_id": "BTCUSD_PERP",// 合约交易对
        "base_asset": "BTC",// 基础币种
        "quote_asset": "USD"// 计价币种
      },
      {
        "instrument_id": "BTCUSD_250627",
        "base_asset": "BTC",
        "quote_asset": "USD"
      },
      ....
      ],
    "Bitget": [
      {
        "instrument_id": "BTCUSDT_UMCBL",
        "base_asset": "BTC",
        "quote_asset": "USDT"
      },
      {
        "instrument_id": "ETHUSDT_UMCBL",
        "base_asset": "ETH",
        "quote_asset": "USDT"
      },
      ...
      ]
      ...
   }
}
```


# 合约 - 交易市场 - 交易所列表


```
GET /api/futures/exchange-rank
```


此端点提供CoinGlass上合约交易所的排名列表。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "exchange": "Binance",
      "open_interest_usd": 27564494330,
      "volume_usd": 54150896832,
      "liquidation_usd_24h": 58774453.06516198
    },
    {
      "exchange": "OKX",
      "open_interest_usd": 8586569027,
      "volume_usd": 22670494849,
      "liquidation_usd_24h": 19276388.77685
    },
  ]
}
```


# 合约 - 持仓 - 持仓历史(K线)


```
GET /api/futures/open-interest/history
```


该接口提供合约交易对的持仓量（Open Interest）K线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 2644845344000, // 时间戳（毫秒）
      "open": "2644845344",   // 开盘持仓量
      "high": "2692643311",   // 最高持仓量
      "low": "2576975597",    // 最低持仓量
      "close": "2608846475"   // 收盘持仓量
    },
    {
      "time": 2608846475000, // 时间戳（毫秒）
      "open": "2608846475",  // 开盘持仓量
      "high": "2620807645",  // 最高持仓量
      "low": "2327236202",   // 最低持仓量
      "close": "2340177420"  // 收盘持仓量
    },
    ....
  ]
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                          |
| ---------- | ------- | --- | ----------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval   | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| unit       | string  | NO  | 返回数据的单位，可选值为 'usd' 或 'coin'。                                |


# 合约 - 持仓 - 聚合持仓历史(K线)


```
GET /api/futures/open-interest/aggregated-history
```


该接口提供聚合多个交易所的币种持仓量（Open Interest） K线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 2644845344000, // 时间戳（毫秒）
      "open": "2644845344",   // 开始时的未平仓合约
      "high": "2692643311",   // 最高未平仓合约
      "low": "2576975597",    // 最低未平仓合约
      "close": "2608846475"   // 结束时的未平仓合约
    },
    {
      "time": 2608846475000, // 时间戳（毫秒）
      "open": "2608846475",  // 开始时的未平仓合约
      "high": "2620807645",  // 最高未平仓合约
      "low": "2327236202",   // 最低未平仓合约
      "close": "2340177420"  // 结束时的未平仓合约
    },
    ....
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                  |
| ---------- | ------- | --- | --------------------------------------------------- |
| symbol     | string  | YES | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。          |
| interval   | string  | YES | 数据时间间隔。支持的值：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit      | integer | NO  | 每次请求的结果数量。默认值：1000，最大值：1000。                        |
| start_time | integer | NO  | 起始时间戳（单位：毫秒，例如：1641522717000）。                      |
| end_time   | integer | NO  | 结束时间戳（单位：毫秒，例如：1641522717000）。                      |
| unit       | string  | NO  | 返回数据的单位，可以选择 'usd' 或 'coin'。                        |


# 合约 - 持仓 - 聚合稳定币保证金持仓(K线)


```
GET /api/futures/open-interest/aggregated-stablecoin-history
```


该接口用于返回聚合多个交易所的稳定币保证金持仓量（Open Interest）K 线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 2644845344000, // 时间戳（毫秒）
      "open": "2644845344",   // 开始时的未平仓合约
      "high": "2692643311",   // 最高未平仓合约
      "low": "2576975597",    // 最低未平仓合约
      "close": "2608846475"   // 结束时的未平仓合约
    },
    {
      "time": 2608846475000, // 时间戳（毫秒）
      "open": "2608846475",  // 开始时的未平仓合约
      "high": "2620807645",  // 最高未平仓合约
      "low": "2327236202",   // 最低未平仓合约
      "close": "2340177420"  // 结束时的未平仓合约
    },
    ....
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                                          |
| ------------- | ------- | --- | --------------------------------------------------------------------------- |
| exchange_list | string  | YES | 以逗号分隔的交易所名称（例如："Binance,OKX,Bybit"）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol        | string  | YES | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。                                  |
| interval      | string  | YES | 数据时间间隔。支持的值：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。                         |
| limit         | integer | NO  | 每次请求的结果数量。默认值：1000，最大值：1000。                                                |
| start_time    | integer | NO  | 起始时间戳（单位：毫秒，例如：1641522717000）。                                              |
| end_time      | integer | NO  | 结束时间戳（单位：毫秒，例如：1641522717000）。                                              |


# 合约 - 持仓 - 聚合币本位保证金持仓(K线)


```
GET /api/futures/open-interest/aggregated-coin-margin-history
```


该接口提供聚合多个交易所的币本位保证金持仓量（Open Interest）K线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 2644845344000, // 时间戳（毫秒）
      "open": "2644845344",   // 开始时的未平仓合约
      "high": "2692643311",   // 最高未平仓合约
      "low": "2576975597",    // 最低未平仓合约
      "close": "2608846475"   // 结束时的未平仓合约
    },
    {
      "time": 2608846475000, // 时间戳（毫秒）
      "open": "2608846475",  // 开始时的未平仓合约
      "high": "2620807645",  // 最高未平仓合约
      "low": "2327236202",   // 最低未平仓合约
      "close": "2340177420"  // 结束时的未平仓合约
    },
    ....
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                                            |
| ------------- | ------- | --- | ----------------------------------------------------------------------------- |
| exchange_list | string  | YES | 以逗号分隔的交易所名称（例如："Binance, OKX, Bybit"）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol        | string  | YES | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。                                    |
| interval      | string  | YES | 数据时间间隔。支持的值：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。                           |
| limit         | integer | NO  | 每次请求的结果数量。默认值：1000，最大值：1000。                                                  |
| start_time    | integer | NO  | 起始时间戳（单位：毫秒，例如：1641522717000）。                                                |
| end_time      | integer | NO  | 结束时间戳（单位：毫秒，例如：1641522717000）。                                                |


# 合约 - 持仓 - 币种交易所持仓


```
GET /api/futures/open-interest/exchange-list
```


该接口提供某个币种在多个交易所的持仓量（Open Interest）数据

***缓存 / 更新频率:*** 10秒钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "exchange": "All", // 交易所名称，"All"表示所有交易所汇总
      "symbol": "BTC", // 币种符号

      "open_interest_usd": 57437891724.5572, // 未平仓合约价值(USD)，表示所有未平仓合约的总价值
      "open_interest_quantity": 659557.3064, // 未平仓合约数量，表示所有未平仓合约的总数量

      "open_interest_by_stable_coin_margin": 48920274435.15, // 稳定币本位未平仓合约价值(USD)，合约采用稳定币作为保证金
      "open_interest_quantity_by_coin_margin": 97551.2547, // 币本位未平仓合约数量
      "open_interest_quantity_by_stable_coin_margin": 562006.0517, // 稳定币本位未平仓合约数量

      "open_interest_change_percent_5m": 0.34, // 5分钟内未平仓合约变化百分比
      "open_interest_change_percent_15m": 0.59, // 15分钟内未平仓合约变化百分比
      "open_interest_change_percent_30m": 1.42, // 30分钟内未平仓合约变化百分比
      "open_interest_change_percent_1h": 2.27, // 1小时内未平仓合约变化百分比
      "open_interest_change_percent_4h": 2.95, // 4小时内未平仓合约变化百分比
      "open_interest_change_percent_24h": 0.9 // 24小时内未平仓合约变化百分比
    },
    {
      "exchange": "CME", // 交易所名称
      "symbol": "BTC", // 币种符号

      "open_interest_usd": 12294999402.5, // 未平仓合约价值(USD)，表示所有未平仓合约的总价值
      "open_interest_quantity": 141275.5, // 未平仓合约数量，表示所有未平仓合约的总数量

      "open_interest_by_stable_coin_margin": 12294999402.5, // 稳定币本位未平仓合约价值(USD)，合约采用稳定币作为保证金
      "open_interest_quantity_by_coin_margin": 0, // 币本位未平仓合约数量
      "open_interest_quantity_by_stable_coin_margin": 141275.5, // 稳定币本位未平仓合约数量

      "open_interest_change_percent_5m": 0.08, // 5分钟内未平仓合约变化百分比
      "open_interest_change_percent_15m": 0.14, // 15分钟内未平仓合约变化百分比
      "open_interest_change_percent_30m": 0.49, // 30分钟内未平仓合约变化百分比
      "open_interest_change_percent_1h": 1.13, // 1小时内未平仓合约变化百分比
      "open_interest_change_percent_4h": 2.4, // 4小时内未平仓合约变化百分比
      "open_interest_change_percent_24h": 2.08 // 24小时内未平仓合约变化百分比
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |


# 合约 - 持仓 - 币种交易所持仓历史


```
GET /api/futures/open-interest/exchange-history-chart
```


该接口用于获取某一加密货币在多个交易所的历史持仓量数据，适用于图表展示。

***缓存 / 更新频率:*** 10秒钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "time_list": [1721649600000, ...], // 时间戳列表（毫秒）
    "price_list": [67490.3, ...], // 价格列表（与 time_list 对应）

    "data_map": { // 各交易所未平仓合约数据
      "Binance": [8018229234, ...], // Binance 未平仓合约（与 time_list 对应）
      "Bitmex": [395160842, ...] // BitMEX 未平仓合约（与 time_list 对应）
      // ...
    }
  }
}
```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据时间范围（例如：all，1m，15m，1h，4h，12h）             |
| unit   | string | NO  | 返回数据的单位，可以选择 'usd' 或 'coin'。                |


# 合约 - 资金费率 - 资金费率历史(K线)


```
GET /api/futures/funding-rate/history
```


该接口提供合约交易对的资金费率 K 线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1658880000000, // 时间戳（毫秒）
      "open": "0.004603",     // 开盘资金费率
      "high": "0.009388",     // 最高资金费率
      "low": "-0.005063",     // 最低资金费率
      "close": "0.009229"     // 收盘资金费率
    },
    {
      "time": 1658966400000, // 时间戳（毫秒）
      "open": "0.009229",     // 开盘资金费率
      "high": "0.01",         // 最高资金费率
      "low": "0.007794",      // 最低资金费率
      "close": "0.01"         // 收盘资金费率
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 资金费率 - 持仓加权资金费率历史(K线)


```
GET /api/futures/funding-rate/oi-weight-history
```


该接口提供按持仓量加权的合约币种资金费率 K 线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1658880000000, // 时间戳（毫秒）
      "open": "0.004603",     // 开盘资金费率
      "high": "0.009388",     // 最高资金费率
      "low": "-0.005063",     // 最低资金费率
      "close": "0.009229"     // 收盘资金费率
    },
    {
      "time": 1658966400000, // 时间戳（毫秒）
      "open": "0.009229",     // 开盘资金费率
      "high": "0.01",         // 最高资金费率
      "low": "0.007794",      // 最低资金费率
      "close": "0.01"         // 收盘资金费率
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                      |
| ---------- | ------- | --- | ------------------------------------------------------- |
| symbol     | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |


# 合约 - 资金费率 - 成交量加权资金费率历史(K线)


```
GET /api/futures/funding-rate/vol-weight-history
```


该接口提供按成交量加权的合约币种资金费率 K 线数据，包含开盘价、最高价、最低价和收盘价（OHLC）。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1658880000000, // 时间戳（毫秒）
      "open": "0.004603",     // 开盘资金费率
      "high": "0.009388",     // 最高资金费率
      "low": "-0.005063",     // 最低资金费率
      "close": "0.009229"     // 收盘资金费率
    },
    {
      "time": 1658966400000, // 时间戳（毫秒）
      "open": "0.009229",     // 开盘资金费率
      "high": "0.01",         // 最高资金费率
      "low": "0.007794",      // 最低资金费率
      "close": "0.01"         // 收盘资金费率
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                      |
| ---------- | ------- | --- | ------------------------------------------------------- |
| symbol     | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |


# 合约 - 资金费率 - 币种资金费率-交易所列表


```
GET /api/futures/funding-rate/exchange-list
```


该接口提供各交易所的币种资金费率数据。

***缓存 / 更新频率:*** 20秒一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "BTC", // 币种
      "stablecoin_margin_list": [ // USDT/USD 保证金模式
        {
          "exchange": "Binance", // 交易所
          "funding_rate_interval": 8, // 资金费率结算周期（小时）
          "funding_rate": 0.007343, // 当前资金费率
          "next_funding_time": 1745222400000 // 下次资金费率结算时间（毫秒）
        },
        {
          "exchange": "OKX", // 交易所
          "funding_rate_interval": 8, // 资金费率结算周期（小时）
          "funding_rate": 0.00736901950628, // 当前资金费率
          "next_funding_time": 1745222400000 // 下次资金费率结算时间（毫秒）
        }
      ],
      "token_margin_list": [ // 币本位保证金模式
        {
          "exchange": "Binance", // 交易所
          "funding_rate_interval": 8, // 资金费率结算周期（小时）
          "funding_rate": -0.001829, // 当前资金费率
          "next_funding_time": 1745222400000 // 下次资金费率结算时间（毫秒）
        }
      ]
    }
  ]
}

```


# 合约 - 资金费率 - 累计资金费率-交易所列表


```
GET /api/futures/funding-rate/accumulated-exchange-list
```


该接口提供各交易所的币种累计资金费率数据。

***缓存 / 更新频率:*** 1小时一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "BTC", // 币种
      "stablecoin_margin_list": [ // USDT/USD 保证金模式的累计资金费率
        {
          "exchange": "BINANCE", // 交易所名称
          "funding_rate": 0.001873 // 累计资金费率
        },
        {
          "exchange": "OKX", // 交易所名称
          "funding_rate": 0.00775484 // 累计资金费率
        }
      ],
      "token_margin_list": [ // 币本位保证金模式的累计资金费率
        {
          "exchange": "BINANCE", // 交易所名称
          "funding_rate": -0.003149 // 累计资金费率
        }
      ]
    }
  ]
}

```

 **Parameters:**
| 名称    | 类型     | 必填  | 描述                               |
| ----- | ------ | --- | -------------------------------- |
| range | string | YES | 数据的时间范围 (例如.,1d, 7d, 30d, 365d). |


# 合约 - 资金费率 - 资金费率套利


```
GET /api/futures/funding-rate/arbitrage
```


该接口提供不同交易所间的合约币种资金费率套利数据。

***缓存/ 更新频率 :*** 20秒一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "SUPRA", // 币种名称

      "buy": { // 做多的交易所信息（低资金费率）
        "exchange": "MEXC", // 交易所名称
        "open_interest_usd": 848218.2833, // 平台未平仓合约金额（美元）
        "funding_rate_interval": 4, // 资金费率结算间隔（小时）
        "funding_rate": -0.994 // 当前资金费率（%）
      },

      "sell": { // 做空的交易所信息（高资金费率）
        "exchange": "Gate.io", // 交易所名称
        "open_interest_usd": 448263.5072, // 平台未平仓合约金额（美元）
        "funding_rate_interval": 4, // 资金费率结算间隔（小时）
        "funding_rate": 0.005 // 当前资金费率（%）
      },

      "apr": 2187.81, // 年化收益率（APR，%）
      "funding": 0.999, // 资金费率收益差（long和short之间的资金费率差）
      "fee": 0.03, // 交易手续费率（双边总和）
      "spread": -0.09, // 跨平台价格差（%）
      "next_funding_time": 1745222400000 // 下一次资金费率结算时间（时间戳，毫秒）
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                               |
| ------------- | ------- | --- | -------------------------------- |
| usd           | integer | YES | 套利投资本金（例如：10000）                 |
| exchange_list | string  | NO  | 筛选交易所名称列表（例如“Binance,OKX,Bybit”） |


# 合约 - 多空比 - 交易对账户多空比历史


```
GET /api/futures/global-long-short-account-ratio/history
```


该接口提供交易所交易对的多空账户比历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741604400000, // 时间戳（毫秒）
      "global_account_long_percent": 73.88, // 账户多单比例（%）
      "global_account_short_percent": 26.12, // 账户空单比例（%）
      "global_account_long_short_ratio": 2.83 // 账户多空比（多/空）
    },
    {
      "time": 1741608000000, // 时间戳（毫秒）
      "global_account_long_percent": 73.24, // 账户多单比例（%）
      "global_account_short_percent": 26.76, // 账户空单比例（%）
      "global_account_long_short_ratio": 2.74 // 账户多空比（多/空）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 多空比 - 大户账户数多空比历史


```
GET /api/futures/top-long-short-account-ratio/history
```


该接口提供大户账户的多空比历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741615200000, // 时间戳（毫秒）
      "top_account_long_percent": 73.3, // 大户账户多单比例（%）
      "top_account_short_percent": 26.7, // 大户账户空单比例（%）
      "top_account_long_short_ratio": 2.75 // 大户账户多空比（多/空）
    },
    {
      "time": 1741618800000, // 时间戳（毫秒）
      "top_account_long_percent": 74.18, // 大户账户多单比例（%）
      "top_account_short_percent": 25.82, // 大户账户空单比例（%）
      "top_account_long_short_ratio": 2.87 // 大户账户多空比（多/空）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                           |
| ---------- | ------- | --- | ------------------------------------------------------------ |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                 |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                 |


# 合约 - 多空比 - 大户持仓多空比历史


```
GET /api/futures/top-long-short-position-ratio/history
```


该接口提供大户持仓多空比历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741615200000, // 时间戳（毫秒）
      "top_position_long_percent": 64.99, // 大户持仓多单比例（%）
      "top_position_short_percent": 35.01, // 大户持仓空单比例（%）
      "top_position_long_short_ratio": 1.86 // 大户持仓多空比（多/空）
    },
    {
      "time": 1741618800000, // 时间戳（毫秒）
      "top_position_long_percent": 64.99, // 大户持仓多单比例（%）
      "top_position_short_percent": 35.01, // 大户持仓空单比例（%）
      "top_position_long_short_ratio": 1.86 // 大户持仓多空比（多/空）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 多空比 - 币种主动买卖比


```
GET /api/futures/taker-buy-sell-volume/exchange-list
```


该接口提供聚合多个交易所中币种的主动买卖成交量比数据。

***缓存 / 更新频率:*** 1秒钟一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "symbol": "BTC", // 币种
    "buy_ratio": 51.01, // 买入比例（%）
    "sell_ratio": 48.99, // 卖出比例（%）
    "buy_vol_usd": 1112108532.1688, // 总买入金额（美元）
    "sell_vol_usd": 1068220541.0417, // 总卖出金额（美元）
    "exchange_list": [ // 各个交易所的买卖数据
      {
        "exchange": "Binance", // 交易所名称
        "buy_ratio": 49.22, // 买入比例（%）
        "sell_ratio": 50.78, // 卖出比例（%）
        "buy_vol_usd": 240077939.5811, // 买入金额（美元）
        "sell_vol_usd": 247674925.1653 // 卖出金额（美元）
      },
      {
        "exchange": "OKX", // 交易所名称
        "buy_ratio": 50.84, // 买入比例（%）
        "sell_ratio": 49.16, // 卖出比例（%）
        "buy_vol_usd": 108435724.6214, // 买入金额（美元）
        "sell_vol_usd": 104834502.5904 // 卖出金额（美元）
      }
    ]
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据的时间范围（例如：5m、15m、30m、1h、4h、12h、24h）。       |


# 合约 - 多空比 - 净持仓


```
GET /api/futures/net-position/history
```


该接口提供合约的历史净持仓数据，包括净多仓位变化和净空仓位变化。

***缓存/ 更新频率 :*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "net_long_change": -478.43,//数量
      "net_short_change": 0,
      "time": 1751652000000
    },
    {
      "net_long_change": -776.79,
      "net_short_change": 0,
      "time": 1751655600000
    },
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                              |
| ---------- | ------- | --- | --------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 supported-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 supported-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。         |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                    |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                    |


# 合约 - 多空比 - 净持仓(v2)


```
GET /api/futures/v2/net-position/history
```


该接口提供合约的历史净持仓数据，包括净多仓位变化和净空仓位变化。

***缓存/ 更新频率 :*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "net_long_change": -478.43,//数量
      "net_short_change": 0,
      "time": 1751652000000
    },
    {
      "net_long_change": -776.79,
      "net_short_change": 0,
      "time": 1751655600000
    },
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                              |
| ---------- | ------- | --- | --------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 supported-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 supported-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。         |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                    |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                    |


# 合约 - 爆仓与清算 - 交易对爆仓历史


```
GET /api/futures/liquidation/history
```


该接口提供交易所中交易对的多空爆仓历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1658880000000, // 时间戳（毫秒）
      "long_liquidation_usd": "2369935.19562", // 多单爆仓金额（美元）
      "short_liquidation_usd": "6947459.43674" // 空单爆仓金额（美元）
    },
    {
      "time": 1658966400000, // 时间戳（毫秒）
      "long_liquidation_usd": "5118407.85124", // 多单爆仓金额（美元）
      "short_liquidation_usd": "8517330.44192" // 空单爆仓金额（美元）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 爆仓与清算 - 币种爆仓历史


```
GET /api/futures/liquidation/aggregated-history
```


该接口提供币种聚合多个交易所的多空爆仓历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
   {
      "aggregated_long_liquidation_usd": "4611285.1141", // 聚合多单爆仓金额（美元）
      "aggregated_short_liquidation_usd": "4788636.51145", // 聚合空单爆仓金额（美元）
      "time": 1636588800 // 时间戳
   },
    {
      "aggregated_long_liquidation_usd": "4611285.1141", // 聚合多单爆仓金额（美元）
      "aggregated_short_liquidation_usd": "4788636.51145", // 聚合空单爆仓金额（美元）
      "time": 1636588800 // 时间戳
   },
    ..
  ]
}


```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                                            |
| ------------- | ------- | --- | ----------------------------------------------------------------------------- |
| exchange_list | string  | YES | 以逗号分隔的交易所名称（例如："Binance, OKX, Bybit"）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol        | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。                                   |
| interval      | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。                       |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                              |
| start_time    | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                                  |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                                  |


# 合约 - 爆仓与清算 - 交易所币种爆仓列表


```
GET /api/futures/liquidation/coin-list
```


该接口提供指定交易所内所有币种的爆仓数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "BTC", // 币种符号
      "liquidation_usd_24h": 82280481.50425325, // 过去24小时总爆仓金额（美元）
      "long_liquidation_usd_24h": 68437447.33734027, // 过去24小时多单爆仓金额（美元）
      "short_liquidation_usd_24h": 13843034.16691298, // 过去24小时空单爆仓金额（美元）

      "liquidation_usd_12h": 68331844.36224127, // 过去12小时总爆仓金额
      "long_liquidation_usd_12h": 66614158.47451427, // 过去12小时多单爆仓金额
      "short_liquidation_usd_12h": 1717685.887727, // 过去12小时空单爆仓金额

      "liquidation_usd_4h": 11381137.080643, // 过去4小时总爆仓金额
      "long_liquidation_usd_4h": 10921633.272973, // 过去4小时多单爆仓金额
      "short_liquidation_usd_4h": 459503.80767, // 过去4小时空单爆仓金额

      "liquidation_usd_1h": 3283635.95309, // 过去1小时总爆仓金额
      "long_liquidation_usd_1h": 3182915.16289, // 过去1小时多单爆仓金额
      "short_liquidation_usd_1h": 100720.7902 // 过去1小时空单爆仓金额
    },
    {
      "symbol": "ETH", // 币种
      "liquidation_usd_24h": 40690629.51728708,
      "long_liquidation_usd_24h": 23696395.11024007,
      "short_liquidation_usd_24h": 16994234.40704701,
      "liquidation_usd_12h": 24938270.19977256,
      "long_liquidation_usd_12h": 22675785.96343007,
      "short_liquidation_usd_12h": 2262484.23634249,
      "liquidation_usd_4h": 8034894.33790068,
      "long_liquidation_usd_4h": 7683841.24631068,
      "short_liquidation_usd_4h": 351053.09159,
      "liquidation_usd_1h": 6103879.82428372,
      "long_liquidation_usd_1h": 6098481.11604372,
      "short_liquidation_usd_1h": 5398.70824
    }
  ]
}

```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |


# 合约 - 爆仓与清算 - 币种交易所爆仓列表


```
GET /api/futures/liquidation/exchange-list
```


该接口提供指定币种在各大交易所的爆仓数据列表。

***缓存 / 更新频率:*** 10秒钟一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "exchange": "All", // 所有交易所的总数据
      "liquidation_usd": 14673519.81739075, // 总爆仓金额（美元）
      "long_liquidation_usd": 451394.17404598, // 多单爆仓金额（美元）
      "short_liquidation_usd": 14222125.64334477 // 空单爆仓金额（美元）
    },
    {
      "exchange": "Bybit", // 交易所名称
      "liquidation_usd": 4585290.13404, // 总爆仓金额（美元）
      "long_liquidation_usd": 104560.13885, // 多单爆仓金额（美元）
      "short_liquidation_usd": 4480729.99519 // 空单爆仓金额（美元）
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | NO  | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据的时间范围（例如：1h、4h、12h、24h）。                  |


# 合约 - 爆仓与清算 - 爆仓订单


```
GET /api/futures/liquidation/order
```


该接口提供过去7天内的爆仓订单数据，包含交易所、交易对及爆仓金额等详细信息。

***缓存 / 更新频率:*** 1秒钟一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "exchange_name": "BINANCE", // 交易所名称
      "symbol": "BTCUSDT", // 交易对符号
      "base_asset": "BTC", // 币种
      "price": 87535.9, // 爆仓价格
      "usd_value": 205534.2932, // 成交金额（美元）
      "side": 2, // 订单方向（1：买入，2：卖出）
      "time": 1745216319263 // 时间戳
    },
    {
      "exchange_name": "BINANCE", // 交易所名称
      "symbol": "BTCUSDT", // 交易对符号
      "base_asset": "BTC", // 币种
      "price": 87465.2, // 爆仓价格
      "usd_value": 15918.6664, // 成交金额（美元）
      "side": 2, // 订单方向（1：买入，2：卖出）
      "time": 1745215647165 // 时间戳
    }
  ]
}

```

 **Parameters:**
| 名称                     | 类型      | 必填  | 描述                                                            |
| ---------------------- | ------- | --- | ------------------------------------------------------------- |
| exchange               | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol                 | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。                   |
| min_liquidation_amount | string  | YES | 爆仓订单的最小金额阈值。每个请求最多返回 200 条记录                                  |
| start_time             | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time               | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 爆仓与清算 - 交易对清算热力图(模型1)


```
GET /api/futures/liquidation/heatmap/model1
```


该接口提供交易对的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| range    | string | YES | 数据的时间范围（例如：12h、24h、3d、7d、30d、90d、180d、1y）                     |


# 合约 - 爆仓与清算 - 交易对清算热力图(模型2)


```
GET /api/futures/liquidation/heatmap/model2
```


该接口提供交易对的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。                   |
| range    | string | YES | 数据的时间范围（例如：12h、24h、3d、7d、30d、90d、180d、1y）                     |


# 合约 - 爆仓与清算 - 交易对清算热力图(模型3)


```
GET /api/futures/liquidation/heatmap/model3
```


该接口提供交易对的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表        |
| range    | string | YES | 数据的时间范围（例如：12h、24h、3d、7d、30d、90d、180d、1y）                     |


# 合约 - 爆仓与清算 - 币种清算热力图(模型1)


```
GET /api/futures/liquidation/aggregated-heatmap/model1
```


该接口提供币种的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据的时间范围（例如：12h、24h、3d、7d、30d、90d、180d、1y）   |


# 合约 - 爆仓与清算 - 币种清算热力图(模型2)


```
GET /api/futures/liquidation/aggregated-heatmap/model2
```


该接口提供币种的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据的时间范围（例如：12h、24h、3d、7d、30d、90d、180d、1y）   |


# 合约 - 爆仓与清算 - 币种清算热力图(模型3)


```
GET /api/futures/liquidation/aggregated-heatmap/model3
```


该接口提供币种的爆仓热力图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "y_axis": [47968.54, 48000.00, 48031.46], // Y轴坐标，价格范围
    "liquidation_leverage_data": [
      [5, 124, 2288867.26], // 每个数组表示：[X轴索引, Y轴索引, 该位置的清算强度]
      [6, 123, 318624.82],
      [7, 122, 1527940.12]
    ],
    "price_candlesticks": [
      [
        1722676500, // 时间戳（秒）
        "61486",    // 开盘价
        "61596.4",  // 最高价
        "61434.4",  // 最低价
        "61539.9",  // 收盘价
        "63753192.1129" // 成交量（美元）
      ],
      [
        1722676800,
        "61539.9",
        "61610.0",
        "61480.0",
        "61590.5",
        "42311820.8720"
      ]
    ]
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                                                                       |
| ------ | ------ | --- | ---------------------------------------------------------------------------------------- |
| symbol | string | YES | Trading coin (e.g., BTC). Retrieve supported coins via the 'support-coins' API.          |
| range  | string | YES | Time range for data aggregation. Supported values: 12h, 24h, 3d, 7d, 30d, 90d, 180d, 1y. |


# 合约 - 爆仓与清算 - 交易对清算地图


```
GET /api/futures/liquidation/map
```


该接口提供交易对清算地图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": {
    "data": {
      "103404": [
        [
          103394,//清算价格
          1465772.55,//清算强度
          10,//清算等级
          "h2"
        ]
      ],
      "103570": [
        [
          103543,
          1189582.29,
          10,
          "h3"
        ]
      ],
      "103653": [
        [
          103650,
          2609224.58,
          10,
          "h3"
        ]
      ],
}
```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。                   |
| range    | string | YES | 数据的时间范围（例如：1d,7d,30d)                                         |


# 合约 - 爆仓与清算 - 币种清算地图


```
GET /api/futures/liquidation/aggregated-map
```


该接口提供币种清算地图数据

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": {
    "data": [
      {
        "liqMapV2": {
          "103444": [
            [
              103444,//清算价格
              1465772.55,// 清算强度
              null,
              null
            ]
          ],
          "103568": [
            [
              103568,
              1361864.79,
              null,
              null
            ]
          ],
          "103692": [
            [
              103692,
              4429396.75,
              null,
              null
            ]
          ],
}
```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                          |
| ------ | ------ | --- | ------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。 |
| range  | string | YES | 数据的时间范围（例如：1d, 7d,30d）                      |


# 合约 - 爆仓与清算 - 清算最大痛点


```
GET /api/futures/liquidation/max-pain
```


该接口提供主流加密货币的清算“最大痛点”价格，以及清算强度。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "symbol": "BTC",//币种
      "price": 110625.1, //价格
      "long_max_pain_liq_level": 75677278.26,//多单最大痛点清算强度
      "long_max_pain_liq_price": 113046.71, //多单最大痛点清算价格
      "short_max_pain_liq_level": 44617473.19,
      "short_max_pain_liq_price": 109748.37
    
    {
      "symbol": "ETH",
      "price": 3914.14,
      "long_max_pain_liq_level": 34406421.23,
      "long_max_pain_liq_price": 3955.722,
      "short_max_pain_liq_level": 44375943.61,
      "short_max_pain_liq_price": 3820.002
    },
    {
      "symbol": "SOL",
      "price": 195.1,
      "long_max_pain_liq_level": 12467317.12,
      "long_max_pain_liq_price": 199.468,
      "short_max_pain_liq_level": 12927647.29,
      "short_max_pain_liq_price": 190.186
    },
    ....
  ]
}


```

 **Parameters:**
| 名称    | 类型     | 必填 | 描述                                              |
| ----- | ------ | -- | ----------------------------------------------- |
| range | string | NO | 数据时间间隔。支持的取值包括： 12h, 24h, 48h, 3d, 7d, 14d, 30d |


# 合约 - 订单薄 - 交易对挂单深度历史(±范围)


```
GET /api/futures/orderbook/ask-bids-history
```


该接口提供合约交易对的历史订单簿数据，包含指定价格范围内的买盘和卖盘挂单总量。

***缓存 / 更新频率:*** 5秒一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "bids_usd": 81639959.9338,        // 多单总金额（美元）
      "bids_quantity": 1276.645,        // 多单总数量
      "asks_usd": 78533053.6862,        // 空单总金额（美元）
      "asks_quantity": 1217.125,        // 空单总数量
      "time": 1714003200000             // 时间戳（毫秒）
    },
    {
      "bids_usd": 62345879.8821,
      "bids_quantity": 980.473,
      "asks_usd": 65918423.4715,
      "asks_quantity": 1021.644,
      "time": 1714089600000
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |
| range      | string  | NO  | 深度百分比（例如：0.25、0.5、0.75、1、2、3、5、10）。                           |


# 合约 - 订单薄 - 币种聚合挂单深度历史(±范围)


```
GET /api/futures/orderbook/aggregated-ask-bids-history
```


该接口提供合约币种聚合历史订单簿数据，包含指定价格范围内的买盘和卖盘挂单总量。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "aggregated_bids_usd": 12679537.0806,         // 聚合多单金额（美元）
      "aggregated_bids_quantity": 197.99861,        // 聚合多单数量
      "aggregated_asks_usd": 10985519.9268,         // 聚合空单金额（美元）
      "aggregated_asks_quantity": 170.382,          // 聚合空单数量
      "time": 1714003200000                         // 时间戳（毫秒）
    },
    {
      "aggregated_bids_usd": 18423845.1947,
      "aggregated_bids_quantity": 265.483,
      "aggregated_asks_usd": 17384271.5521,
      "aggregated_asks_quantity": 240.785,
      "time": 1714089600000
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                      |
| ------------- | ------- | --- | ------------------------------------------------------- |
| exchange_list | string  | YES | 需要聚合的交易所名称列表（例如：'ALL'，或 'Binance, OKX, Bybit'）。         |
| symbol        | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval      | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time    | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |
| range         | string  | NO  | 深度百分比（例如：0.25、0.5、0.75、1、2、3、5、10）。                     |


# 合约 - 订单薄 - 订单薄历史(热力图)


```
GET /api/futures/orderbook/history
```


该接口提供合约交易的历史挂单深度数据，支持以热力图形式可视化展示。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
    "code": "0",
    "msg": "success",
    "data": [
        [
            1723611600,
            [
                [
                    56420, //价格
                    4.777 //数量
                ],
                [
                    40300,
                    2.191
                ]
            ],
            [
                [
                    56420,
                    4.777
                ],
                [
                    40300,
                    2.191
                ]
            ]
        ]
    ],
    "success": true
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                                |
| ---------- | ------- | --- | ----------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。     |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表            |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d.              |
| limit      | integer | YES | 每次请求返回的数据条数。默认值为 100，最大值为 100.  支持的最大历史范围：1分钟为3天，5分钟为15天，其余为150天。 |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                      |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                      |


# 合约 - 订单薄 - 大额订单薄


```
GET /api/futures/orderbook/large-limit-order
```


该接口提供合约交易中当前订单簿中的大额限价挂单数据。(阈值: BTC ≥ 100万, ETH ≥ 50万, Other ≥ 5万)

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
  "code": "0",
  "msg": "success",
  "data":[
  {
    "id": 2912620961,
    "exchange_name": "Binance",            // 交易所名称
    "symbol": "BTCUSDT",                   // 交易对
    "base_asset": "BTC",                   // 基础币种
    "quote_asset": "USDT",                 // 计价币种

    "limit_price": 56932,                  // 委托价格
    "start_time": 1722964242000,           // 委托开始时间（毫秒）
    "start_quantity": 28.39774,            // 初始数量
    "start_usd_value": 1616740.1337,       // 初始价值（USD）

    "current_quantity": 18.77405,          // 当前剩余数量
    "current_usd_value": 1068844.21,       // 当前剩余价值（USD）
    "current_time": 1722964272000,         // 当前时间（毫秒）

    "executed_volume": 0,                  // 成交数量
    "executed_usd_value": 0,               // 成交价值（USD）
    "trade_count": 0,                      // 成交笔数

    "order_side": 2,                       // 委托方向：1-卖单，2-买单
    "order_state": 1                       // 委托状态：1-挂单中，2-已完成，3-已撤销
  }
]
}
```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |


# 合约 - 订单薄 - 大额订单薄历史


```
GET /api/futures/orderbook/large-limit-order-history
```


该接口提供合约交易中已完成的大额限价挂单的历史数据。(阈值: BTC ≥ 100万, ETH ≥ 50万, Other ≥ 5万)

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "id": 2895605135,
      "exchange_name": "Binance",               // 交易所名称
      "symbol": "BTCUSDT",                      // 交易对
      "base_asset": "BTC",                      // 基础币种
      "quote_asset": "USDT",                    // 计价币种
      "price": 89205.9,                         // 委托价格
      "start_time": 1745287309000,              // 委托开始时间 (毫秒)
      "start_quantity": 25.779,                 // 初始委托数量
      "start_usd_value": 2299638.8961,          // 初始委托价值 (USD)
      "current_quantity": 25.779,               // 当前剩余数量
      "current_usd_value": 2299638.8961,        // 当前剩余价值 (USD)
      "current_time": 1745287309000,            // 当前时间 (毫秒)
      "executed_volume": 0,                     // 累计成交量
      "executed_usd_value": 0,                  // 累计成交价值 (USD)
      "trade_count": 0,                         // 累计成交笔数
      "order_side": 1,                          // 委托方向：1-卖单，2-买单
      "order_state": 2,                         // 委托状态：0-未开始，1-挂单中，2-已完成，3-已撤销
      "order_end_time": 1745287328000           // 完成或撤销订单的结束时间 (毫秒)
    },
    ...
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                           |
| ---------- | ------- | --- | ------------------------------------------------------------ |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。      |
| start_time | integer | YES | 开始时间戳（毫秒）（例如：1641522717000）。                                 |
| end_time   | integer | YES | 结束时间戳（毫秒）（例如：1641522717000）。                                 |
| state      | integer | YES | 订单状态说明如下：  1：进行中（In Progress）  2：已完成（Finish）  3：已撤销（Revoke）  |


# 合约 - Hyperliquid 仓位 - Hyperliquid 鲸鱼提醒


```
GET /api/hyperliquid/whale-alert
```


该接口提供 Hyperliquid 平台上实时的鲸鱼交易提醒，突出展示价值超过 100 万美元的大额持仓变动。（最多可返回 200 条最新数据）

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "user": "0x3fd4444154242720c0d0c61c74a240d90c127d33", // 用户地址
      "symbol": "ETH",                                     // 币种
      "position_size": 12700,                              // 仓位大小（正数为多，负数为空）
      "entry_price": 1611.62,                              // 开仓价格
      "liq_price": 527.2521,                               // 强平价格
      "position_value_usd": 21003260,                      // 仓位价值（美元）
      "position_action": 2,                                // 仓位操作类型（1: 开仓，2: 平仓）
      "create_time": 1745219517000                         // 开仓时间（时间戳，毫秒）
    },
    {
      "user": "0x1cadadf0e884ac5527ae596a4fc1017a4ffd4e2c",
      "symbol": "BTC",
      "position_size": 33.54032,
      "entry_price": 87486.2,
      "liq_price": 44836.8126,
      "position_value_usd": 2936421.4757,
      "position_action": 2,
      "create_time": 1745219477000
    }
  ]
}

```


# 合约 - Hyperliquid 仓位 - Hyperliquid 鲸鱼持仓


```
GET /api/hyperliquid/whale-position
```


该接口提供 Hyperliquid 平台上鲸鱼的持仓数据，筛选出价值超过 100 万美元的持仓信息。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "user": "0x20c2d95a3dfdca9e9ad12794d5fa6fad99da44f5", // 用户地址
      "symbol": "ETH",                                   // 币种
      "position_size": -44727.1273,                      // 仓位大小（正为做多，负为做空）
      "entry_price": 2249.7,                             // 开仓价格
      "mark_price": 1645.8,                              // 当前标记价格
      "liq_price": 2358.2766,                            // 强平价格
      "leverage": 25,                                    // 杠杆倍数
      "margin_balance": 2943581.7019,                    // 保证金余额（USD）
      "position_value_usd": 73589542.5467,               // 仓位价值（USD）
      "unrealized_pnl": 27033236.424,                    // 未实现盈亏（USD）
      "funding_fee": -3107520.7373,                      // 资金费用（USD）
      "margin_mode": "cross",                            // 保证金模式（cross 表示全仓）
      "create_time": 1741680802000,                      // 开仓时间（时间戳，毫秒）
      "update_time": 1745219966000                       // 更新时间（时间戳，毫秒）
    },
    {
      "user": "0xf967239debef10dbc78e9bbbb2d8a16b72a614eb",
      "symbol": "BTC",
      "position_size": -800,
      "entry_price": 84931.3,
      "mark_price": 87427,
      "liq_price": 92263.798,
      "leverage": 15,
      "margin_balance": 4812076.3896,
      "position_value_usd": 69921600,
      "unrealized_pnl": -1976493.6819,
      "funding_fee": 14390.0346,
      "margin_mode": "isolated",                         // 保证金模式（isolated 表示逐仓）
      "create_time": 1743982804000,
      "update_time": 1745219969000
    }
  ]
}

```


# 合约 - Hyperliquid 仓位 - Hyperliquid 仓位


```
GET /api/hyperliquid/position
```


该接口提供 Hyperliquid 上的仓位数据，包括每个账户的用户地址、仓位大小、保证金余额和未实现盈亏。

***缓存/ 更新频率 :*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                     // 状态码（0 表示成功）
  "data": {
    "total_pages": 10,          // 仓位数据的总页数
    "current_page": 1,            // 当前返回的页码
    "list": [
      {
        "user": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",     // 用户钱包地址
        "symbol": "BTC",           // 交易对（币种）
        "position_size": -2683.14, // 仓位大小（正数为做多，负数为做空）
        "entry_price": 111459.6,   // 开仓价格
        "mark_price": 116638,      // 当前标记价格
        "liq_price": 150629.52,    // 强平价格
        "leverage": 10,            // 杠杆倍数
        "margin_balance": 31263482.07,        // 保证金余额（美元）
        "position_value_usd": 312634820.77,   // 仓位价值（美元）
        "unrealized_pnl": -13572345.06,       // 未实现盈亏（美元）
        "funding_fee": -12534553.66,          // 资金费用（美元）
        "margin_mode": "cross",               // 保证金模式（"cross" 表示全仓，"isolated" 表示逐仓）
        "create_time": 1752152867098,         // 开仓时间（时间戳，毫秒）
        "update_time": 1758162698266          // 更新时间（时间戳，毫秒）
      }
    ]
  }
}

```

 **Parameters:**
| 名称           | 类型      | 必填  | 描述                                           |
| ------------ | ------- | --- | -------------------------------------------- |
| symbol       | string  | YES | 交易币种（例如：BTC）。通过 supported-coins API 获取支持的币种。 |
| current_page | integer | NO  | 返回当前页码                                       |


# 合约 - Hyperliquid 仓位 - Hyperliquid 用户仓位


```
GET /api/hyperliquid/user-position
```


该接口提供 Hyperliquid 用户持仓数据，包括 保证金、可提现余额以及当前持有的资产仓位。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": {
    "margin_summary": {
      "account_value": 179250588.896754,
      "total_ntl_pos": 679947383.29435,
      "total_raw_usd": -500696794.397596,
      "total_margin_used": 131236726.65887
    },
    "cross_margin_summary": {
      "account_value": 179250588.896754,
      "total_ntl_pos": 679947383.29435,
      "total_raw_usd": -500696794.397596,
      "total_margin_used": 131236726.65887
    },
    "cross_maintenance_margin_used": 19278725.276478,
    "withdrawable": 46429612.237884,
    "asset_positions": [
      {
        "type": "oneWay",
        "position": {
          "coin": "BTC",
          "szi": 1000,
          "leverage": {
            "type": "cross",
            "value": 5
          },
          "entry_px": 91506.7,
          "position_value": 86265000,
          "unrealized_pnl": -5643767.29312,
          "return_on_equity": -0.3083797767,
          "max_leverage": 5,
          "cum_funding": {
            "all_time": -104732.177706,
            "since_open": 87958.233078,
            "since_change": 84811.539668
          }
        }
      },
      }
    ]
  }
}
```

 **Parameters:**
| 名称           | 类型     | 必填  | 描述   |
| ------------ | ------ | --- | ---- |
| user_address | string | YES | 用户地址 |


# 合约 - 主动买卖 - 交易对主动买卖历史


```
GET /api/futures/v2/taker-buy-sell-volume/history
```


该接口提供合约市场中交易对的主动买入与卖出成交量的历史数据

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1750183200000,
      "taker_buy_volume_usd": "414120141.0714",
      "taker_sell_volume_usd": "350417509.655"
    },
    {
      "time": 1750186800000,
      "taker_buy_volume_usd": "882509979.6914",
      "taker_sell_volume_usd": "808715578.4428"
    },
    {
      "time": 1750190400000,
      "taker_buy_volume_usd": "572589140.5759",
      "taker_sell_volume_usd": "571005164.3247"
    },
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 合约 - 主动买卖 - 币种主动买卖历史


```
GET /api/futures/aggregated-taker-buy-sell-volume/history
```


该接口提供合约市场中币种的主动买入与卖出成交量的历史数据

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741622400000, // 时间戳（毫秒）
      "aggregated_buy_volume_usd": 968834542.3787, // 聚合买单成交量（美元）
      "aggregated_sell_volume_usd": 1054582654.8138 // 聚合卖单成交量（美元）
    },
    {
      "time": 1741626000000,
      "aggregated_buy_volume_usd": 1430620763.2041,
      "aggregated_sell_volume_usd": 1559166911.2821
    },
    {
      "time": 1741629600000,
      "aggregated_buy_volume_usd": 1897261721.0129,
      "aggregated_sell_volume_usd": 2003812276.7812
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                      |
| ------------- | ------- | --- | ------------------------------------------------------- |
| exchange_list | string  | YES | 选择聚合的交易所（例如： 'Binance,OKX,Bybit'）。                      |
| symbol        | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval      | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time    | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |
| unit          | string  | NO  | 返回数据的单位，可选值为 'usd' 或 'coin'。                            |


# 合约 - 主动买卖 - 足迹图历史(90天)


```
GET /api/futures/volume/footprint-history
```


该接口提供合约市场的历史足迹图数据，包括每个价格水平的主动买入和主动卖出。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",  // 状态码（0 表示成功）
  "data": [
    [
      1757808000,  // 时间戳（秒）
      [
        [
          115765,        // 起始价格
          115770,        // 结束价格
          3.223,         // 主动买入量
          9.906,         // 主动卖出量
          373118.1958,   // 主动买入量（计价币种）
          1146773.5391,  // 主动卖出量（计价币种）
          373118.1958,   // 主动买入量（USDT）
          1146773.5391,  // 主动卖出量（USDT）
          193,           // 主动买入成交笔数
          153            // 主动卖出成交笔数
        ],
        [
          115770,
          115775,
          3.315,         // 主动买入量
          0.528,         // 主动卖出量
          383782.5569,   // 主动买入量（计价币种）
          61127.0686,    // 主动卖出量（计价币种）
          383782.5569,   // 主动买入量（USDT）
          61127.0686,    // 主动卖出量（USDT）
          40,            // 主动买入成交笔数
          64             // 主动卖出成交笔数
        ]
      ]
    ]
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                     |
| ---------- | ------- | --- | ------------------------------------------------------ |
| exchange   | string  | YES | 合约交易所名称（支持 Binance、OKX、Bybit、Hyperliquid）              |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。  |
| interval   | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                       |
| start_time | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                           |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                           |


# 合约 - 主动买卖 - 累计成交量差值（CVD）


```
GET /api/futures/cvd/history
```


该接口提供合约交易所交易对的历史累计成交量差值（CVD）数据，包含随时间变化的主动买入量（taker buy）与主动卖出量（taker sell）。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1762254000000,
      "taker_buy_vol": 350281007.0211,
      "taker_sell_vol": 325339470.9493,
      "cum_vol_delta": 24941536.0718
    },
    {
      "time": 1762257600,
      "taker_buy_vol": 286399814.1275,
      "taker_sell_vol": 347409544.4937,
      "cum_vol_delta": -36068194.2944
    },
    {
      "time": 1762261200,
      "taker_buy_vol": 299952362.4807,
      "taker_sell_vol": 323978642.5934,
      "cum_vol_delta": -60094474.4071
    },
  ]
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                                                                      |
| ---------- | ------- | --- | ------------------------------------------------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。                                             |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。                                                   |
| interval   | string  | YES | Time interval for data aggregation. Supported values: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 6h, 8h, 12h, 1d, 1w |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                                                        |
| start_time | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                                                            |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                                                            |


# 合约 - 主动买卖 - 聚合累计成交量差值（CVD）


```
GET /api/futures/aggregated-cvd/history
```


该接口提供合约交易所币种的历史 CVD 数据，是该币种的多个交易对聚合数据。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1762254000000,
      "agg_taker_buy_vol": 461937243.0899,
      "agg_taker_sell_vol": 415687343.2719,
      "cum_vol_delta": 46249899.818
    },
    {
      "time": 1762257600,
      "agg_taker_buy_vol": 390296231.4588,
      "agg_taker_sell_vol": 469137635.9107,
      "cum_vol_delta": -32591504.6339
    },
    {
      "time": 1762261200,
      "agg_taker_buy_vol": 461378798.1884,
      "agg_taker_sell_vol": 450407935.7885,
      "cum_vol_delta": -21620642.234
    },
  ]
}
```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                                          |
| ------------- | ------- | --- | --------------------------------------------------------------------------- |
| exchange_list | string  | YES | 以逗号分隔的交易所名称（例如："binance, okx, bybit"）。可通过 support-exchange-pair 接口获取支持的交易所。 |
| symbol        | string  | YES | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。                                  |
| interval      | integer | YES | 每次请求的结果数量。默认值：1000，最大值：1000。                                                |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                            |
| start_time    | integer | NO  | 起始时间戳（单位：毫秒，例如：1641522717000）。                                              |
| end_time      | integer | NO  | 结束时间戳（单位：毫秒，例如：1641522717000）。                                              |
| unit          | string  | NO  | 返回数据的单位，可以选择 'usd' 或 'coin'。                                                |


# 现货 - 交易市场 - 支持的币种


```
GET /api/spot/supported-coins
```


该接口用于查询 CoinGlass 支持的所有现货币种。

***缓存 / 更新频率:*** 每 1 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    "BTC",
    "ETH",
    "USDT",
    "BNB",
    "SOL",
    "USDC",
    ...
  ]
}
```


# 现货 - 交易市场 - 支持的交易所和交易对


```
GET /api/spot/supported-exchange-pairs
```


该接口允许你查询 CoinGlass 上支持的所有现货交易所及其对应的交易对。

***缓存 / 更新频率:*** 每 1 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "Binance": [ // 交易所名称
      {
        "instrument_id": "BTCUSD_USDT",// 现货交易对
        "base_asset": "BTC",// 基础币种
        "quote_asset": "USDT"// 计价币种
      },
      {
        "instrument_id": "ETHUSD_USDT",
        "base_asset": "ETH",
        "quote_asset": "USDT"
      },
      ....
      ],
    "Bitget": [
      {
        "instrument_id": "AAVE:USD",
        "base_asset": "AAVE",
        "quote_asset": "USD"
      },
      {
        "instrument_id": "ADAUSD",
        "base_asset": "ADA",
        "quote_asset": "USD"
      },
      ...
      ]
      ...
   }
}
```


# 现货 - 交易市场 - 币种市场列表


```
GET /api/spot/coins-markets
```


该接口提供现货币种的相关指标信息。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0", 
  "msg": "success", 
  "data": [
    {
      "symbol": "BTC", // 币种代号，如 BTC 表示比特币
      "current_price": 87500, // 当前币价（美元）

      "market_cap": 1735007745495.3037, // 当前市值（美元）

      // 各周期内价格变化（单位：美元）
      "price_change_5m": 101.5, // 最近5分钟价格变化
      "price_change_15m": 46.18, // 最近15分钟价格变化
      "price_change_30m": -77.22, // 最近30分钟价格变化
      "price_change_1h": 12.56, // 最近1小时价格变化
      "price_change_4h": 147.75, // 最近4小时价格变化
      "price_change_12h": 147.75, // 最近12小时价格变化
      "price_change_24h": 2799.99, // 最近24小时价格变化
      "price_change_1w": 2989.69, // 最近1周价格变化

      // 各周期内价格变化百分比（单位：%）
      "price_change_percent_5m": 0.12, // 最近5分钟价格涨跌幅
      "price_change_percent_15m": 0.05, // 最近15分钟价格涨跌幅
      "price_change_percent_30m": -0.09, // 最近30分钟价格涨跌幅
      "price_change_percent_1h": 0.01, // 最近1小时价格涨跌幅
      "price_change_percent_4h": 0.17, // 最近4小时价格涨跌幅
      "price_change_percent_12h": 0.17, // 最近12小时价格涨跌幅
      "price_change_percent_24h": 3.31, // 最近24小时价格涨跌幅
      "price_change_percent_1w": 3.54, // 最近1周价格涨跌幅

      // 各周期内成交量（单位：美元）
      "volume_usd_1h": 129491564.6994, // 最近1小时成交总量
      "volume_usd_5m": 11056683.8336, // 最近5分钟成交总量
      "volume_usd_15m": 50625331.2542, // 最近15分钟成交总量
      "volume_usd_30m": 80070296.0794, // 最近30分钟成交总量
      "volume_usd_4h": 580775143.5162, // 最近4小时成交总量
      "volume_usd_12h": 2663308247.353, // 最近12小时成交总量
      "volume_usd_24h": 3719093876.3834, // 最近24小时成交总量
      "volume_usd_1w": 16801739001.0272, // 最近1周成交总量

      // 各周期内成交量变化值（单位：美元，与上一个周期比较）
      "volume_change_usd_1h": -35317032.6336, // 成交量变化：最近1小时与前一小时相比
      "volume_change_usd_5m": -110911976.2243,
      "volume_change_usd_15m": -59017725.7105,
      "volume_change_usd_30m": -39864985.2519,
      "volume_change_usd_4h": -1084757627.3629,
      "volume_change_usd_12h": 1624238611.116,
      "volume_change_usd_24h": 1967797576.5416,
      "volume_change_usd_1w": -23396586539.5365,

      // 各周期内成交量变化百分比（单位：%）
      "volume_change_percent_1h": -21.43, // 成交量变化百分比：1小时
      "volume_change_percent_5m": -90.93,
      "volume_change_percent_15m": -53.83,
      "volume_change_percent_30m": -33.24,
      "volume_change_percent_4h": -65.13,
      "volume_change_percent_12h": 156.32,
      "volume_change_percent_24h": 112.36,
      "volume_change_percent_1w": 3.54,

      // 各周期内主动买入成交量（单位：美元）
      "buy_volume_usd_1h": 55687151.2164,
      "buy_volume_usd_5m": 4634327.6087,
      "buy_volume_usd_15m": 20222399.059,
      "buy_volume_usd_30m": 33140975.4441,
      "buy_volume_usd_4h": 278174843.6339,
      "buy_volume_usd_12h": 1410854413.4688,
      "buy_volume_usd_24h": 1923920264.0666,
      "buy_volume_usd_1w": 8116673333.4846,

      // 各周期内主动卖出成交量（单位：美元）
      "sell_volume_usd_1h": 73804413.4829,
      "sell_volume_usd_5m": 6422356.2248,
      "sell_volume_usd_15m": 30402932.1951,
      "sell_volume_usd_30m": 46929320.6352,
      "sell_volume_usd_4h": 302600299.8822,
      "sell_volume_usd_12h": 1252453833.8841,
      "sell_volume_usd_24h": 1795173612.3167,
      "sell_volume_usd_1w": 8685065667.5425,

      // 主动成交量净流入（= 买入 - 卖出），单位：美元
      "volume_flow_usd_1h": -18117262.2665,
      "volume_flow_usd_5m": -1788028.6161,
      "volume_flow_usd_15m": -10180533.1361,
      "volume_flow_usd_30m": -13788345.1911,
      "volume_flow_usd_4h": -24425456.2483,
      "volume_flow_usd_12h": 158400579.5847,
      "volume_flow_usd_24h": 128746651.7499,
      "volume_flow_usd_1w": -568392334.0579
    }
  ]
}

```

 **Parameters:**
| 名称       | 类型      | 必填 | 描述            |
| -------- | ------- | -- | ------------- |
| per_page | integer | NO | 每页返回的结果数量。    |
| page     | integer | NO | 分页的页码，默认值为 1。 |


# 现货 - 交易市场 - 交易对市场列表


```
GET /api/spot/pairs-markets
```


该接口提供现货交易对的相关指标信息。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                         
  "msg": "success",                  
  "data": [
    {
      "symbol": "BTC/USDT",                // 交易对
      "exchange_name": "Binance",          // 交易所名称
      "current_price": 87503.55,           // 当前价格

      "price_change_1h": 99.55,            // 1小时价格变动
      "price_change_percent_1h": 0.11,     // 1小时价格变动百分比
      "volume_usd_1h": 54425251.2426,      // 1小时交易量 (USD)
      "buy_volume_usd_1h": 29304086.0661,  // 1小时买入交易量 (USD)
      "sell_volume_usd_1h": 25121165.1759, // 1小时卖出交易量 (USD)
      "volume_change_usd_1h": -24851651.918,   // 1小时交易量变动 (USD)
      "volume_change_percent_1h": -31.35,  // 1小时交易量变动百分比
      "net_flows_usd_1h": 4182920.8902,    // 1小时净流入 (USD)

      "price_change_4h": 209.56,           // 4小时价格变动
      "price_change_percent_4h": 0.24,     // 4小时价格变动百分比
      "volume_usd_4h": 264625587.5144,     // 4小时交易量 (USD)
      "buy_volume_usd_4h": 137768056.2376, // 4小时买入交易量 (USD)
      "sell_volume_usd_4h": 126857531.2762, // 4小时卖出交易量 (USD)
      "volume_change_4h": -526166190.0218, // 4小时交易量变动 (USD)
      "volume_change_percent_4h": -66.54,  // 4小时交易量变动百分比
      "net_flows_usd_4h": 10910524.9614,   // 4小时净流入 (USD)

      "price_change_12h": 2925.55,         // 12小时价格变动
      "price_change_percent_12h": 3.46,    // 12小时价格变动百分比
      "volume_usd_12h": 1212930000.2011,   // 12小时交易量 (USD)
      "buy_volume_usd_12h": 662857153.6506, // 12小时买入交易量 (USD)
      "sell_volume_usd_12h": 550072846.5499, // 12小时卖出交易量 (USD)
      "volume_change_12h": 842092388.1946, // 12小时交易量变动 (USD)
      "volume_change_percent_12h": 227.08, // 12小时交易量变动百分比
      "net_flows_usd_12h": 112784307.1007, // 12小时净流入 (USD)

      "price_change_24h": 2735.79,         // 24小时价格变动
      "price_change_percent_24h": 3.23,    // 24小时价格变动百分比
      "volume_usd_24h": 1585522232.603,    // 24小时交易量 (USD)
      "buy_volume_usd_24h": 843617569.7248, // 24小时买入交易量 (USD)
      "sell_volume_usd_24h": 741904662.8776, // 24小时卖出交易量 (USD)
      "volume_change_24h": 873336140.8197, // 24小时交易量变动 (USD)
      "volume_change_percent_24h": 122.63, // 24小时交易量变动百分比
      "net_flows_usd_24h": 101712906.8472, // 24小时净流入 (USD)

      "price_change_1w": 3057.83,          // 1周价格变动
      "price_change_percent_1w": 3.62,     // 1周价格变动百分比
      "volume_usd_1w": 6808077059.7062,    // 1周交易量 (USD)
      "buy_volume_usd_1w": 3374037733.8429, // 1周买入交易量 (USD)
      "sell_volume_usd_1w": 3434039325.8627, // 1周卖出交易量 (USD)
      "volume_change_usd_1w": -11208235126.1193, // 1周交易量变动 (USD)
      "volume_change_percent_1w": -62.21,  // 1周交易量变动百分比
      "net_flows_usd_1w": -60001592.0198   // 1周净流入 (USD)
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                            |
| ------ | ------ | --- | --------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC）。可通过 'support-coins' 接口获取支持的币种列表。 |


# 现货 - 交易市场 - 交易对价格历史(K线)


```
GET /api/spot/price/history
```


该接口提供加密货币在指定时间周期内的历史开盘价、最高价、最低价和收盘价（OHLC）数据。

***缓存 / 更新频率:*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741690800000,
      "open": 81808.25,//开盘价
      "high": 82092.34,//最高价
      "low": 81400,//最低价
      "close": 81720.34,//关盘价
      "volume_usd": 96823535.5724
    },
    {
      "time": 1741694400000,
      "open": 81720.33,
      "high": 81909.69,
      "low": 81017,
      "close": 81225.5,
      "volume_usd": 150660424.1863
    },
```

 **Parameters:**
| 名称         | 类型     | 必填  | 描述                                                          |
| ---------- | ------ | --- | ----------------------------------------------------------- |
| exchange   | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所。 |
| symbol     | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口查询支持的交易对。       |
| interval   | string | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit      | string | NO  | 每次请求返回的数据条数。默认值：1000，最大值：1000。                              |
| start_time | string | NO  | 起始时间戳，单位为毫秒（例如：1641522717000）。                              |
| end_time   | string | NO  | 结束时间戳，单位为毫秒（例如：1641522717000）。                              |


# 现货 - 订单薄 - 交易对挂单深度历史(±范围)


```
GET /api/spot/orderbook/ask-bids-history
```


该接口提供现货交易对的历史订单簿数据，包含指定价格范围内的买盘和卖盘挂单总量。

***缓存 / 更新频率:*** 5秒一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "bids_usd": 81639959.9338,        // 多单总金额（美元）
      "bids_quantity": 1276.645,        // 多单总数量
      "asks_usd": 78533053.6862,        // 空单总金额（美元）
      "asks_quantity": 1217.125,        // 空单总数量
      "time": 1714003200000             // 时间戳（毫秒）
    },
    {
      "bids_usd": 62345879.8821,
      "bids_quantity": 980.473,
      "asks_usd": 65918423.4715,
      "asks_quantity": 1021.644,
      "time": 1714089600000
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |
| range      | string  | NO  | 深度百分比（例如：0.25、0.5、0.75、1、2、3、5、10）。                           |


# 现货 - 订单薄 - 币种聚合挂单深度历史(±范围)


```
GET /api/spot/orderbook/aggregated-ask-bids-history
```


该接口提供现货币种聚合历史订单簿数据，包含指定价格范围内的买盘和卖盘挂单总量。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "aggregated_bids_usd": 12679537.0806,         // 聚合多单金额（美元）
      "aggregated_bids_quantity": 197.99861,        // 聚合多单数量
      "aggregated_asks_usd": 10985519.9268,         // 聚合空单金额（美元）
      "aggregated_asks_quantity": 170.382,          // 聚合空单数量
      "time": 1714003200000                         // 时间戳（毫秒）
    },
    {
      "aggregated_bids_usd": 18423845.1947,
      "aggregated_bids_quantity": 265.483,
      "aggregated_asks_usd": 17384271.5521,
      "aggregated_asks_quantity": 240.785,
      "time": 1714089600000
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                      |
| ------------- | ------- | --- | ------------------------------------------------------- |
| exchange_list | string  | YES | 需要聚合的交易所名称列表（例如：'ALL'，或 'Binance, OKX, Bybit'）。         |
| symbol        | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval      | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time    | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |
| range         | string  | NO  | 深度百分比（例如：0.25、0.5、0.75、1、2、3、5、10）。                     |


# 现货 - 订单薄 - 订单薄历史(热力图)


```
GET /api/spot/orderbook/history
```


该接口提供现货交易的历史挂单深度数据，支持以热力图形式可视化展示。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
    "code": "0",
    "msg": "success",
    "data": [
        [
            1723611600,
            [
                [
                    56420, //价格
                    4.777 //数量
                ],
                [
                    40300,
                    2.191
                ]
            ],
            [
                [
                    56420,
                    4.777
                ],
                [
                    40300,
                    2.191
                ]
            ]
        ]
    ],
    "success": true
}
```

 **Parameters:**
| 名称         | 类型     | 必填  | 描述                                                                |
| ---------- | ------ | --- | ----------------------------------------------------------------- |
| exchange   | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。     |
| symbol     | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表            |
| interval   | string | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d.              |
| limit      | string | YES | 每次请求返回的数据条数。默认值为 100，最大值为 100 . 支持的最大历史范围：1分钟为3天，5分钟为15天，其余为150天。 |
| start_time | string | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                      |
| end_time   | string | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                      |


# 现货 - 订单薄 - 大额订单薄


```
GET /api/spot/orderbook/large-limit-order
```


该接口提供现货交易中当前订单簿中的大额限价挂单数据。(阈值: BTC ≥ 35万, ETH ≥ 25万, Other ≥ 1万)

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
  "code": "0",
  "msg": "success",
  "data":[
  {
    "id": 2536823422,
    "exchange_name": "Binance",            // 交易所名称
    "symbol": "BTCUSDT",                   // 交易对
    "base_asset": "BTC",                   // 基础币种
    "quote_asset": "USDT",                 // 计价币种

    "limit_price": 56932,                  // 委托价格
    "start_time": 1722964242000,           // 委托开始时间（毫秒）
    "start_quantity": 28.39774,            // 初始数量
    "start_usd_value": 1616740.1337,       // 初始价值（USD）

    "current_quantity": 18.77405,          // 当前剩余数量
    "current_usd_value": 1068844.21,       // 当前剩余价值（USD）
    "current_time": 1722964272000,         // 当前时间（毫秒）

    "executed_volume": 0,                  // 成交数量
    "executed_usd_value": 0,               // 成交价值（USD）
    "trade_count": 0,                      // 成交笔数

    "order_side": 2,                       // 委托方向：1-卖单，2-买单
    "order_state": 1                       // 委托状态：1-挂单中，2-已完成，3-已撤销
  }
]
}
```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol   | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |


# 现货 - 订单薄 - 大额订单薄历史


```
GET /api/spot/orderbook/large-limit-order-history
```


该接口提供现货交易中已完成的大额限价挂单的历史数据。(阈值: BTC ≥ 35万, ETH ≥ 25万, Other ≥ 1万)

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "id": 2895605135,
      "exchange_name": "Binance",               // 交易所名称
      "symbol": "BTCUSDT",                      // 交易对
      "base_asset": "BTC",                      // 基础币种
      "quote_asset": "USDT",                    // 计价币种
      "price": 89205.9,                         // 委托价格
      "start_time": 1745287309000,              // 委托开始时间 (毫秒)
      "start_quantity": 25.779,                 // 初始委托数量
      "start_usd_value": 2299638.8961,          // 初始委托价值 (USD)
      "current_quantity": 25.779,               // 当前剩余数量
      "current_usd_value": 2299638.8961,        // 当前剩余价值 (USD)
      "current_time": 1745287309000,            // 当前时间 (毫秒)
      "executed_volume": 0,                     // 累计成交量
      "executed_usd_value": 0,                  // 累计成交价值 (USD)
      "trade_count": 0,                         // 累计成交笔数
      "order_side": 1,                          // 委托方向：1-卖单，2-买单
      "order_state": 2,                         // 委托状态：0-未开始，1-挂单中，2-已完成，3-已撤销
      "order_end_time": 1745287328000           // 完成或撤销订单的结束时间 (毫秒)
    },
    ...
  ]
}

```

 **Parameters:**
| 名称         | 类型     | 必填  | 描述                                                           |
| ---------- | ------ | --- | ------------------------------------------------------------ |
| exchange   | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表 |
| symbol     | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。      |
| start_time | string | YES | 开始时间戳（毫秒）（例如：1641522717000）。                                 |
| end_time   | string | YES | 结束时间戳（毫秒）（例如：1641522717000）。                                 |
| state      | string | YES | 订单状态说明如下：  1：进行中（In Progress）  2：已完成（Finish）  3：已撤销（Revoke）  |


# 现货 - 主动买卖 - 交易对主动买卖历史


```
GET /api/spot/taker-buy-sell-volume/history
```


该接口提供现货市场中交易对的主动买入与卖出成交量的历史数据

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741622400000, // 时间戳（毫秒）
      "taker_buy_volume_usd": "10551.033", // 主动买入成交量（美元）
      "taker_sell_volume_usd": "11308" // 主动卖出成交量（美元）
    },
    {
      "time": 1741626000000,
      "taker_buy_volume_usd": "15484.245",
      "taker_sell_volume_usd": "16316.118"
    },
    {
      "time": 1741629600000,
      "taker_buy_volume_usd": "20340.501",
      "taker_sell_volume_usd": "18977.660"
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 现货 - 主动买卖 - 币种主动买卖历史


```
GET /api/spot/aggregated-taker-buy-sell-volume/history
```


该接口提供现货市场中币种的主动买入与卖出成交量的历史数据

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741622400000, // 时间戳（毫秒）
      "aggregated_buy_volume_usd": 968834542.3787, // 聚合买单成交量（美元）
      "aggregated_sell_volume_usd": 1054582654.8138 // 聚合卖单成交量（美元）
    },
    {
      "time": 1741626000000,
      "aggregated_buy_volume_usd": 1430620763.2041,
      "aggregated_sell_volume_usd": 1559166911.2821
    },
    {
      "time": 1741629600000,
      "aggregated_buy_volume_usd": 1897261721.0129,
      "aggregated_sell_volume_usd": 2003812276.7812
    }
  ]
}

```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                      |
| ------------- | ------- | --- | ------------------------------------------------------- |
| exchange_list | string  | YES | 选择聚合的交易所（例如： 'Binance, OKX, Bybit'）。                    |
| symbol        | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。             |
| interval      | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| start_time    | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |
| unit          | string  | NO  | 返回数据的单位，可选值为 'usd' 或 'coin'。                            |


# 现货 - 主动买卖 - 足迹图历史


```
GET /api/spot/volume/footprint-history
```


该接口提供现货市场的历史足迹图数据，包括每个价格水平的主动买入和主动卖出。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ❌   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",  // 状态码（0 表示成功）
  "data": [
    [
      1757808000,  // 时间戳（秒）
      [
        [
          115765,        // 起始价格
          115770,        // 结束价格
          3.223,         // 主动买入量
          9.906,         // 主动卖出量
          373118.1958,   // 主动买入量（计价币种）
          1146773.5391,  // 主动卖出量（计价币种）
          373118.1958,   // 主动买入量（USDT）
          1146773.5391,  // 主动卖出量（USDT）
          193,           // 主动买入成交笔数
          153            // 主动卖出成交笔数
        ],
        [
          115770,
          115775,
          3.315,         // 主动买入量
          0.528,         // 主动卖出量
          383782.5569,   // 主动买入量（计价币种）
          61127.0686,    // 主动卖出量（计价币种）
          383782.5569,   // 主动买入量（USDT）
          61127.0686,    // 主动卖出量（USDT）
          40,            // 主动买入成交笔数
          64             // 主动卖出成交笔数
        ]
      ]
    ]
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                     |
| ---------- | ------- | --- | ------------------------------------------------------ |
| exchange   | string  | YES | 现货交易所名称（支持 Binance、OKX、Bybit、Coinbase）                 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。  |
| interval   | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                       |
| start_time | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                           |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                           |


# 现货 - 主动买卖 - 累计成交量差值（CVD）


```
GET /api/spot/cvd/history
```


该接口提供合约交易所交易对的历史累计成交量差值（CVD）数据，包含随时间变化的主动买入量（taker buy）与主动卖出量（taker sell）。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1762254000000,
      "taker_buy_vol": 350281007.0211,
      "taker_sell_vol": 325339470.9493,
      "cum_vol_delta": 24941536.0718
    },
    {
      "time": 1762257600,
      "taker_buy_vol": 286399814.1275,
      "taker_sell_vol": 347409544.4937,
      "cum_vol_delta": -36068194.2944
    },
    {
      "time": 1762261200,
      "taker_buy_vol": 299952362.4807,
      "taker_sell_vol": 323978642.5934,
      "cum_vol_delta": -60094474.4071
    },
  ]
}
```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                          |
| ---------- | ------- | --- | ----------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol     | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。     |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| unit       | string  | NO  | 返回数据的单位，可以选择 'usd' 或 'coin'。                                |


# 现货 - 主动买卖 - 聚合累计成交量差值（CVD）


```
GET /api/spot/aggregated-cvd/history
```


该接口提供现货交易所币种的历史 CVD 数据，是该币种的多个交易对聚合数据。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1762254000000,
      "agg_taker_buy_vol": 461937243.0899,
      "agg_taker_sell_vol": 415687343.2719,
      "cum_vol_delta": 46249899.818
    },
    {
      "time": 1762257600,
      "agg_taker_buy_vol": 390296231.4588,
      "agg_taker_sell_vol": 469137635.9107,
      "cum_vol_delta": -32591504.6339
    },
    {
      "time": 1762261200,
      "agg_taker_buy_vol": 461378798.1884,
      "agg_taker_sell_vol": 450407935.7885,
      "cum_vol_delta": -21620642.234
    },
  ]
}
```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                                          |
| ------------- | ------- | --- | --------------------------------------------------------------------------- |
| exchange_list | string  | YES | 以逗号分隔的交易所名称（例如："binance, okx, bybit"）。可通过 support-exchange-pair 接口获取支持的交易所。 |
| symbol        | string  | YES | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。                                  |
| interval      | string  | YES | 每次请求的结果数量。默认值：1000，最大值：1000。                                                |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                                            |
| start_time    | integer | NO  | 起始时间戳（单位：毫秒，例如：1641522717000）。                                              |
| end_time      | integer | NO  | 结束时间戳（单位：毫秒，例如：1641522717000）。                                              |
| unit          | string  | NO  | 返回数据的单位，可以选择 'usd' 或 'coin'。                                                |


# 期权 - 期权最大痛点


```
GET /api/option/max-pain
```


该接口提供期权的最大痛点相关数据。

***缓存/ 更新频率 :*** 1分钟一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "date": "250422",                                   // 日期（YYMMDD 格式）
      "call_open_interest_market_value": 1616749.22,      // 看涨期权市场价值（美元）
      "put_open_interest": 512.5,                         // 看跌期权未平仓合约数量（张）
      "put_open_interest_market_value": 49687.62,         // 看跌期权市场价值（美元）
      "max_pain_price": "84000",                          // 最大痛苦点价格
      "call_open_interest": 953.7,                        // 看涨期权未平仓合约数量（张）
      "call_open_interest_notional": 83519113.56,         // 看涨期权名义价值（美元）
      "put_open_interest_notional": 44881569.13           // 看跌期权名义价值（美元）
    },
    {
      "date": "250423",                                 
      "call_open_interest_market_value": 2274700.52,     ）
      "put_open_interest": 1204.3,                       
      "put_open_interest_market_value": 374536.01,       
      "max_pain_price": "85000",                         
      "call_open_interest": 1302.2,                      
      "call_open_interest_notional": 114040373.53,       
      "put_open_interest_notional": 105465691.73          
    }
  ]
}

```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                             |
| -------- | ------ | --- | ------------------------------ |
| symbol   | string | YES | 交易币种（例如：BTC、ETH）               |
| exchange | string | YES | 交易所名称（例如：Deribit、Binance、OKX）。 |


# 期权 - 期权相关数据


```
GET /api/option/info
```


该接口提供不同交易所期权的持仓量与成交量等详细信息。

***缓存/ 更新频率 :*** 30秒更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "exchange_name": "All",                           // 交易所名称
      "open_interest": 361038.78,                       // 未平仓合约数量（张）
      "oi_market_share": 100,                           // 持仓占有率（%）
      "open_interest_change_24h": 2.72,                 // 24 小时未平仓合约变化（%）
      "open_interest_usd": 31623069708.138245,          // 未平仓合约价值（美元）
      "volume_usd_24h": 2764676957.0569425,             // 24 小时交易量（美元）
      "volume_change_percent_24h": 303.1                // 24 小时交易量变化（%）
    },
    {
      "exchange_name": "Deribit",                       // 交易所名称
      "open_interest": 262641.9,                        // 未平仓合约数量（张）
      "oi_market_share": 72.74,                         // 持仓占有率（%）
      "open_interest_change_24h": 2.57,                 // 24 小时未平仓合约变化（%）
      "open_interest_usd": 23005403973.349,             // 未平仓合约价值（美元）
      "volume_usd_24h": 2080336672.709                  // 24 小时交易量（美元）
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                |
| ------ | ------ | --- | ----------------- |
| symbol | string | YES | 交易币种（例如：BTC、ETH）。 |


# 期权 - 交易所持仓历史


```
GET /api/option/exchange-oi-history
```


该接口提供不同交易所期权的历史持仓量数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                 
  "msg": "success",                            
  "data": [
    {
      "time_list": [1691460000000, ...],       // 时间戳数组（毫秒）
      "price_list": [29140.9, ...],            // 对应时间点的价格数组
      "data_map": {                            // 各交易所的未平仓合约数据
        "huobi": [15167.03527, ...],           // Huobi 交易所的未平仓合约  数据
        "gate": [23412.723, ...],              // Gate 交易所的 未平仓合约 数据
        ...
      }
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                                                         |
| ------ | ------ | --- | -------------------------------------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC、ETH）。                                                          |
| unit   | string | YES | 返回数据的单位说明。支持的单位取决于所选交易对。例如，若交易对为 BTC，则可选择 USD 或 BTC；若为 ETH，则可选择 USD 或 ETH。 |
| range  | string | YES | 数据的时间范围。支持的取值包括：1h、4h、12h、all。                                             |


# 期权 - 交易所成交量历史


```
GET /api/option/exchange-vol-history
```


该接口提供各大交易所期权的历史成交量数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                 
  "msg": "success",                            
  "data": [
    {
      "time_list": [1691460000000, ...],       // 时间戳数组（毫秒）
      "price_list": [29140.9, ...],            // 对应时间点的价格数组
      "data_map": {                            // 各交易所的成交额数据
        "huobi": [15167.03527, ...],           // Huobi 交易所的 成交额数据
        "gate": [23412.723, ...],              // Gate 交易所的成交额数据
        ...
      }
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                                                         |
| ------ | ------ | --- | -------------------------------------------------------------------------- |
| symbol | string | YES | 交易币种（例如：BTC、ETH）。                                                          |
| unit   | string | YES | 返回数据的单位说明。支持的单位取决于所选交易对。例如，若交易对为 BTC，则可选择 USD 或 BTC；若为 ETH，则可选择 USD 或 ETH。 |


# 链上 - 交易所数据 - 交易所资产透明度


```
GET /api/exchange/assets
```


此接口提供交易所钱包的资产持有数据，包括钱包地址、资产余额、美元估值以及每种资产的实时价格信息。

***缓存/ 更新频率 :*** 1小时一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "wallet_address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
      "balance": 248597.54,
      "balance_usd": 21757721869.92,
      "symbol": "BTC",
      "assets_name": "Bitcoin",
      "price": 87521.87117346626
    },
    {
      "wallet_address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
      "balance": 139456.08,
      "balance_usd": 12205457068.12,
      "symbol": "BTC",
      "assets_name": "Bitcoin",
      "price": 87521.87117346626
    },
```

 **Parameters:**
| 名称       | 类型     | 必填  | 描述                                                            |
| -------- | ------ | --- | ------------------------------------------------------------- |
| exchange | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| per_page | string | NO  | 每页返回的数据数量。                                                    |
| page     | string | NO  | 用于分页的页码，默认值为 1。                                               |


# 链上 - 交易所数据 - 交易所余额列表


```
GET /api/exchange/balance/list
```


该接口提供各交易所的资产余额数据，包括 1 天、7 天和 30 天内的余额变化百分比信息。

***缓存/ 更新频率 :*** 1小时一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                 
  "msg": "success",                            
  "data": [
    {
      "exchange_name": "Coinbase",               // 交易所名称
      "total_balance": 716590.351233,            // 总余额
      "balance_change_1d": 638.797302,           // 24小时余额变动
      "balance_change_percent_1d": 0.09,         // 24小时余额变动百分比 (%)
      "balance_change_7d": 799.967408,           // 7天余额变动
      "balance_change_percent_7d": 0.11,         // 7天余额变动百分比 (%)
      "balance_change_30d": -29121.977486,       // 30天余额变动
      "balance_change_percent_30d": -3.91        // 30天余额变动百分比 (%)
    },
    {
      "exchange_name": "Binance",                // 交易所名称
      "total_balance": 582344.497738,            // 总余额
      "balance_change_1d": 505.682778,           // 24小时余额变动
      "balance_change_percent_1d": 0.09,         // 24小时余额变动百分比 (%)
      "balance_change_7d": -3784.88544,          // 7天余额变动
      "balance_change_percent_7d": -0.65,        // 7天余额变动百分比 (%)
      "balance_change_30d": 3753.870055,         // 30天余额变动
      "balance_change_percent_30d": 0.65         // 30天余额变动百分比 (%)
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                |
| ------ | ------ | --- | ----------------- |
| symbol | string | YES | 交易币种（例如：BTC、ETH）。 |


# 链上 - 交易所数据 - 交易所余额图表


```
GET /api/exchange/balance/chart
```


该接口提供各交易所资产余额随时间变化的历史图表数据，并附带相应的币种价格数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                 
  "msg": "success",                            
  "data": [
    {
      "time_list": [1691460000000, ...],       // 时间戳数组（毫秒）
      "price_list": [29140.9, ...],            // 对应时间点的价格数组
      "data_map": {                            // 各交易所的余额数据
        "huobi": [15167.03527, ...],           // Huobi 交易所的余额数据
        "gate": [23412.723, ...],              // Gate 交易所的余额数据
        ...
      }
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                |
| ------ | ------ | --- | ----------------- |
| symbol | string | YES | 交易币种（例如：BTC、ETH）。 |


# 链上 - 链上转账 - 交易所链上转账（ERC-20）


```
GET /api/exchange/chain/tx/list
```


该接口提供基于 ERC-20 协议的交易所链上转账数据。

***缓存/ 更新频率 :*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "transaction_hash": "0xb8d08182d2de176ac42dceba9ff82a7a5fe650c1e56285d6810daac9561ff9dc", // 交易哈希
      "asset_symbol": "USDT",                       // 资产符号
      "amount_usd": 9998.5,                         // 美元金额
      "asset_quantity": 9998.5,                     // 数量
      "exchange_name": "Coinbase",                 // 交易所名称
      "transfer_type": 1,                           // 转账类型：1: 转入, 2: 转出, 3: 内部转账
      "from_address": "0x16c6897438c4f0c7894862d884549e8564c4025f", // 转出地址
      "to_address": "0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",   // 转入地址
      "transaction_time": 1745224211                // 交易时间（时间戳，单位秒）
    },
    {
      "transaction_hash": "0x033c56cb05654f2c360235eff99c84f0eee9c6330fc7012930adfe0a88789c0f", // 交易哈希
      "asset_symbol": "MANA",                       // 资产符号
      "amount_usd": 6368.95196834,                  // 美元金额
      "asset_quantity": 20091.33113044,             // 数量
      "exchange_name": "Binance",                  // 交易所名称
      "transfer_type": 1,                           // 转账类型：1: 转入, 2: 转出, 3: 内部转账
      "from_address": "0x06fd4ba7973a0d39a91734bbc35bc2bcaa99e3b0", // 转出地址
      "to_address": "0x28c6c06298d514db089934071355e5743bf21d60",   // 转入地址
      "transaction_time": 1745224211                // 交易时间（时间戳，单位秒）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填 | 描述                                   |
| ---------- | ------- | -- | ------------------------------------ |
| symbol     | string  | NO | 只支持传入在以太坊（ETH）网络上支持的 ERC-20 协议代币的符号。 |
| start_time | integer | NO | 开始时间戳（毫秒）（例如：1641522717000）。         |
| min_usd    | number  | NO | 最小转账金额筛选，单位为美元（USD）。                 |
| per_page   | integer | NO | 每页返回的结果数量。                           |
| page       | integer | NO | 分页的页码，默认值为 1。                        |


# 链上 - 链上转账 - 大额转账


```
GET /api/chain/v2/whale-transfer
```


该接口提供近半年内金额不低于 1000 万美元 的大额链上转账，支持 Bitcoin、Ethereum、Tron、Ripple、Dogecoin、Litecoin、Polygon、Algorand、Bitcoin Cash 和 Solana 等主流区块链。

***缓存 / 更新频率:*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0", // 状态码："0" 表示成功
  "data": [
    {
       "transaction_hash":    "0x910ade7323eae57017c1894078ff1ce319fe908709ba185d81147588ceb06dcc",//转账哈希
      "amount_usd": "18403606.873493258", // 转账金额（美元）
      "asset_quantity": "10081.791421235566", // 转账数量
      "asset_symbol": "WETH", // 资产符号
      "from": "unknown wallet", // 发送方
      "to": "unknown wallet", // 接收方
      "blockchain_name": "ethereum", // 区块链名称
      "block_height": 22402402, // 区块高度
      "block_timestamp": 1746265043 // 区块时间
    },
    {
      "transaction_hash": "7b1fa0327a1e68fbcc397eee0a75ae8ced8c19c08d32f5cfd2ec5d3ba04e59fe",//转账哈希
      "amount_usd": "18413630.94247512", // 转账金额（美元）
      "asset_quantity": "10087.28276721801", // 转账数量
      "asset_symbol": "WETH", // 资产符号
      "from": "unknown wallet", // 发送方
      "to": "unknown wallet", // 接收方
      "blockchain_name": "ethereum", // 区块链名称
      "block_height": 22402402, // 区块高度
      "block_timestamp": 1746265043 // 区块时间
    }
    ....
  ]
}
```

 **Parameters:**
| 名称         | 类型     | 必填 | 描述                                         |
| ---------- | ------ | -- | ------------------------------------------ |
| symbol     | string | NO | 交易币种（例如：BTC）。通过 support-coins API 获取支持的币种。 |
| start_time | string | NO | 起始时间戳（单位：毫秒，例如：1641522717000）。             |
| end_time   | string | NO | 结束时间戳（单位：毫秒，例如：1641522717000）。             |


# 链上 - 代币 - 代币解锁列表


```
GET /api/coin/unlock-list
```


该接口返回代币解锁数据以及即将到来的解锁计划。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0", // 返回状态码
  "data": [ // 代币列表
    {
      "symbol": "GT", // 代币符号
      "name": "GateToken", // 代币名称
      "symbol_logo_url": "https://cdn.coinglasscdn.com/static/img/coins/gt.jpg", // 图标链接
      "price": 10.377, // 最新价格
      "price_change_percent_24h": 2.67, // 24小时涨跌幅
      "market_cap": 1217683606.698, // 市值
      "total_supply": 300000000, // 总供应量
      "fully_diluted_valuation": 3115642754.097, // 全稀释估值
      "total_locked": 74868300, // 锁仓数量
      "circulating_supply": 117344474, // 流通供应量
      "total_unlocked": 162691500, // 已解锁数量
      "next_unlock_date": 1765152000000, // 下次解锁时间
      "next_unlock_tokens": 48600, // 下次解锁数量
      "next_unlock_of_circulating": 0.041416522093745974, // 占流通量比例
      "next_unlock_of_supply": 0.0162 // 占总供应量比例
    },
    ....
  ]
}

```

 **Parameters:**
| 名称       | 类型      | 必填 | 描述     |
| -------- | ------- | -- | ------ |
| per_page | integer | NO | 每页返回数量 |
| page     | integer | NO | 页码     |


# 链上 - 代币 - 代币解锁详情


```
GET /api/coin/vesting
```


该接口返回指定代币的详细锁仓数据及即将到来的解锁计划。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0", // 返回状态码
  "data": {
    "market_cap": 9366969675.066894, // 市值
    "symbol": "HYPE", // 代币符号
    "total_untracked": 451880000, // 未追踪数量
    "listing_date": 1732838400000, // 上线时间
    "vesting_start_date": 1732838400000, // 锁仓开始时间
    "total_supply": 999835210, // 总供应量
    "total_locked": 236721940, // 总锁仓量
    "total_unlocked": 310986320, // 总解锁量
    "vesting_end_date": 1859068800000, // 锁仓结束时间
    "next_unlock": { // 下次解锁信息
      "date": 1764720000000, // 解锁时间
      "next_unlock_token_amount": "216580" // 解锁数量
    },
    "circulating_supply": 270772999, // 流通量
    "total_untracked_percent": 45.188, // 未追踪占比
    "allocations": [ // 分配列表
      {
        "is_untracked": true, // 是否未追踪
        "allocation_of_supply": 38.888, // 占总供应比例
        "name": "Future Emissions & Community Rewards", // 分配名称
        "token_amount": "388880000" // 代币数量
      },
      {
        "is_untracked": false, // 是否未追踪
        "allocation_of_supply": 31, // 占总供应比例
        "name": "Genesis Distribution", // 分配名称
        "unlock_type": "nonlinear", // 解锁方式
        "token_amount": "310000000", // 代币数量
        "tge_unlocked_token_amount": "310000000", // TGE 解锁数量
        "unlocked_token_amount": "310000000", // 已解锁数量
        "tge_unlock_percent": 100 // TGE 解锁比例
      },
      {
        "is_untracked": false, // 是否未追踪
        "vesting_start_date": 1764374400000, // 锁仓开始时间
        "locked_token_amount": "236721940", // 锁仓数量
        "vesting_end_date": 1859068800000, // 锁仓结束时间
        "tge_unlocked_token_amount": "0", // TGE 解锁数量
        "next_unlock": { // 下次解锁信息
          "date": 1764720000000, // 解锁时间
          "next_unlock_token_amount": "216580" // 解锁数量
        },
        "unlocked_token_amount": "866320", // 已解锁数量
        "tge_unlock_percent": 0, // TGE 解锁比例
        "vesting_duration_value": 3, // 锁仓时长数值
        "vesting_duration_type": "year", // 锁仓时长单位
        "allocation_of_supply": 23.8, // 占总供应比例
        "unlock_frequency_type": "day", // 解锁频率类型
        "name": "Core Contributors", // 分配名称
        "unlock_type": "linear", // 解锁方式
        "token_amount": "238000000", // 代币数量
        "unlock_frequency_value": 1 // 解锁频率数值
      },
      {
        "is_untracked": true, // 是否未追踪
        "allocation_of_supply": 6, // 占总供应比例
        "name": "Hyper Foundation", // 分配名称
        "token_amount": "60000000" // 代币数量
      },
      {
        "is_untracked": true, // 是否未追踪
        "allocation_of_supply": 0.3, // 占总供应比例
        "name": "Community Grants", // 分配名称
        "token_amount": "3000000" // 代币数量
      },
      {
        "is_untracked": false, // 是否未追踪
        "allocation_of_supply": 0.012, // 占总供应比例
        "name": "HIP-2", // 分配名称
        "unlock_type": "nonlinear", // 解锁方式
        "token_amount": "120000", // 代币数量
        "tge_unlocked_token_amount": "120000", // TGE 解锁数量
        "unlocked_token_amount": "120000", // 已解锁数量
        "tge_unlock_percent": 100 // TGE 解锁比例
      }
    ],
    "fully_diluted_valuation": 34587740013.671524, // 全稀释估值
    "name": "Hyperliquid", // 项目名称
    "max_supply": 1000000000, // 最大供应量
    "chart": [ // 图表数据
      {
        "date": 1732838400000, // 图表时间
        "allocations": [ // 图表分配
          {
            "name": "Genesis Distribution", // 名称
            "unlocked_percent": 31, // 解锁比例
            "token_amount": "310000000", // 代币数量
            "unlocked_token_amount": "310000000" // 解锁数量
          },
          {
            "name": "Core Contributors", // 名称
            "unlocked_percent": 0, // 解锁比例
            "token_amount": "238000000", // 代币数量
            "unlocked_token_amount": "0" // 解锁数量
          },
          {
            "name": "HIP-2", // 名称
            "unlocked_percent": 0.012, // 解锁比例
            "token_amount": "120000", // 代币数量
            "unlocked_token_amount": "120000" // 解锁数量
          }
        ],
        "is_tge": true, // 是否为 TGE
        "unlocked_percent": 31.012, // 总解锁比例
        "unlocked_token_amount": "310120000" // 总解锁数量
      }
    ],
    "untracked_allocation_names": [ // 未追踪分配名称列表
      "Community Grants",
      "Future Emissions & Community Rewards",
      "Hyper Foundation"
    ]
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                                 |
| ------ | ------ | --- | -------------------------------------------------- |
| symbol | string | YES | 交易代币（例如 HYPE）。可通过 “token-unlock-list” 接口获取支持的代币列表。 |


# ETF - 比特币 ETF - 比特币ETF列表


```
GET /api/etf/bitcoin/list
```


该接口提供比特币交易型基金（ETF）的关键信息列表

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "ticker": "GBTC",                                // ETF标识符
      "fund_name": "Grayscale Bitcoin Trust ETF",      // 基金名称
      "region": "us",                                  // 所属地区
      "market_status": "early_trading",                // 市场状态 (open/closed/early_trading等)
      "primary_exchange": "ARCX",                      // 主交易所
      "cik_code": "0001588489",                        // CIK代码 (唯一标识符)
      "fund_type": "Spot",                             // 基金类型 (Spot/ETF/Futures等)
      "list_date": 1424822400000,                      // 上市日期 (时间戳，单位毫秒)
      "shares_outstanding": "240750100",               // 流通股数
      "aum_usd": "16137543152.34",                     // 管理资产总值 (USD)
      "management_fee_percent": "1.5",                 // 管理费率 (%)
      "last_trade_time": 1745225312958,                // 最新成交时间 (时间戳，单位毫秒)
      "last_quote_time": 1745225389483,                // 最新计价时间 (时间戳，单位毫秒)
      "volume_quantity": 1068092,                      // 成交量
      "volume_usd": 71485902.2312,                     // 成交量 (USD)
      "price_change_usd": 0.47,                        // 价格变化 (USD)
      "price_change_percent": 0.71,                    // 价格变化 (%)
      "asset_details": {
        "net_asset_value_usd": 67.03,                  // 净值 (USD)
        "premium_discount_percent": 0.09,              // 溢价/折价率 (%)
        "btc_holding": 190124.5441,                    // BTC余额
        "btc_change_percent_24h": 0,                   // 24小时BTC变化 (%)
        "btc_change_24h": -7.8136,                     // 24小时BTC变化量
        "btc_change_percent_7d": -0.32,                // 7天BTC变化 (%)
        "btc_change_7d": -615.563,                     // 7天BTC变化量
        "update_date": "2025-04-17"                    // 更新时间
      },
      "update_timestamp": 1745224505000                // 数据更新时间 (时间戳，单位毫秒)
    }
  ]
}

```


# ETF - 比特币 ETF - 香港ETF流入流出历史


```
GET /api/hk-etf/bitcoin/flow-history
```


该接口提供香港市场中比特币ETF的资金流入流出历史数据。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "timestamp": 1714435200000,                     // 日期（时间戳，单位毫秒）
      "flow_usd": 247866000,                          // 总资金流入（USD）
      "price_usd": 63842.4,                           // 当日BTC价格（USD）
      "etf_flows": [                                  // ETF资金流明细
        {
          "etf_ticker": "CHINAAMC",                   // ETF代码
          "flow_usd": 123610690                       // 该ETF资金流入（USD）
        },
        {
          "etf_ticker": "HARVEST",                    // ETF代码
          "flow_usd": 63138000                        // 该ETF资金流入（USD）
        },
        {
          "etf_ticker": "BOSERA&HASHKEY",             // ETF代码
          "flow_usd": 61117310                        // 该ETF资金流入（USD）
        }
      ]
    },
    {
      "timestamp": 1714608000000,                     // 日期（时间戳，单位毫秒）
      "flow_usd": 10095060,                           // 总资金流入（USD）
      "price_usd": 58307.7,                           // 当日BTC价格（USD）
      "etf_flows": [
        {
          "etf_ticker": "CHINAAMC",                   // ETF代码
          "flow_usd": 3053490                         // 该ETF资金流入（USD）
        },
        {
          "etf_ticker": "HARVEST",                    // ETF代码
          "flow_usd": 5022000                         // 该ETF资金流入（USD）
        },
        {
          "etf_ticker": "BOSERA&HASHKEY",             // ETF代码
          "flow_usd": 2019570                         // 该ETF资金流入（USD）
        }
      ]
    }
  ]
}

```


# ETF - 比特币 ETF - ETF净资产历史


```
GET /api/etf/bitcoin/net-assets/history
```


该接口提供比特币交易所交易基金（ETF）的历史净资产数据。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "net_assets_usd": 51671409241.39,         // 净资产总额（USD）
      "change_usd": 655300000,                  // 当日资金变化（USD）
      "timestamp": 1704931200000,               // 日期（时间戳，单位毫秒）
      "price_usd": 46337.8                      // 当日BTC价格（USD）
    },
    {
      "net_assets_usd": 51874409241.39,         // 净资产总额（USD）
      "change_usd": 203000000,                  // 当日资金变化（USD）
      "timestamp": 1705017600000,               // 日期（时间戳，单位毫秒）
      "price_usd": 42788.9                      // 当日BTC价格（USD）
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填 | 描述                    |
| ------ | ------ | -- | --------------------- |
| ticker | string | NO | ETF 代码（例如：GBTC、IBIT）。 |


# ETF - 比特币 ETF - ETF流入流出历史


```
GET /api/etf/bitcoin/flow-history
```


该接口提供比特币ETF的历史资金流入流出数据，包括每日的净流入和净流出（以美元计）、收盘价格，以及按ETF代码划分的资金流明细。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "timestamp": 1704931200000,                   // 日期（时间戳，单位毫秒）
      "flow_usd": 655300000,                         // 当日总资金流入（USD）
      "price_usd": 46663,                            // 当日BTC现价（USD）
      "etf_flows": [                                 // 各ETF的资金流入详情
        {
          "etf_ticker": "GBTC",                      // ETF代码
          "flow_usd": -95100000                      // 资金流出（USD）
        },
        {
          "etf_ticker": "IBIT",                      // ETF代码
          "flow_usd": 111700000                      // 资金流入（USD）
        },
        {
          "etf_ticker": "FBTC",                      // ETF代码
          "flow_usd": 227000000                      // 资金流入（USD）
        }
      ]
    }
  ]
}

```


# ETF - 比特币 ETF - ETF溢价/折扣历史


```
GET /api/etf/bitcoin/premium-discount/history
```


该接口提供比特币ETF的溢价或折扣率的历史数据，包括各ETF代码的净资产价值（NAV）、市场价格，以及对应的溢价/折扣百分比。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                   
  "msg": "success",                              
  "data": [
    {
      "timestamp": 1706227200000,                 // 日期（时间戳，单位为毫秒）
      "list": [
        {
          "ticker": "GBTC",                       // ETF代码
          "nav_usd": 37.51,                        // 净资产价值（USD）
          "market_price_usd": 37.51,               // 市场价格（USD）
          "premium_discount_details": 0            // 溢价/折扣百分比
        },
        {
          "ticker": "IBIT",                       // ETF代码
          "nav_usd": 23.94,                        // 净资产价值（USD）
          "market_price_usd": 23.99,               // 市场价格（USD）
          "premium_discount_details": 0.22         // 溢价/折扣百分比
        },
        {
          "ticker": "FBTC",                       // ETF代码
          "nav_usd": 36.720807,                    // 净资产价值（USD）
          "market_price_usd": 36.75,               // 市场价格（USD）
          "premium_discount_details": 0.0795       // 溢价/折扣百分比
        }
      ]
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填 | 描述                       |
| ------ | ------ | -- | ------------------------ |
| ticker | string | NO | ETF 代码 (例如, GBTC, IBIT). |


# ETF - 比特币 ETF - 比特币ETF历史


```
GET /api/etf/bitcoin/history
```


该接口提供比特币ETF的历史数据，涵盖每个ETF代码的关键指标信息，包括市场价格、净资产价值（NAV）、溢价/折扣百分比、流通股数以及总净资产等。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                                
  "msg": "success",                           
  "data": [
    {
      "assets_date": 1706486400000,           // 净资产对应日期（时间戳，毫秒）
      "btc_holdings": 496573.8166,            // BTC 持仓数量
      "market_date": 1706486400000,           // 市场价格对应日期（时间戳，毫秒）
      "market_price": 38.51,                  // 市场价格（USD）
      "name": "Grayscale Bitcoin Trust",      // ETF 名称
      "nav": 38.57,                           // 单位净值（Net Asset Value，USD）
      "net_assets": 21431132778.35,           // 总净资产（USD）
      "premium_discount": -0.16,              // 溢价/折扣百分比（负值为折扣）
      "shares_outstanding": 555700100,        // 已发行份额
      "ticker": "GBTC"                        // ETF 代码
    }
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                          |
| ------ | ------ | --- | --------------------------- |
| ticker | string | YES | ETF 股票代码 (例如., GBTC, IBIT). |


# ETF - 比特币 ETF - ETF价格历史


```
GET /api/etf/bitcoin/price/history
```


该接口提供比特币ETF的历史价格数据，包括每个数据点的开盘价、最高价、最低价、收盘价（OHLC）以及交易量信息。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                         
  "msg": "success",                   
  "data": [
    {
      "time": 1731056460000,     // 时间戳（毫秒）
      "open": 60.47,                  // 开盘价
      "high": 60.47,                  // 最高价
      "low": 60.47,                   // 最低价
      "close": 60.47,                 // 收盘价
      "volume": 100                   // 成交量
    },
    ...
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                          |
| ------ | ------ | --- | --------------------------- |
| ticker | string | YES | ETF 股票代码 (例如., GBTC, IBIT). |
| range  | string | YES | 数据的时间范围（ (例如, 1d,7d,all).   |


# ETF - 比特币 ETF - 比特币ETF详情


```
GET /api/etf/bitcoin/detail
```


该接口提供某只比特币交易所交易基金（ETF）的详细信息

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": {
    "ticker_info": {
      "id": 1,                                         // ETF ID
      "ticker": "GBTC",                                // ETF 代码
      "name": "Grayscale Bitcoin Trust ETF",           // ETF 名称
      "market": "stocks",                              // 市场类型
      "region": "us",                                  // 地区
      "primary_exchange": "ARCX",                      // 主要交易所
      "fund_type": "ETV",                              // 产品类型
      "active": "true",                                // 是否活跃
      "currency_name": "usd",                          // 货币名称
      "cik_code": "0001588489",                        // CIK 编号
      "composite_figi": "BBG008748J88",                // 综合 FIGI
      "share_class_figi": "BBG008748J97",              // 股份类 FIGI
      "phone_number": "212-668-1427",                  // 联系电话
      "tag": "BTC",                                    // 资产标签
      "type2": "Spot",                                 // 产品类型2
      "address": {
        "address_1": "{\"address2\":\"4TH FLOOR\",\"city\":\"STAMFORD\",\"address1\":\"290 HARBOR DRIVE\",\"state\":\"CT\",\"postal_code\":\"06902\"}"
      },                                               // 公司地址（JSON 字符串，需解析）
      "sic_code": "6221",                              // SIC 编码
      "sic_description": "COMMODITY CONTRACTS BROKERS & DEALERS", // 行业描述
      "ticker_root": "GBTC",                           // Ticker Root
      "list_date": 1424822400000,                      // 上市日期（时间戳，毫秒）
      "share_class_shares_outstanding": "240750100",   // 流通份额
      "round_lot": "100",                              // 每手份额
      "status": 1,                                     // 状态
      "update_time": 1745224505000                     // 更新时间（时间戳，毫秒）
    },
    "market_status": "early_trading",                  // 市场状态
    "name": "Grayscale Bitcoin Trust ETF",             // ETF 名称
    "ticker": "GBTC",                                  // ETF 代码
    "type": "stocks",                                  // 市场类型
    "session": {
      "change": 2.22,                                  // 涨跌
      "change_percent": 3.309,                         // 涨跌幅（%）
      "early_trading_change": 2.22,                    // 盘前涨跌
      "early_trading_change_percent": 3.309,           // 盘前涨跌幅（%）
      "close": 67.09,                                  // 收盘价
      "high": 67.56,                                   // 最高价
      "low": 66.15,                                    // 最低价
      "open": 66.86,                                   // 开盘价
      "volume": 1068092,                               // 成交量
      "previous_close": 67.09,                         // 前收盘价
      "price": 69.31                                   // 最新价
    },
    "last_quote": {
      "last_updated": 1745226801708029700,             // 更新时间（纳秒级时间戳）
      "timeframe": "REAL-TIME",                        // 时间类型（如实时）
      "ask": 69.29,                                    // 卖价
      "ask_size": 34,                                  // 卖量
      "ask_exchange": 8,                               // 卖方交易所代码
      "bid": 69.18,                                    // 买价
      "bid_size": 3,                                   // 买量
      "bid_exchange": 11                               // 买方交易所代码
    },
    "last_trade": {
      "last_updated": 1745226730467043600,             // 更新时间（纳秒级时间戳）
      "timeframe": "REAL-TIME",                        // 时间类型（如实时）
      "id": "62879131651684",                          // 交易ID
      "price": 69.31,                                  // 成交价
      "size": 30,                                      // 成交量
      "exchange": 12,                                  // 交易所代码
      "conditions": [12, 37]                           // 交易条件数组
    },
    "performance": {
      "low_price_52week": 39.56,                       // 52周最低价
      "high_price_52week": 86.11,                      // 52周最高价
      "high_price_52week_date": 1734238800000,         // 52周最高价日期（时间戳）
      "low_price_52week_date": 1722744000000,          // 52周最低价日期（时间戳）
      "ydt_change_percent": -12.23,                    // 年初至今涨跌幅（%）
      "year_change_percent": 13.98,                    // 年涨跌幅（%）
      "avg_vol_usd_10d": 518227                        // 过去10日平均交易金额（美元）
    }
  }
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                   |
| ------ | ------ | --- | -------------------- |
| ticker | string | YES | 股票代码，例如：GBTC,IBIT... |


# ETF - 比特币 ETF - ETF资产管理规模


```
GET /api/etf/bitcoin/aum
```


该接口提供比特币交易所交易基金（ETF）的历史管理资产总额（AUM）数据。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1704153600000,
      "aum_usd": 0//该时间点的比特币ETF管理资产总额（以美元计）
    },
    {
      "time": 1704240000000,
      "aum_usd": 0
    },
    ....
  ]
}

```


# ETF - 以太坊 ETF - 以太坊ETF净资产历史


```
GET /api/etf/ethereum/net-assets/history
```


该接口提供以太坊为基础的交易所交易基金（ETF）的历史净资产数据。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "net_assets_usd": 51671409241.39,         // 净资产总额（USD）
      "change_usd": 655300000,                  // 当日资金变化（USD）
      "timestamp": 1704931200000,               // 日期（时间戳，单位毫秒）
      "price_usd": 1637.8                      // 当日ETH价格（USD）
    },
    {
      "net_assets_usd": 51874409241.39,         // 净资产总额（USD）
      "change_usd": 203000000,                  // 当日资金变化（USD）
      "timestamp": 1705017600000,               // 日期（时间戳，单位毫秒）
      "price_usd": 1637.8                      // 当日ETH价格（USD）
    }
  ]
}

```


# ETF - 以太坊 ETF - 以太坊ETF列表


```
GET /api/etf/ethereum/list
```


该接口提供以太坊交易所交易基金（ETF）的关键状态信息列表。

***缓存/ 更新频率 :*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "ticker": "ETHA",                                  // ETF 代码
      "name": "iShares Ethereum Trust ETF",              // ETF 名称
      "region": "us",                                    // 地区
      "market_status": "closed",                         // 市场状态
      "primary_exchange": "XNAS",                        // 主要交易所
      "cik_code": "0002000638",                          // CIK 代码
      "type": "Spot",                                    // 类型
      "market_cap": "544896000.00",                      // 市值
      "list_date": 1721692800000,                        // 上市日期
      "shares_outstanding": "28800000",                  // 已发行份额
      "aum": "",                                         // 管理资产总值
      "management_fee_percent": "0.25",                  // 管理费
      "last_trade_time": 1722988779939,                  // 最新交易时间
      "last_quote_time": 1722988799379,                  // 最新计价时间
      "volume_quantity": 5592645,                        // 交易量
      "volume_usd": 106447049.343,                       // 美元交易量
      "price": 18.92,                                    // 市场价格
      "price_change": 0.67,                              // 价格变化
      "price_change_percent": 3.67,                      // 价格变化百分比
      "asset_info": {
        "nav": 18.11,                                  // 净值
        "premium_discount": 0.77,                      // 溢价/折扣
        "holding_quantity": 237882.8821,                 // 持仓数量
        "change_percent_1d": 0,                        // 1天变化百分比
        "change_quantity_1d": 0,                         // 1天变化值
        "change_percent_7d": 56.69,                    // 7天变化百分比
        "change_quantity_7d": 86060.9115,                // 7天变化值
        "date": "2024-08-05"                           // 数据日期
      },
      "update_time": 1722995656637                       // 更新时间
    }
  ]
}

```


# ETF - 以太坊 ETF - 以太坊ETF流入流出历史


```
GET /api/etf/ethereum/flow-history
```


该接口提供以太坊交易所交易基金（ETF）的流入流出历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1721692800000,  // 时间戳
      "flow_usd": 106600000,  // 资金流入/流出（USD）
      "price_usd": 3438.09,  // 当前价格
      "etf_flows": [     // ETF 流动性列表
        {
          "etf_ticker": "ETHA",   // ETF 代码
          "flow_usd": 266500000     // 资金流动（USD）
        },
        {
          "etf_ticker": "FETH",  
          "flow_usd": 71300000
        },

      ]
    }
  ]
}

```


# ETF - 灰度基金 - 灰度持仓列表


```
GET /api/grayscale/holdings-list
```


该接口提供由 Grayscale Investments（灰度投资）管理的资产持仓列表

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "ETH",                                  // 币种代码，例如 ETH 代表以太坊
      "primary_market_price": 29.89,                    // 一级市场价格
      "secondary_market_price": 29.71,                  // 二级市场价格
      "premium_rate": -0.6,                             // 溢价率（单位：%）
      "holdings_amount": 2630007.61026,                 // 当前持仓数量（单位：币）
      "holdings_usd": 4290752215.8347797,               // 当前持仓总市值（单位：USD）
      "holdings_amount_change_30d": 0,                  // 最近30天持仓数量变化（单位：币）
      "holdings_amount_change_7d": 0,                   // 最近7天持仓数量变化（单位：币）
      "holdings_amount_change1d": 0,                    // 最近1天持仓数量变化（单位：币）
      "close_time": 1721422800000,                      // 收盘时间（时间戳，单位：毫秒）
      "update_time": 1745203812007                      // 更新时间（时间戳，单位：毫秒）
    },
    {
      "symbol": "ETC",                                  // 币种代码，例如 ETC 代表以太经典
      "primary_market_price": 11.99,                    // 一级市场价格
      "secondary_market_price": 6.63,                   // 二级市场价格
      "premium_rate": -44.7,                            // 溢价率，ETC 当前处于较大折价状态
      "holdings_amount": 11181376.733556,               // 持仓数量（单位：币）
      "holdings_usd": 181440200.2554132,                // 持仓总市值（单位：USD）
      "holdings_amount_change_30d": -20697.669828,      // 最近30天持仓数量变化（减少）
      "holdings_amount_change_7d": -4596.123672,        // 最近7天持仓数量变化（减少）
      "holdings_amount_change1d": 0,                    // 最近1天持仓数量变化
      "close_time": 1744923600000,                      // 收盘时间
      "update_time": 1745203812168                      // 更新时间
    }
  ]
}

```


# ETF - 灰度基金 - 灰度溢价历史


```
GET /api/grayscale/premium-history
```


该接口提供灰度投资信托（如GBTC、ETHE等）相对于其净值（NAV）的历史溢价或折价率数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "primary_market_price": [     // 一级市场价格列表
        0.14,
        0.14
        // ...
      ],
      "date_list": [                // 日期列表（时间戳）
        1380171600000,
        1380258000000
        // ...
      ],
      "secondary_market_price_list": [  // 二级市场价格列表
        0.57,
        0.53
        // ...
      ],
      "premium_rate_list": [          // 溢价率列表
        19.37,
        15.59
        // ...
      ]
    },
    // 其他数据项...
  ]
}

```

 **Parameters:**
| 名称     | 类型     | 必填  | 描述                                                                   |
| ------ | ------ | --- | -------------------------------------------------------------------- |
| symbol | string | YES | 支持的币种 : ETC, LTC, BCH, SOL, XLM, LINK, ZEC, MANA, ZEN, FIL, BAT, LPT |


# ETF - 索拉纳 ETF - 索拉纳ETF流入流出历史


```
GET /api/etf/solana//flow-history
```


该接口提供交易所交易基金（ETF）的索拉纳流入流出历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1762473600000,
      "flow_usd": 12700000,
      "price_usd": 155.2,
      "etf_flows": [
        {
          "etf_ticker": "BSOL",
          "flow_usd": 11700000
        },
        {
          "etf_ticker": "VSOL"
        },
        {
          "etf_ticker": "FSOL"
        },
        {
          "etf_ticker": "TSOL"
        },
        {
          "etf_ticker": "GSOL",
          "flow_usd": 1000000
        }
      ]
    },
  ]
}

```


# ETF - XRP ETF - XRP ETF流入流出历史


```
GET /api/etf/xrp//flow-history
```


该接口提供交易所交易基金（ETF）的XRP流入流出历史数据。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1763078400000,
      "flow_usd": 243050000,
      "price_usd": 2.3212,
      "etf_flows": [
        {
          "etf_ticker": "XRPC",
          "flow_usd": 243050000
        },
        {
          "etf_ticker": "XRPZ"
        },
        {
          "etf_ticker": "XRP"
        },
        {
          "etf_ticker": "GXRP"
        }
      ]
    },
  ]
}

```


# 指标 - 合约指标 - 币种RSI列表


```
GET /api/futures/rsi/list
```


该接口提供多种加密货币在不同时间周期下的相对强弱指数（RSI）数值。

***缓存/ 更新频率***: 10秒一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ❌   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "symbol": "BTC",                                  // 币种符号，例如 BTC 表示比特币
      "rsi_15m": 54.71,                                 // 15分钟相对强弱指数（RSI）
      "price_change_percent_15m": 0.04,                 // 15分钟内价格涨跌幅（单位：%）
      "rsi_1h": 71.91,                                  // 1小时相对强弱指数（RSI）
      "price_change_percent_1h": -0.23,                 // 1小时内价格涨跌幅（单位：%）
      "rsi_4h": 72.12,                                  // 4小时相对强弱指数（RSI）
      "price_change_percent_4h": -0.09,                 // 4小时内价格涨跌幅（单位：%）
      "rsi_12h": 62.33,                                 // 12小时相对强弱指数（RSI）
      "price_change_percent_12h": 2.72,                 // 12小时内价格涨跌幅（单位：%）
      "rsi_24h": 57.88,                                 // 24小时相对强弱指数（RSI）
      "price_change_percent_24h": 3.4,                  // 24小时内价格涨跌幅（单位：%）
      "rsi_1w": 52.04,                                  // 1周相对强弱指数（RSI）
      "price_change_percent_1w": 2.6,                   // 1周内价格涨跌幅（单位：%）
      "current_price": 87348.6                          // 当前价格（单位：USD）
    },
    {
      "symbol": "ETH",                                  // 币种符号，例如 ETH 表示以太坊
      "rsi_15m": 54.35,                                 // 15分钟相对强弱指数（RSI）
      "price_change_percent_15m": -0.13,                // 15分钟内价格涨跌幅
      "rsi_1h": 67.93,                                  // 1小时相对强弱指数（RSI）
      "price_change_percent_1h": -0.26,                 // 1小时内价格涨跌幅
      "rsi_4h": 63.6,                                   // 4小时相对强弱指数（RSI）
      "price_change_percent_4h": 0.2,                   // 4小时内价格涨跌幅
      "rsi_12h": 52.09,                                 // 12小时相对强弱指数（RSI）
      "price_change_percent_12h": 3.41,                 // 12小时内价格涨跌幅
      "rsi_24h": 45.03,                                 // 24小时相对强弱指数（RSI）
      "price_change_percent_24h": 3.27,                 // 24小时内价格涨跌幅
      "rsi_1w": 33.31,                                  // 1周相对强弱指数（RSI）
      "price_change_percent_1w": 3.45,                  // 1周内价格涨跌幅
      "current_price": 1641.36                          // 当前价格（单位：USD）
    }
  ]
}

```


# 指标 - 合约指标 - 交易对RSI


```
GET /api/futures/indicators/rsi
```


该接口用于获取交易对的 RSI（相对强弱指数） 数值。

***缓存/ 更新频率***：实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1677283200000,
      "rsi_value": 44.95356858
    },
    {
      "time": 1677369600000,
      "rsi_value": 50.81303592
    },
    ....
  ]
}
```

 **Parameters:**
| 名称          | 类型      | 必填  | 描述                                                          |
| ----------- | ------- | --- | ----------------------------------------------------------- |
| exchange    | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol      | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval    | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit       | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time  | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time    | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| window      | integer | NO  | 窗口大小 —— 定义用于指标计算的数据点数量（例如：RSI 的窗口为 14）。                     |
| series_type | string  | NO  | 价格类型 —— 指定计算中使用的价格类型。支持的取值：open、high、low、close。默认值：close。   |


# 指标 - 合约指标 - 移动平均线 (MA)


```
GET /api/futures/indicators/ma
```


该接口用于获取交易对的移动平均线(MA)。

***缓存/ 更新频率***：实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1677196800000,
      "ma_value": 24175.55
    },
    {
      "time": 1677283200000,
      "ma_value": 24133.28
    },
    ....
  ]
}
```

 **Parameters:**
| 名称          | 类型      | 必填  | 描述                                                          |
| ----------- | ------- | --- | ----------------------------------------------------------- |
| exchange    | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol      | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval    | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit       | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time  | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time    | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| window      | integer | NO  | 窗口大小 —— 定义用于指标计算的数据点数量（例如：MA 的窗口为 10）。                      |
| series_type | string  | NO  | 价格类型 —— 指定计算中使用的价格类型。支持的取值：open、high、low、close。默认值：close。   |


# 指标 - 合约指标 - 指数移动平均线 (EMA)


```
GET /api/futures/indicators/ema
```


该接口用于获取交易对的指数移动平均线 (EMA)。

***缓存/ 更新频率***：实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1677196800000,
      "ema_value": 24175.55
    },
    {
      "time": 1677283200000,
      "ema_value": 24133.28
    },
    ....
  ]
}
```

 **Parameters:**
| 名称          | 类型      | 必填  | 描述                                                          |
| ----------- | ------- | --- | ----------------------------------------------------------- |
| exchange    | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol      | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval    | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit       | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time  | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time    | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| window      | integer | NO  | 窗口大小 —— 定义用于指标计算的数据点数量（例如：EMA 的窗口为 10）。                     |
| series_type | string  | NO  | 价格类型 —— 指定计算中使用的价格类型。支持的取值：open、high、low、close。默认值：close。   |


# 指标 - 合约指标 - 布林带指标 (BOLL)


```
GET /api/futures/indicators/boll
```


该接口用于获取交易对的布林带指标 (BOLL)。

***缓存/ 更新频率***：实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1677196800000,
      "mb_value": 24175.544,
      "ub_value": 25207.098,
      "lb_value": 23143.99
    },
    {
      "time": 1677283200000,
      "mb_value": 24133.278,
      "ub_value": 25291.164,
      "lb_value": 22975.392
    },
    ....
  ]
}
```

 **Parameters:**
| 名称          | 类型      | 必填  | 描述                                                          |
| ----------- | ------- | --- | ----------------------------------------------------------- |
| exchange    | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol      | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval    | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit       | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time  | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time    | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| window      | integer | NO  | 窗口大小 —— 定义用于指标计算的数据点数量（例如：BOLL 的窗口为 20）。                    |
| series_type | string  | NO  | 价格类型 —— 指定计算中使用的价格类型。支持的取值：open、high、low、close。默认值：close。   |
| mult        | number  | NO  | mult：标准差倍数，用于定义布林带的宽度。默认值为 2。                               |


# 指标 - 合约指标 - 移动平均收敛发散指标 (MACD)


```
GET /api/futures/indicators/macd
```


该接口用于获取交易对的移动平均收敛发散指标 (MACD)。

***缓存/ 更新频率***：实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1678665600000,
      "macd_value": -837.307
    },
    {
      "time": 1678752000000,
      "macd_value": -575.43
    },
    ....
  ]
}
```

 **Parameters:**
| 名称            | 类型      | 必填  | 描述                                                          |
| ------------- | ------- | --- | ----------------------------------------------------------- |
| exchange      | string  | YES | 交易所名称（例如：Binance、OKX）。支持的交易所可通过 support-exchange-pair 接口获取。 |
| symbol        | string  | YES | 交易对（例如：BTCUSDT）。支持的交易对可通过 support-exchange-pair 接口获取。       |
| interval      | string  | YES | 数据时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。      |
| limit         | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                            |
| start_time    | integer | NO  | 起始时间戳（毫秒）（例如：1641522717000）。                                |
| end_time      | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                |
| series_type   | string  | NO  | 价格类型 —— 指定计算中使用的价格类型。支持的取值：open、high、low、close。默认值：close。   |
| fast_window   | integer | NO  | 用于指标计算的快速周期窗口大小（例如：MACD 的快速周期为 12）。                         |
| slow_window   | integer | NO  | 用于指标计算的慢速周期窗口大小（例如：MACD 的慢速周期为 26）。                         |
| signal_window | integer | NO  | 用于平滑快慢线差值的信号线窗口大小（例如：MACD 的信号线周期为 9）。                       |


# 指标 - 合约指标 - 合约基差


```
GET /api/futures/basis/history
```


该接口提供合约基差的历史数据，包括开盘与收盘时的基差数值

***缓存/ 更新频率 :*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1741629600000,            // 时间戳（毫秒）
      "open_basis": 0.0504,             // 开盘基差（单位：%）
      "close_basis": 0.0445,            // 收盘基差（单位：%）
      "open_change": 39.5,              // 开盘时基差相较前一时段变化幅度（单位：%）
      "close_change": 34.56             // 收盘时基差相较前一时段变化幅度（单位：%）
    },
    {
      "time": 1741633200000,            // 时间戳（毫秒）
      "open_basis": 0.0446,             // 开盘基差（单位：%）
      "close_basis": 0.03,              // 收盘基差（单位：%）
      "open_change": 34.65,             // 开盘时基差变化幅度（单位：%）
      "close_change": 23.74             // 收盘时基差变化幅度（单位：%）
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型     | 必填  | 描述                                                            |
| ---------- | ------ | --- | ------------------------------------------------------------- |
| exchange   | string | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表        |
| interval   | string | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w        |
| limit      | string | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | string | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | string | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 指标 - 合约指标 - 鲸鱼指数


```
GET /api/futures/whale-index/history
```


此端点提供鲸鱼指数历史数据。

***缓存/ 更新频率 :*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "time": 1665532800000,
      "whale_index_value": -184.8
    },
    {
      "time": 1665619200000,
      "whale_index_value": -118.965
    },
    {
      "time": 1665705600000,
      "whale_index_value": -58.795
    },
    {
      "time": 1665792000000,
      "whale_index_value": -84.095
    },
}
```

 **Parameters:**
| 名称         | 类型     | 必填  | 描述                                                            |
| ---------- | ------ | --- | ------------------------------------------------------------- |
| exchange   | string | YES | 合约交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所。 |
| symbol     | string | YES | 交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口查询支持的交易对          |
| interval   | string | YES | 数据的时间间隔。支持的值：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w           |
| limit      | string | NO  | 每次请求的结果数。默认 1000，最大 1000                                      |
| start_time | string | NO  | 以毫秒为单位的开始时间戳（例如 1641522717000）。                               |
| end_time   | string | NO  | 以毫秒为单位的结束时间戳（例如 1641522717000）。                               |


# 指标 - 合约指标 - CGDI 指数


```
GET /api/futures/cgdi-index/history
```


此端点提供 CGDI（CoinGlass 衍生品指数）历史数据

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

**响应数据**

```json
{
  "code": "0",
  "data": [
    {
      "time": 1704067200000,
      "cgdi_index_value": 1000
    },
    {
      "time": 1704153600000,
      "cgdi_index_value": 1053.2551
    },
  ]
}

```


# 指标 - 合约指标 - CDRI 指数


```
GET /api/futures/cdri-index/history 
```


此端点提供 CDRI（CoinGlass 衍生品风险指数）历史数据。

***缓存 / 更新频率:*** 实时更新

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

**响应数据**

```json
{
  "code": "0",
  "data": [
    {
      "time": 1646438400000,
      "cdri_index_value": 50
    },
    {
      "time": 1646524800000,
      "cdri_index_value": 47
    },
  ]
}

```


# 指标 - 现货 - Coinbase溢价指数


```
GET /api/coinbase-premium-index
```


该接口提供 Coinbase 比特币溢价指数，反映 Coinbase Pro 与 Binance 之间的比特币价格差异。

***缓存/ 更新频率 :*** 实时.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
"time": 1658880000,         // 时间戳（秒）
  "premium": 5.55,            // 溢价金额（USD）
  "premium_rate": 0.0261      // 溢价率（例如 0.0261 表示 2.61%）
    },
    {
"time": 1658880000,         // 时间戳（秒）
  "premium": 5.55,            // 溢价金额（USD）
  "premium_rate": 0.0261      // 溢价率（例如 0.0261 表示 2.61%）
    }
  ]
}
```

 **Parameters:**
| 名称        | 类型      | 必填  | 描述                                                      |
| --------- | ------- | --- | ------------------------------------------------------- |
| interval  | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| limit     | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| startTime | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| endTime   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |


# 指标 - 现货 - Bitfinex杠杆多空仓位


```
GET /api/bitfinex-margin-long-short
```


该接口提供来自 Bitfinex 的杠杆多头和空头仓位数据。

***缓存 / 更新频率:*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版    | 创业版      | 标准版 | 专业版 | 企业版 |
| :----- | :----- | :------- | :-- | :-- | :-- |
| 可用性    | ✅      | ✅        | ✅   | ✅   | ✅   |
| 颗粒度    | `>=4h` | ​`>=30m` | 无限制 | 无限制 | 无限制 |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "time": 1658880000,              // 时间戳，表示数据对应的时间点
      "long_quantity": 104637.94,       // 多头持仓数量
      "short_quantity": 2828.53        // 空头持仓数量
    },
    {
      "time": 1658966400,              // 时间戳，表示数据对应的时间点
      "long_quantity": 105259.46,       // 多头持仓数量
      "short_quantity": 2847.84        // 空头持仓数量
    }
    // 更多数据项...
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                      |
| ---------- | ------- | --- | ------------------------------------------------------- |
| symbol     | string  | YES | 支持：BTC,ETH                                              |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                        |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。 |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                            |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                            |


# 指标 - 现货 - 借贷利率


```
GET /api/borrow-interest-rate/history
```


该接口提供加密货币的借贷利率数据

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                             
  "msg": "success",                         
  "data": [
    {
      "time": 1741636800,                  // 时间戳 (秒)
      "interest_rate": 0.002989            // 利率
    },
    {
      "time": 1741640400,                  // 时间戳 (秒)
      "interest_rate": 0.002989            // 利率
    }
  ]
}

```

 **Parameters:**
| 名称         | 类型      | 必填  | 描述                                                            |
| ---------- | ------- | --- | ------------------------------------------------------------- |
| exchange   | string  | YES | 交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表。 |
| symbol     | string  | YES | 交易币种（例如：BTC）。可通过 support-coins 接口获取支持的币种列表。                   |
| interval   | string  | YES | 数据的时间间隔。支持的取值包括：1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d、1w。       |
| limit      | integer | NO  | 每次请求返回的数据条数。默认值为 1000，最大值为 1000。                              |
| start_time | integer | NO  | 开始时间戳（毫秒）（例如：1641522717000）。                                  |
| end_time   | integer | NO  | 结束时间戳（毫秒）（例如：1641522717000）。                                  |


# 指标 - 其他指标 - 比特币Ahr999指标


```
GET /api/index/ahr999
```


该接口提供比特币 AHR999 指标相关数据，包括历史均值、AHR999 当前值，以及不同日期对应的具体数据值。

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "date_string": "2011/02/01",            // 日期字符串（格式：YYYY/MM/DD）
      "average_price": 0.1365,                // 当日的平均价格
      "ahr999_value": 4.441692296429609,      // AHR999 指数值
      "current_value": 0.626                  // 当日的当前值
    },
    {
      "date_string": "2011/02/02",            // 日期字符串（格式：YYYY/MM/DD）
      "average_price": 0.1383,                // 当日的平均价格
      "ahr999_value": 5.642181244439729,      // AHR999 指数值
      "current_value": 0.713                  // 当日的当前值
    }
    // 更多数据条目...
  ]
}

```


# 指标 - 其他指标 - 普尔倍数


```
GET /api/index/puell-multiple
```


该接口提供 Puell Multiple 指标相关数据，包括在特定时间点的比特币价格、买入/卖出数量，以及对应的普尔倍数数值。

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                              
  "msg": "success",                        
  "data": [
    {
      "timestamp": 1282003200000,           // 时间戳（毫秒）
      "price": 0.07,                         // 当日价格
      "puell_multiple": 1                   // Puell Multiple 指标数值
    },
    {
      "timestamp": 1282089600000,           // 时间戳（毫秒）
      "price": 0.068,                        // 当日价格
      "puell_multiple": 1.0007745933384973  // Puell Multiple 指标数值
    }
  ]
}

```


# 指标 - 其他指标 - 比特币流通量与年产量


```
GET /api/index/stock-flow
```


该接口提供比特币 S2F（Stock-to-Flow）模型相关数据，包括特定时间点的价格、比特币的流通总量、年产量，以及距离下次减半的天数等信息。

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "timestamp": 1282003200000,       // 时间戳（毫秒）
      "price": 0.07,                    // 当日价格
      "next_halving": 834              // 距离下一次比特币减半的天数
    },
    {
      "timestamp": 1282089600000,       // 时间戳（毫秒）
      "price": 0.068,                   // 当日价格
      "next_halving": 833              // 距离下一次比特币减半的天数
    }
  ]
}

```


# 指标 - 其他指标 - Pi循环顶部指示器


```
GET /api/index/pi-cycle-indicator
```


该接口提供 Pi Cycle Top 指标的相关数据，包括每个时间点的比特币价格、111 日移动平均线（ma110）、以及 350 日移动平均线乘以 2 的值（ma350Mu2）

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                           
  "msg": "success",                       
  "data": [
    {
      "ma_110": 0.07,                      // 110日移动平均价格
      "timestamp": 1282003200000,         // 时间戳（毫秒）
      "ma_350_mu_2": 0.14,                // 350日移动平均的2倍值
      "price": 0.07                        // 当日价格
    },
    {
      "ma_110": 0.069,                    // 110日移动平均价格
      "timestamp": 1282089600000,         // 时间戳（毫秒）
      "ma_350_mu_2": 0.138,               // 350日移动平均的2倍值
      "price": 0.068                      // 当日价格
    }
  ]
}

```


# 指标 - 其他指标 - 比特币黄金比例乘数


```
GET /api/index/golden-ratio-multiplier
```


该接口提供比特币黄金比例乘数（Golden Ratio Multiplier）的相关数据

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "low_bull_high_2": 0.14,                       // 牛市低高位比例系数 / Bull market low-high ratio coefficient
      "timestamp": 1282003200000,                    // 时间戳（毫秒）/ Timestamp (milliseconds)
      "price": 0.07,                                 // 当前价格 / Current price
      "ma_350": 0.07,                                // 350日移动平均 / 350-day moving average
      "accumulation_high_1_6": 0.11200000000000002,  // 累积高位比例（1/6倍黄金比例）/ Accumulation high ratio (1/6 golden ratio)
      "x_3": 0.21000000000000002,                    // 黄金比例倍数 x3 / Golden ratio multiple x3
      "x_5": 0.35000000000000003,                    // 黄金比例倍数 x5 / Golden ratio multiple x5
      "x_8": 0.56,                                   // 黄金比例倍数 x8 / Golden ratio multiple x8
      "x_13": 0.9100000000000001,                    // 黄金比例倍数 x13 / Golden ratio multiple x13
      "x_21": 1.4700000000000002                     // 黄金比例倍数 x21 / Golden ratio multiple x21
    },

  ]
}

```


# 指标 - 其他指标 - 比特币盈利日期


```
GET /api/index/bitcoin/profitable-days
```


该接口提供比特币历史上所有盈利的日期

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                              
  "msg": "success",                        
  "data": [
    {
      "side": 1,                              // 交易方向，1表示买入，0表示卖出
      "timestamp": 1282003200000,             // 时间戳（毫秒）
      "price": 0.07                           // 价格
    },
    {
      "timestamp": 1282089600000,             // 时间戳（毫秒）
      "price": 0.068,                         // 价格
      "side": 1                               // 交易方向，1表示买入，0表示卖出
    }
  ]
}

```


# 指标 - 其他指标 - 比特币彩虹图


```
GET /api/index/bitcoin/rainbow-chart
```


该接口提供比特币彩虹图数据

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                              
  "msg": "success",                        
  "data": [
    [
      0.07,                                 // 当前价格
      0.033065,                             // 阴影最低值
      0.044064,                             // 第一层
      0.059892,                             // 第二层
      0.082219,                             // 第三层
      0.110996,                             // 第四层
      0.149845,                             // 第五层
      0.205865,                             // 第六层
      0.283454,                             // 第七层
      0.380525,                             // 第八层
      0.517626,                             // 第九层
      1282003200000                        // 时间戳
    ]
  ]
}

```


# 指标 - 其他指标 - 恐惧与贪婪指数


```
GET /api/index/fear-greed-history
```


该接口提供恐惧与贪婪指数数据

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                             
  "msg": "success",                        
  "data": [
    {
      "values": [4611285.1141, ...],         // 恐惧与贪婪指数的数值
      "price": [4788636.51145, ...],         // 对应的价格数据
      "time_list": [1636588800, ...]        // 时间戳
    }
  ]
}

```


# 指标 - 其他指标 - 稳定币市值历史


```
GET /api/index/stableCoin-marketCap-history
```


该接口提供稳定币市值历史

***缓存 / 更新频率:*** 每天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                             
  "msg": "success",                        
  "data": [
    {
      "data_list": [4611285.1141, ...],         // 数值列表
      "price_list": [, ...],                    // 价格列表
      "time_list": [1636588800, ...]            // 时间戳列表
    }
  ]
}

```


# 指标 - 其他指标 - 比特币泡沫指数


```
GET /api/index/bitcoin/bubble-index
```


该接口提供比特币泡沫指数接口

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "price": 0.0495,                          // 当前价格
      "bubble_index": -29.59827206,             // 泡沫指数
      "google_trend_percent": 0.0287,           // Google 趋势百分比
      "mining_difficulty": 181.543,             // 挖矿难度
      "transaction_count": 235,                 // 交易数量
      "address_send_count": 390,                // 地址发送数量
      "tweet_count": 0,                         // 推特数量
      "date_string": "2010-07-17"               // 日期字符串
    },
    {
      "price": 0.0726,                          // 当前价格
      "bubble_index": -29.30591863,             // 泡沫指数
      "google_trend_percent": 0.0365,           // Google 趋势百分比
      "mining_difficulty": 181.543,             // 挖矿难度
      "transaction_count": 248,                 // 交易数量
      "address_send_count": 424,                // 地址发送数量
      "tweet_count": 0,                         // 推特数量
      "date_string": "2010-07-18"               // 日期字符串
    }
  ]
}

```


# 指标 - 其他指标 - 牛市逃顶信号清单


```
GET /api/bull-market-peak-indicator
```


该接口提供牛市逃顶信号清单数据

***缓存 / 更新频率:*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "msg": "success",
  "data": [
    {
      "indicator_name": "Bitcoin Ahr999 Index",  // 指标名称
      "current_value": "0.78",                  // 当前值
      "target_value": "4",                      // 目标值
      "previous_value": "0.77",                 // 前一值
      "change_value": "0.0009811160359081",     // 变动值
      "comparison_type": ">=",                  // 比较类型
      "hit_status": false                       // 是否满足目标条件
    },
    {
      "indicator_name": "Pi Cycle Top Indicator",  // 指标名称
      "current_value": "85073.0",                  // 当前值
      "target_value": "154582",                    // 目标值
      "previous_value": "85127.0",                 // 前一值
      "change_value": "-54.0",                     // 变动值
      "comparison_type": ">=",                     // 比较类型
      "hit_status": false                          // 是否满足目标条件
    }
  ]
}

```


# 指标 - 其他指标 - 两年MA乘数指标


```
GET /api/index/2-year-ma-multiplier
```


该接口提供两年MA乘数指标数据

***缓存 / 更新频率:*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                              
  "msg": "success",                         
  "data": [
    {
      "timestamp": 1282003200000,               // 时间戳 (毫秒)
      "price": 0.07,                            // 当前价格
      "moving_average_730": 0.07,               // 2 年移动平均线 (730 表示周期)
      "moving_average_730_multiplier_5": 0.35000000000000003, // 2 年移动平均线的 5 倍 (Multiplier)
    }
  ]
}

```


# 指标 - 其他指标 - 200周移动平均热力图


```
GET /api/index/200-week-moving-average-heatmap
```


该接口提供200周移动平均热力图数据

***缓存 / 更新频率:*** 1天一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ✅   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                              
  "msg": "success",                         
  "data": [
    {
      "timestamp": 1325203200000,          // 时间戳 (毫秒)
      "price": 4.31063509000584,           // 当前价格
      "moving_average_1440": 4.143619070636635, // 200 周移动平均线 (1440 表示周期)
      "moving_average_1440_ip": 0,         // 移动平均线位置 (IP 指标)
      "buy_quantity": 0,                   // 买单数量
      "sell_quantity": 0                   // 卖单数量
    }
  ]
}

```


# 指标 - 其他指标 - 山寨币季节指数


```
GET /api/index/altcoin-season
```


该接口提供山寨币季节指数的数据

***缓存 / 更新频率:*** 5分钟更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1491177600000,
      "altcoin_index": 96,
      "altcoin_marketcap": 0
    },
    {
      "timestamp": 1491264000000,
      "altcoin_index": 100,
      "altcoin_marketcap": 0
    },
    {
      "timestamp": 1491350400000,
      "altcoin_index": 96,
      "altcoin_marketcap": 0
    },
}

```


# 指标 - 其他指标 - 比特币短期持有者已实现利润率


```
GET /api/index/bitcoin-sth-sopr
```


该接口提供比特币短期持有者已实现利润率数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1255305600000,
      "price": 0.00110205,
      "sth_sopr": 45.98748129
    },
    {
      "timestamp": 1255651200000,
      "price": 0.00124491,
      "sth_sopr": 1.24312355
    },
    {
      "timestamp": 1255824000000,
      "price": 0.00122546,
      "sth_sopr": 1.04147332
    },
}

```


# 指标 - 其他指标 - 比特币长期持有者已实现利润率


```
GET /api/index/bitcoin-lth-sopr
```


该接口提供比特币长期持有者已实现利润率数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1255305600000,
      "price": 0.00110205,
      "slh_sopr": 45.98748129
    },
    {
      "timestamp": 1255651200000,
      "price": 0.00124491,
      "slh_sopr": 1.24312355
    },
    {
      "timestamp": 1255824000000,
      "price": 0.00122546,
      "slh_sopr": 1.04147332
    },
}

```


# 指标 - 其他指标 - 比特币短期持有者平均持仓成本


```
GET /api/index/bitcoin-sth-realized-price
```


该接口提供比特币短期持有者平均持仓成本数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1325376000000,
      "price": 4.61211781,
      "sth_realized_price": 4.8958766225
    },
    {
      "timestamp": 1325462400000,
      "price": 5.13201225,
      "sth_realized_price": 4.8806352365
    },
    {
      "timestamp": 1325548800000,
      "price": 5.21773083,
      "sth_realized_price": 4.8736945702
    },
}

```


# 指标 - 其他指标 - 比特币长期持有者平均持仓成本


```
GET /api/index/bitcoin-lth-realized-price
```


该接口提供比特币长期持有者平均持仓成本数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1325376000000,
      "price": 4.61211781,
      "lth_realized_price": 4.938
    },
    {
      "timestamp": 1325462400000,
      "price": 5.13201225,
      "lth_realized_price": 4.937
    },
    {
      "timestamp": 1325548800000,
      "price": 5.21773083,
      "lth_realized_price": 4.946
    },
}

```


# 指标 - 其他指标 - 短期持有者持有比特币数量


```
GET /api/index/bitcoin-short-term-holder-supply
```


该接口提供短期持有者持有比特币数量数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 10.8584714558738,
      "short_term_holder_supply": 3682358,
      "timestamp": 1313625600000
    },
    {
      "price": 11.6704730432496,
      "short_term_holder_supply": 3682497,
      "timestamp": 1313712000000
    },
    {
      "price": 11.4597317393337,
      "short_term_holder_supply": 3680156,
      "timestamp": 1313798400000
    },
}

```


# 指标 - 其他指标 - 长期持有者持有比特币数量


```
GET /api/index/bitcoin-long-term-holder-supply
```


该接口提供长期持有者持有比特币数量数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 10.8584714558738,
      "long_term_holder_supply": 3395092,
      "timestamp": 1313625600000
    },
    {
      "price": 11.6704730432496,
      "long_term_holder_supply": 3401503,
      "timestamp": 1313712000000
    },
    {
      "price": 11.4597317393337,
      "long_term_holder_supply": 3411444,
      "timestamp": 1313798400000
    },
}

```


# 指标 - 其他指标 - 比特币 RHODL 比值


```
GET /api/index/bitcoin-rhodl-ratio
```


该接口提供比特币 RHODL 比值数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 0.07,
      "rhodl_ratio": 0.19768584894587235,
      "timestamp": 1282003200000
    },
    {
      "price": 0.068,
      "rhodl_ratio": 0.3765371066876411,
      "timestamp": 1282089600000
    },
    {
      "price": 0.0667,
      "rhodl_ratio": 0.55947437296653,
      "timestamp": 1282176000000
    },
}

```


# 指标 - 其他指标 - 比特币新地址


```
GET /api/index/bitcoin-new-addresses
```


该接口提供比特币新地址数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1282003200000,
      "price": 0.07,
      "new_address_count": 331
    },
    {
      "timestamp": 1282089600000,
      "price": 0.068,
      "new_address_count": 415
    },
    {
      "timestamp": 1282176000000,
      "price": 0.0667,
      "new_address_count": 316
    },
}

```


# 指标 - 其他指标 - 比特币活跃地址


```
GET /api/index/bitcoin-active-addresses
```


该接口提供比特币活跃地址数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1282003200000,
      "price": 0.07,
      "active_address_count": 494
    },
    {
      "timestamp": 1282089600000,
      "price": 0.068,
      "active_address_count": 726
    },
    {
      "timestamp": 1282176000000,
      "price": 0.0667,
      "active_address_count": 470
    },
}

```


# 指标 - 其他指标 - 比特币储备风险


```
GET /api/index/bitcoin-reserve-risk
```


该接口提供比特币储备风险数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 0.07,
      "reserve_risk_index": 1.0463483830080946,
      "movcd": 0.003100675514248423,
      "hodl_bank": 0.06689932448575159,
      "vocd": 0.003100675514248423,
      "timestamp": 1282003200000
    },
    {
      "price": 0.068,
      "reserve_risk_index": 0.5285777367358181,
      "movcd": 0.006252211158717467,
      "hodl_bank": 0.12864711332703413,
      "vocd": 0.009403746803186511,
      "timestamp": 1282089600000
    },
    {
      "price": 0.0667,
      "reserve_risk_index": 0.3469505118474761,
      "movcd": 0.003100675514248423,
      "hodl_bank": 0.19224643781278572,
      "vocd": 0.0018287503434234226,
      "timestamp": 1282176000000
    },
}

```


# 指标 - 其他指标 - 比特币未实现净盈亏 (NUPL)


```
GET /api/index/bitcoin-net-unrealized-profit-loss
```


该接口提供比特币未实现净盈亏 (NUPL)数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 0,
      "net_unpnl": 0,
      "timestamp": 1230940800000
    },
    {
      "price": 0,
      "net_unpnl": 0,
      "timestamp": 1231027200000
    },
    {
      "price": 0,
      "net_unpnl": 0,
      "timestamp": 1231113600000
    },
}

```


# 指标 - 其他指标 - 比特币相关性


```
GET /api/index/bitcoin-correlation
```


该接口提供比特币相关性数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1284508800000,
      "price": 0.06080235,
      "gld": -0.5150866328682138,
      "iwm": -0.4464952558926045,
      "qqq": 0,
      "spy": -0.38000905719099726,
      "tlt": 0.32525293786188403
    },
    {
      "timestamp": 1284595200000,
      "price": 0.0805732,
      "gld": -0.1441145695322488,
      "iwm": -0.390257896507018,
      "qqq": 0,
      "spy": -0.3562006006485584,
      "tlt": 0.25421749956089384
    },
}

```


# 指标 - 其他指标 - 比特币宏观震荡指标(BMO)


```
GET /api/index/bitcoin-macro-oscillator
```


该接口提供比特币宏观震荡指标(BMO)数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "price": 6.3162949999999976,
      "bmo_value": -0.25927286591542786,
      "timestamp": 1326067200000
    },
    {
      "price": 6.449687599999999,
      "bmo_value": -0.23528273675333555,
      "timestamp": 1326153600000
    },
    {
      "price": 6.899966666666668,
      "bmo_value": -0.17373343317542636,
      "timestamp": 1326240000000
    },
}

```


# 指标 - 其他指标 - 期权持仓 vs 合约持仓


```
GET /api/futures/delisted-exchange-pairs
```


该接口提供期权持仓 vs 合约持仓数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": {
    "Binance": [
      {
        "instrument_id": "1000LUNCBUSD",
        "base_asset": "1000LUNC",
        "quote_asset": "BUSD"
      },
      {
        "instrument_id": "1000SHIBBUSD",
        "base_asset": "1000SHIB",
        "quote_asset": "BUSD"
      },
      {
        "instrument_id": "ADABUSD",
        "base_asset": "ADA",
        "quote_asset": "BUSD"
      },
}

```


# 指标 - 其他指标 - 比特币 vs 全球 M2 货币供应增长


```
GET /api/index/bitcoin-vs-global-m2-growth
```


该接口提供比特币 vs 全球 M2 货币供应增长数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1369008000000,
      "price": 117.8186364699,
      "global_m2_yoy_growth": 5.5654014717,
      "global_m2_supply": 59166686473105
    },
    {
      "timestamp": 1369612800000,
      "price": 126.392905903,
      "global_m2_yoy_growth": 5.8571414345,
      "global_m2_supply": 59490171457382
    },
    {
      "timestamp": 1370217600000,
      "price": 122.9491879018,
      "global_m2_yoy_growth": 6.7670545757,
      "global_m2_supply": 60072386054198
    },
}

```


# 指标 - 其他指标 - 比特币 vs 美国 M2 货币供应增长


```
GET /api/index/bitcoin-vs-us-m2-growth
```


该接口提供比特币 vs 美国 M2 货币供应增长数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1278979200000,
      "price": 0.06183332,
      "us_m2_yoy_growth": 0.1321,
      "us_m2_supply": 8639800000000
    },
    {
      "timestamp": 1279065600000,
      "price": 0.05815725,
      "us_m2_yoy_growth": 0.1321,
      "us_m2_supply": 8639800000000
    },
    {
      "timestamp": 1279152000000,
      "price": 0.05640261,
      "us_m2_yoy_growth": 0.1321,
      "us_m2_supply": 8639800000000
    },
}

```


# 指标 - 其他指标 - 比特币市值占比


```
GET /api/index/bitcoin-dominance
```


该接口提供比特币市值占比数据

***缓存 / 更新频率:*** 1天更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "timestamp": 1367366400000,
      "price": 139,
      "bitcoin_dominance": 94.3595,
      "market_cap": 1545031856
    },
    {
      "timestamp": 1367625600000,
      "price": 98.0999984741,
      "bitcoin_dominance": 93.8787,
      "market_cap": 1097883152
    },
    {
      "timestamp": 1367884800000,
      "price": 112.25,
      "bitcoin_dominance": 94.3851,
      "market_cap": 1240126128
    },
}

```


# 指标 - 其他指标 - 交易所资产透明度证明


```
GET /api/exchange_assets_transparency/list
```


这个接口提供各大交易所资产的实时透明度数据，包括总资产余额、资金流入、资产变动、未平仓量、杠杆率及交易量等信息。

***缓存 / 更新频率:*** 1小时更新一次.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",                         // 状态码
  "data": [
    {
      "exchange_name": "Binance",       // 交易所名称
      "exchange_logo_url": "https://cdn.coinglasscdn.com/static/exchanges/270.png",  // 交易所logo
      "balance_usd": 178382444198.04,   // 总资产
      "balance_change_usd_24h": -4244709940.9,  // 24小时价值变化
      "balance_change_usd_7d": 183489103818.63, // 7天价值变化
      "inflow_usd_24h": 1104357008.908988,      // 24小时流入
      "inflow_usd_7d": 870098130.1614555,       // 7天流入
      "open_interest": 28940016260,             // 合约持仓
      "average_leverage": 0.1622,               // 平均杠杆
      "volume_usd": 114901619432                // 交易量
    },
    {
      "exchange_name": "Bitfinex",              // 交易所名称
      "exchange_logo_url": "https://cdn.coinglasscdn.com/static/exchanges/bitfinex.jpg", // 交易所logo
      "balance_usd": 25836820506.17,            // 总资产
      "balance_change_usd_24h": -164420313.45,  // 24小时价值变化
      "balance_change_usd_7d": 26135897993.59,  // 7天价值变化
      "inflow_usd_24h": 225181636.35856062,     // 24小时流入
      "inflow_usd_7d": 706172180.891416,        // 7天流入
      "open_interest": 732439767,               // 合约持仓
      "average_leverage": 0.0283,               // 平均杠杆
      "volume_usd": 68891576                    // 交易量
    }
  ]
}

```


# 其他 - 财经日历 - 经济数据


```
GET /api/calendar/economic-data
```


该接口提供经济数据

***缓存 / 更新频率:*** 每 10 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "calendar_name": "全国经济信心指数(至0711)",
      "country_code": "CAN",
      "country_name": "加拿大",
      "data_effect": "影响较小",
      "forecast_value": "",
      "revised_previous_value": "",
      "previous_value": "52.10",
      "publish_timestamp": 1752494400000,
      "published_value": "52",
      "importance_level": 1,  // 1,2,3
      "has_exact_publish_time": 1
    },
    {
      "calendar_name": "5月批发销售(月率)",
      "country_code": "CAN",
      "country_name": "加拿大",
      "data_effect": "利多加元",
      "forecast_value": "-0.4%",
      "revised_previous_value": "",
      "previous_value": "-2.3%",
      "publish_timestamp": 1752496200000,
      "published_value": "0.1%",
      "importance_level": 2,   // 1,2,3
      "has_exact_publish_time": 1
    },
```

 **Parameters:**
| 名称         | 类型      | 必填 | 描述                                 |
| ---------- | ------- | -- | ---------------------------------- |
| start_time | integer | NO | 开始时间戳（以毫秒为单位）。支持的最大范围为当前时间之前 15 天。 |
| end_time   | integer | NO | 结束时间戳（以毫秒为单位）。支持的最大范围为当前时间之后 15 天。 |
| language   | string  | NO | 支持的语言：'en' 或 'zh'                  |


# 其他 - 财经日历 - 财经事件


```
GET /api/calendar/financial-events
```


此接口提供财经事件的数据

***缓存 / 更新频率:*** 每 10 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "calendar_name": "美国总统特朗普发表讲话", //描述
      "country_name": "",  //国家code
      "publish_timestamp": 1751394600000,  //公布时间
      "importance_level": 2,// 重要等级 1,2,3
      "has_exact_publish_time": 1 //1代表有具体公布时间， 2代表没有具体公布时间
    },
    {
      "calendar_name": "美国财长贝森特发表讲话",
      "country_code": "USA",
      "country_name": "美国",
      "publish_timestamp": 1751563800000,
      "importance_level": 3, //1,2,3
      "has_exact_publish_time": 1
    },
}
```

 **Parameters:**
| 名称         | 类型      | 必填 | 描述                                  |
| ---------- | ------- | -- | ----------------------------------- |
| start_time | integer | NO | 开始时间戳（以毫秒为单位）。支持的最大范围为当前时间往前推 15 天。 |
| end_time   | integer | NO | 结束时间戳（以毫秒为单位）。支持的最大范围为当前时间往后推 15 天。 |


# 其他 - 财经日历 - 央行动态


```
GET /api/calendar/central-bank-activities
```


此接口提供央行动态数据

***缓存 / 更新频率:*** 每 10 分钟更新一次

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "calendar_name": "欧洲央行在辛特拉举行中央银行论坛",
      "country_code": "PT",
      "country_name": "葡萄牙",
      "publish_timestamp": 1751213100000,
      "importance_level": 3, // 1,2,3
      "has_exact_publish_time": 2
    },
    {
      "calendar_name": "亚特兰大联储主席博斯蒂克就美国经济前景发表讲话",
      "country_code": "USA",
      "country_name": "美国",
      "publish_timestamp": 1751288400000,
      "importance_level": 3, // 1,2,3
      "has_exact_publish_time": 1
    },
}
```

 **Parameters:**
| 名称         | 类型      | 必填 | 描述                                  |
| ---------- | ------- | -- | ----------------------------------- |
| start_time | integer | NO | 开始时间戳（以毫秒为单位）。支持的最大范围为当前时间往前推 15 天。 |
| end_time   | integer | NO | 结束时间戳（以毫秒为单位）。支持的最大范围为当前时间往后推 15 天。 |


# 其他 - 新闻、快讯 - 新闻


```
GET /api/article/list
```


这个接口提供实时新闻列表（最多返回近1000条新闻）

***缓存 / 更新频率:*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "article_picture": "https://www.chaincatcher.com/upload/image/20251107/1762481312628-595379.webp",   //新闻封面
      "article_title": "ANT.FUN 创始人 Shaun：稳定币与 AGI 融合将催生「金融超级 App」", //新闻标题
      "article_content": "<p style=来大规模使用。</p>",  //新闻内容
      "source_name": "chaincatcher", //新闻来源 
      "source_website_logo":   "https://cdn.coinglasscdn.com/static/news/chaincatcher.png",  //新闻来源 logo
      "article_release_time": 1762481371000  // 新闻发布时间
    },
    {
      "article_picture": "https://uploads.panewslab.com/2025z/00cf2969-73c7-44ff-8fee-54706d79cf8e",
      "article_title": "币安人生发币者：市值最高冲到5亿美金，但我只赚了4000",
      "article_content": "<p>2025 年 10诸公共解。</p>",
      "source_name": "PANews",
      "source_website_logo": "https://cdn.coinglasscdn.com/news/panews.png",
      "article_release_time": 1762480819000
    },
    ...
  ]
}
```

 **Parameters:**
| 名称         | 类型     | 必填 | 描述                             |
| ---------- | ------ | -- | ------------------------------ |
| start_time | string | NO | 起始时间戳（单位：毫秒，例如：1641522717000）。 |
| end_time   | string | NO | 结束时间戳（单位：毫秒，例如：1641522717000）。 |
| language   | string | NO | 支持的语言：'en' 、 'zh' 、'zh-tw'     |
| page       | string | NO | 当前页码                           |
| per_page   | string | NO | 每页返回条数                         |


# 其他 - 新闻、快讯 - 快讯


```
GET /api/newsflash/list
```


这个接口提供实时快讯列表（最多返回近1000条快讯）

***缓存 / 更新频率:*** 实时更新.

***该接口以下API等级可用：*** [API 等级](https://www.coinglass.com/zh/pricing)：

| API 等级 | 爱好版 | 创业版 | 标准版 | 专业版 | 企业版 |
| :----- | :-- | :-- | :-- | :-- | :-- |
| 可用性    | ❌   | ✅   | ✅   | ✅   | ✅   |

### 响应数据

```json
{
  "code": "0",
  "data": [
    {
      "newsflash_picture": "",//快讯图片
      "newsflash_title": "Binance：Alpha 2.0的ELIZAOS交易开始时间已被推迟", //快讯标题
      "newsflash_content": "<p>BlockBeats 消息新的上线时间将另行通知。</p>",//快讯内容
      "source_name": "BLOCKBEATS",  //快讯来源名称
      "source_website_logo": "https://cdn.coinglasscdn.com/news/block_beats.png",//快讯来源logo
      "newsflash_release_time": 1762482906000 //快讯发布时间
    },
    {
      "newsflash_title": "特朗普加密顾问、Bitcoin Magazine主席：DeFi借贷信用危机或演化为加密流动性危机，或将蔓延至CeFi领域",
      "newsflash_content": "Odaily星球日报请保持安全并避免交易对手风险。”",
      "source_name": "ODAILY",
      "source_website_logo": "https://cdn.coinglasscdn.com/news/odaily.png",
      "newsflash_release_time": 1762482628000
    },
    ...
  ]
}
```

 **Parameters:**
| 名称         | 类型     | 必填 | 描述                             |
| ---------- | ------ | -- | ------------------------------ |
| start_time | string | NO | 起始时间戳（单位：毫秒，例如：1641522717000）。 |
| end_time   | string | NO | 结束时间戳（单位：毫秒，例如：1641522717000）。 |
| language   | string | NO | 支持的语言： 'zh' 、'zh-tw'           |
| page       | string | NO | 当前页码                           |
| per_page   | string | NO | 每页返回条数                         |