---
updatedAt: 2026-10-29T07:00:11.000Z
agentTools:
  projectIndex: https://docs.coinglass.com/v4.0-zhtw/llms.txt
---

# 交易對市場列表

獲取某個幣種在各交易所、各合約交易對的即時行情：價格、指數價格、24 小時成交額、多空成交、持倉量、爆倉金額和資金費率。適合比較同一幣種在不同交易所的市場情況。

<DesignTheme />

以下 API 等級均可調用本接口：<PlanBadge plan="Hobbyist" /> <PlanBadge plan="Startup" /> <PlanBadge plan="Standard" /> <PlanBadge plan="Professional" /> <PlanBadge plan="Enterprise" />

<ApiParamsSlot />

## 響應數據

`data` 為陣列，每個元素是該幣種在某個交易所的一個合約交易對。截至 2026-10-20，`symbol=BTC` 返回 74 個交易對，右側範例只保留了前 2 條。

> 📘 百分數和比值
>
> 名稱含 `percent` 的欄位和 `funding_rate` 單位都是 %：`0.67` 表示 0.67%，不需要再乘以 100。`open_interest_volume_radio` 是普通比值，不是百分數。

`200` · application/json · 響應範例見右側面板。

| 欄位                                        | 類型              | 必返 | 說明                                             |
| :---------------------------------------- | :-------------- | :- | :--------------------------------------------- |
| `code`                                    | string          | 是  | 業務狀態碼，`"0"` 表示成功                               |
| `msg`                                     | string          | 否  | 結果說明；出錯時為錯誤訊息                                  |
| `data`                                    | array of object | 是  | 交易對列表，每個元素是一個交易所的一個合約交易對                       |
| `data[].instrument_id`                    | string          | 是  | 合約交易對，交易所原生寫法                                  |
| `data[].exchange_name`                    | string          | 是  | 交易所名稱                                          |
| `data[].symbol`                           | string          | 是  | 幣種對，`基礎幣/計價幣` 格式，例如 `BTC/USDT`                 |
| `data[].current_price`                    | number          | 是  | 當前價格，以計價幣種計                                    |
| `data[].index_price`                      | number          | 否  | 指數價格，以計價幣種計                                    |
| `data[].price_change_percent_24h`         | number          | 是  | 24 小時價格變化，單位 %                                 |
| `data[].volume_usd`                       | number          | 是  | 24 小時交易量（成交額），美元                               |
| `data[].volume_usd_change_percent_24h`    | number          | 否  | 24 小時交易量變化，單位 %；部分交易對不返回                       |
| `data[].long_volume_usd`                  | number          | 是  | 多單（主動買入）成交價值，美元                                |
| `data[].short_volume_usd`                 | number          | 是  | 空單（主動賣出）成交價值，美元                                |
| `data[].long_volume_quantity`             | integer         | 是  | 多單（主動買入）成交筆數，單位：筆，不是幣的數量                       |
| `data[].short_volume_quantity`            | integer         | 是  | 空單（主動賣出）成交筆數，單位：筆，不是幣的數量                       |
| `data[].open_interest_quantity`           | number          | 是  | 未平倉合約數量，按幣的數量計                                 |
| `data[].open_interest_usd`                | number          | 是  | 未平倉合約價值，美元                                     |
| `data[].open_interest_change_percent_24h` | number          | 否  | 24 小時未平倉合約變化，單位 %；部分交易對不返回                     |
| `data[].long_liquidation_usd_24h`         | number          | 否  | 近 24 小時多單爆倉金額，美元；沒有爆倉數據的交易對不返回                 |
| `data[].short_liquidation_usd_24h`        | number          | 否  | 近 24 小時空單爆倉金額，美元；沒有爆倉數據的交易對不返回                 |
| `data[].funding_rate`                     | number          | 否  | 當前資金費率，單位 %（`0.01` 表示 0.01%）；交割合約等沒有資金費率的品種不返回 |
| `data[].next_funding_time`                | integer（int64）  | 否  | 下一次資金費率結算時間，毫秒時間戳（UTC）                         |
| `data[].open_interest_volume_radio`       | number          | 是  | 未平倉合約與交易量的比率，普通比值。欄位名拼寫為 `radio`，請按原樣讀取        |
| `data[].oi_vol_ratio_change_percent_24h`  | number          | 否  | 上述比率的 24 小時變化，單位 %；部分交易對不返回                    |

## API 等級

**所有 API 等級都可以調用本接口**。各等級價格見 [API 等級](https://www.coinglass.com/zh-TW/pricing)。

| API 等級 | 能否調用 |
| :----- | :--- |
| 業餘     | ✅ 可以 |
| 創業     | ✅ 可以 |
| 標準     | ✅ 可以 |
| 專業     | ✅ 可以 |
| 企業     | ✅ 可以 |

## 用 AI 調用本接口

選一個任務，點「在 ChatGPT 中開啟」或「在 Claude 中開啟」，AI 會先讀取本頁說明，再直接給出結果；也可以點「複製」，把完整提示詞貼上到你常用的 AI 工具裡。

<AskAi
  prompts={[
    { label: "對比各交易所", desc: "讓 AI 寫一個 Python 函式，對比 BTC 在各交易所的成交額、持倉和資金費率。", text: "請閱讀 https://docs.coinglass.com/v4.0-zhtw/reference/pairs-markets.md ，用 Python 寫一個函式：獲取 BTC 的交易對市場列表，按 exchange_name 彙總每個交易所的 volume_usd 和 open_interest_usd，並列出各交易所 USDT 交易對的 funding_rate（單位已經是 %），返回 pandas DataFrame。API Key 從環境變數 COINGLASS_API_KEY 讀取。" },
    { label: "監控基差和資金費率", desc: "讓 AI 寫一個腳本，找出價格偏離指數價格較大、或資金費率偏高的交易對。", text: "請閱讀 https://docs.coinglass.com/v4.0-zhtw/reference/pairs-markets.md ，用 Python 寫一個腳本：每 5 分鐘獲取一次 ETH 的交易對市場列表，計算 (current_price - index_price) / index_price × 100 的偏離百分比，打印偏離超過 0.2% 或 funding_rate 絕對值超過 0.05 的交易對（funding_rate 單位為 %）。注意部分交易對沒有 index_price 或 funding_rate。API Key 從環境變數 COINGLASS_API_KEY 讀取。" },
    { label: "看懂這個接口", desc: "讓 AI 用白話解釋每個欄位和常見的坑。", text: "請閱讀 https://docs.coinglass.com/v4.0-zhtw/reference/pairs-markets.md ，用通俗的話告訴我：這個接口返回的每個欄位是什麼意思，哪些是百分數、哪些是美元，long_volume_quantity 為什麼是筆數，以及哪些欄位可能缺失。" },
  ]}
/>

本接口透過 REST API 提供數據，可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 [CoinGlass MCP](https://docs.coinglass.com/v4.0-zhtw/reference/mcp-service)。

## 應用場景

<ChoiceCards columns={2}>

| 場景 | 說明 |
| :-- | :-- |
| 交易所份額對比 | 比較同一幣種在各交易所的成交額和持倉量，看出流動性集中在哪裡。 |
| 資金費率比較 | 對比各交易所交易對的當前資金費率和下次結算時間，尋找費率差異。 |
| 價格偏離監控 | 對比 `current_price` 與 `index_price`，發現偏離指數較大的交易對。 |
| 多空成交與爆倉分析 | 用多空成交額、成交筆數和 24 小時多空爆倉金額，判斷單個市場的多空力量。 |

</ChoiceCards>

## 相關接口

| 接口                                                                              | 區別                 |
| :------------------------------------------------------------------------------ | :----------------- |
| [幣種市場列表](https://docs.coinglass.com/v4.0-zhtw/reference/coins-markets)          | 按幣種彙總的市場指標，不拆分交易對  |
| [支援的交易所和交易對](https://docs.coinglass.com/v4.0-zhtw/reference/instruments)        | 交易對的合約規則（槓桿、結算間隔等） |
| [交易對 K 線歷史](https://docs.coinglass.com/v4.0-zhtw/reference/price-ohlc-history)  | 單個交易對的歷史開高低收價格和成交額 |
| [幣種資金費率-交易所列表](https://docs.coinglass.com/v4.0-zhtw/reference/fr-exchange-list) | 各交易所資金費率的詳細列表      |
| [現貨交易對市場列表](https://docs.coinglass.com/v4.0-zhtw/reference/spot-pairs-markets)  | 現貨市場的交易對行情         |

## 常見問題

<Accordion title="symbol 填幣種還是交易對？" icon="fa-circle-question">
  填幣種，例如 `BTC`，接口會返回該幣種在各交易所的全部合約交易對。可查詢的幣種見「[支援的幣種](https://docs.coinglass.com/v4.0-zhtw/reference/coins)」接口。
</Accordion>

<Accordion title="long_volume_quantity 是幣的數量嗎？" icon="fa-circle-question">
  不是。`long_volume_quantity`、`short_volume_quantity` 是主動買入、主動賣出的成交筆數；成交金額請看 `long_volume_usd`、`short_volume_usd`。
</Accordion>

<Accordion title="funding_rate 的 0.01 是多少？" icon="fa-circle-question">
  是 0.01%。本接口的 `funding_rate` 和名稱含 `percent` 的欄位都已經是百分數，不需要再乘以 100。
</Accordion>

<Accordion title="為什麼有些交易對缺少部分欄位？" icon="fa-circle-question">
  `index_price`、`funding_rate`、`next_funding_time`、多空爆倉金額，以及 `volume_usd_change_percent_24h`、`open_interest_change_percent_24h`、`oi_vol_ratio_change_percent_24h` 這三個 24 小時變化欄位，不是每個交易對都有，例如交割合約沒有資金費率。讀取前請先判斷欄位是否存在，缺失時不要當作 0。
</Accordion>

## 深入了解：合約交易對行情

### 指數價格和最新價格有什麼區別？

最新價格是該交易對的成交價；指數價格通常由多個現貨市場價格加權得到，用於計算資金費率和強平價格。兩者偏離較大時，往往說明合約市場情緒過熱或過冷。

### 持倉與成交量的比率說明什麼？

`open_interest_volume_radio` 高，說明相對於成交，持倉更多，資金更偏向持有；比率低說明交易換手頻繁，短線資金更活躍。

### 如何查看這個交易對的歷史價格？

使用「[交易對 K 線歷史](https://docs.coinglass.com/v4.0-zhtw/reference/price-ohlc-history)」，傳交易所和 `instrument_id` 即可獲取它的歷史開高低收價格。

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "CoinGlass API",
    "version": "4.0.0"
  },
  "servers": [
    {
      "url": "https://open-api-v4.coinglass.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "CG-API-KEY"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/futures/pairs-markets": {
      "get": {
        "summary": "Pairs Markets",
        "description": "This API retrieves performance-related information for all available coins",
        "operationId": "pairs-markets",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "幣種代碼，例如 `BTC`、`ETH`、`SOL`。可查詢的幣種見「[支援的幣種](https://docs.coinglass.com/v4.0-zhtw/reference/coins)」接口。",
            "schema": {
              "type": "string",
              "default": "BTC"
            },
            "example": "BTC"
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "code": "0",
                      "data": [
                        {
                          "instrument_id": "BTCUSDT",
                          "exchange_name": "Binance",
                          "symbol": "BTC/USDT",
                          "current_price": 82056.6,
                          "index_price": 82096.35934783,
                          "price_change_percent_24h": -0.87,
                          "volume_usd": 10557271465.7207,
                          "volume_usd_change_percent_24h": 22.28,
                          "long_volume_usd": 5296692956.6103,
                          "short_volume_usd": 5260578509.1604,
                          "long_volume_quantity": 1475021,
                          "short_volume_quantity": 1456317,
                          "open_interest_quantity": 94786.481,
                          "open_interest_usd": 7777970100.6018,
                          "open_interest_change_percent_24h": -0.71,
                          "long_liquidation_usd_24h": 7497882.29,
                          "short_liquidation_usd_24h": 17905145.96,
                          "funding_rate": 0.01,
                          "next_funding_time": 1792483200000,
                          "open_interest_volume_radio": 0.7367,
                          "oi_vol_ratio_change_percent_24h": -18.8
                        },
                        {
                          "instrument_id": "BTC-USDT-SWAP",
                          "exchange_name": "OKX",
                          "symbol": "BTC/USDT",
                          "current_price": 82046.4,
                          "index_price": 82102,
                          "price_change_percent_24h": -0.88,
                          "volume_usd": 5293477850.6094,
                          "volume_usd_change_percent_24h": 12.41,
                          "long_volume_usd": 2640988717.11099,
                          "short_volume_usd": 2652489133.55811,
                          "long_volume_quantity": 543168,
                          "short_volume_quantity": 557977,
                          "open_interest_quantity": 30040.42400000012,
                          "open_interest_usd": 2465417597.68001,
                          "open_interest_change_percent_24h": -1.71,
                          "long_liquidation_usd_24h": 957278.41,
                          "short_liquidation_usd_24h": 670328.47,
                          "funding_rate": 0.01,
                          "next_funding_time": 1792483200000,
                          "open_interest_volume_radio": 0.4657,
                          "oi_vol_ratio_change_percent_24h": -12.56
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "業務狀態碼，\"0\" 表示成功",
                      "example": "0"
                    },
                    "msg": {
                      "type": "string",
                      "description": "結果說明；出錯時為錯誤訊息",
                      "example": "success"
                    },
                    "data": {
                      "type": "array",
                      "description": "交易對列表，每個元素是一個交易所的一個合約交易對",
                      "items": {
                        "type": "object",
                        "properties": {
                          "instrument_id": {
                            "type": "string",
                            "description": "合約交易對，交易所原生寫法"
                          },
                          "exchange_name": {
                            "type": "string",
                            "description": "交易所名稱"
                          },
                          "symbol": {
                            "type": "string",
                            "description": "幣種對，基礎幣/計價幣 格式，例如 BTC/USDT"
                          },
                          "current_price": {
                            "type": "number",
                            "description": "當前價格，以計價幣種計"
                          },
                          "index_price": {
                            "type": "number",
                            "description": "指數價格，以計價幣種計"
                          },
                          "price_change_percent_24h": {
                            "type": "number",
                            "description": "24 小時價格變化，單位 %"
                          },
                          "volume_usd": {
                            "type": "number",
                            "description": "24 小時交易量（成交額），美元"
                          },
                          "volume_usd_change_percent_24h": {
                            "type": "number",
                            "description": "24 小時交易量變化，單位 %；部分交易對不返回"
                          },
                          "long_volume_usd": {
                            "type": "number",
                            "description": "多單（主動買入）成交價值，美元"
                          },
                          "short_volume_usd": {
                            "type": "number",
                            "description": "空單（主動賣出）成交價值，美元"
                          },
                          "long_volume_quantity": {
                            "type": "integer",
                            "description": "多單（主動買入）成交筆數，單位：筆，不是幣的數量"
                          },
                          "short_volume_quantity": {
                            "type": "integer",
                            "description": "空單（主動賣出）成交筆數，單位：筆，不是幣的數量"
                          },
                          "open_interest_quantity": {
                            "type": "number",
                            "description": "未平倉合約數量，按幣的數量計"
                          },
                          "open_interest_usd": {
                            "type": "number",
                            "description": "未平倉合約價值，美元"
                          },
                          "open_interest_change_percent_24h": {
                            "type": "number",
                            "description": "24 小時未平倉合約變化，單位 %；部分交易對不返回"
                          },
                          "long_liquidation_usd_24h": {
                            "type": "number",
                            "description": "近 24 小時多單爆倉金額，美元；沒有爆倉數據的交易對不返回"
                          },
                          "short_liquidation_usd_24h": {
                            "type": "number",
                            "description": "近 24 小時空單爆倉金額，美元；沒有爆倉數據的交易對不返回"
                          },
                          "funding_rate": {
                            "type": "number",
                            "description": "當前資金費率，單位 %（0.01 表示 0.01%）；交割合約等沒有資金費率的品種不返回"
                          },
                          "next_funding_time": {
                            "type": "integer",
                            "description": "下一次資金費率結算時間，毫秒時間戳（UTC）",
                            "format": "int64"
                          },
                          "open_interest_volume_radio": {
                            "type": "number",
                            "description": "未平倉合約與交易量的比率，普通比值。欄位名拼寫為 radio，請按原樣讀取"
                          },
                          "oi_vol_ratio_change_percent_24h": {
                            "type": "number",
                            "description": "上述比率的 24 小時變化，單位 %；部分交易對不返回"
                          }
                        },
                        "required": [
                          "instrument_id",
                          "exchange_name",
                          "symbol",
                          "current_price",
                          "price_change_percent_24h",
                          "volume_usd",
                          "long_volume_usd",
                          "short_volume_usd",
                          "long_volume_quantity",
                          "short_volume_quantity",
                          "open_interest_quantity",
                          "open_interest_usd",
                          "open_interest_volume_radio"
                        ]
                      }
                    }
                  },
                  "required": [
                    "code",
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```