---
updatedAt: 2026-07-29T09:59:04.000Z
agentTools:
  projectIndex: https://docs.coinglass.com/v4.0-zh/llms.txt
---

# 大额订单薄历史

该接口提供合约交易中已完成的大额限价挂单的历史数据。(阈值: 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",                    // 计价币种
      "limit_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,                         // 委托状态：2-已完成
      "order_end_time": 1745287328000           // 完成或撤销订单的结束时间 (毫秒)，start_time 和 end_time 参数基于 order_end_time 进行过滤。
    },
    ...
  ]
}

```

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "coinglass",
    "version": "3.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/orderbook/v2/large-limit-order-history": {
      "get": {
        "summary": "大额订单薄历史",
        "description": "该接口提供合约交易中已完成的大额限价挂单的历史数据。(阈值: BTC ≥ 100万, ETH ≥ 50万, Other ≥ 5万)",
        "operationId": "large-orderbook-history",
        "parameters": [
          {
            "name": "exchange",
            "in": "query",
            "required": true,
            "description": "交易所名称（例如：Binance、OKX）。可通过 support-exchange-pair 接口获取支持的交易所列表",
            "schema": {
              "type": "string",
              "default": "Binance"
            }
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "交易对（例如：BTCUSDT）。可通过 support-exchange-pair 接口获取支持的交易对列表。",
            "schema": {
              "type": "string",
              "default": "BTCUSDT"
            }
          },
          {
            "name": "start_time",
            "in": "query",
            "required": true,
            "description": "开始时间戳（毫秒）（例如：1641522717000）。",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": ""
            }
          },
          {
            "name": "end_time",
            "in": "query",
            "required": true,
            "description": "结束时间戳（毫秒）（例如：1641522717000）。",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": ""
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": true,
            "description": "订单状态说明如下：2：已完成（Finish）；3：已撤销（Revoke，成交额为 0）",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": "2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "examples": {
                  "New Example": {
                    "summary": "New Example",
                    "value": "{\n  \"code\": \"0\",\n  \"msg\": \"success\",\n  \"data\": [\n    {\n      \"id\": 2895605135,\n      \"exchange_name\": \"Binance\",               // 交易所名称\n      \"symbol\": \"BTCUSDT\",                      // 交易对\n      \"base_asset\": \"BTC\",                      // 基础币种\n      \"quote_asset\": \"USDT\",                    // 计价币种\n      \"price\": 89205.9,                         // 委托价格\n      \"start_time\": 1745287309000,              // 委托开始时间 (毫秒)\n      \"start_quantity\": 25.779,                 // 初始委托数量\n      \"start_usd_value\": 2299638.8961,          // 初始委托价值 (USD)\n      \"current_quantity\": 25.779,               // 当前剩余数量\n      \"current_usd_value\": 2299638.8961,        // 当前剩余价值 (USD)\n      \"current_time\": 1745287309000,            // 当前时间 (毫秒)\n      \"executed_volume\": 0,                     // 累计成交量\n      \"executed_usd_value\": 0,                  // 累计成交价值 (USD)\n      \"trade_count\": 0,                         // 累计成交笔数\n      \"order_side\": 1,                          // 委托方向：1-卖单，2-买单\n      \"order_state\": 2,                         // 委托状态：0-未开始，1-挂单中，2-已完成，3-已撤销\n      \"order_end_time\": 1745287328000           // 完成或撤销订单的结束时间 (毫秒)\n    },\n    ...\n  ]\n}\n"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```