行情接口

订单簿深度信息

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "depth",
    "params": {
        "symbol": "BNBUSDT"
    }
}

获取当前深度信息。

请注意，此请求返回有限的市场深度。

如果需要持续监控深度信息更新，请考虑使用 WebSocket Streams：

• <symbol>@depth<levels>
• <symbol>@depth

如果需要维护本地orderbook，您可以将 depth 请求与 <symbol>@depth streams 一起使用。

权重: 根据 limit 调整：

限制	请求权重
1-100	5
101-500	25
501-1000	50
1001-5000	250

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
limit	INT	NO	默认值： 100； 最大值： 5000。
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。 如果状态不匹配，将返回错误 -1220 交易对与状态不匹配

数据源: 缓存

响应:

{
    "id": "51e2affb-0aba-4821-ba75-f2625006eb43",
    "status": 200,
    "result": {
        "lastUpdateId": 2731179239,
        // 买单列表。每项为 [价格, 数量]
        "bids": [
            [
                "0.01379900", // 价位
                "3.43200000"  // 挂单量
            ],
            [
                "0.01379800", // 价位
                "3.24300000"  // 挂单量
            ],
            [
                "0.01379700", // 价位
                "10.45500000" // 挂单量
            ],
            [
                "0.01379600", // 价位
                "3.82100000"  // 挂单量
            ],
            [
                "0.01379500", // 价位
                "10.26200000" // 挂单量
            ]
        ],
        // 卖单列表。每项为 [价格, 数量]
        "asks": [
            [
                "0.01380000", // 价位
                "5.91700000"  // 挂单量
            ],
            [
                "0.01380100", // 价位
                "6.01400000"  // 挂单量
            ],
            [
                "0.01380200", // 价位
                "0.26800000"  // 挂单量
            ],
            [
                "0.01380300", // 价位
                "0.33800000"  // 挂单量
            ],
            [
                "0.01380400", // 价位
                "0.26800000"  // 挂单量
            ]
        ]
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

最近的交易

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.recent",
    "params": {
        "symbol": "BNBUSDT"
    }
}

获取最近的交易

如果您需要访问实时交易活动，请考虑使用 WebSocket Streams：

• <symbol>@trade

权重: 25

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
limit	INT	NO	默认值： 500； 最大值： 1000。

数据源: 缓存

响应:

{
    "id": "409a20bd-253d-41db-a6dd-687862a5882f",
    "status": 200,
    "result": [
        {
            "id": 194686783,
            "price": "0.01361000",
            "qty": "0.01400000",
            "quoteQty": "0.00019054",
            "time": 1660009530807,
            "isBuyerMaker": true,
            "isBestMatch": true
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 25
        }
    ]
}

历史交易

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.historical",
    "params": {
        "symbol": "BNBUSDT"
    }
}

获取历史交易。

权重: 25

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
fromId	LONG	NO	起始交易ID
limit	INT	NO	默认值： 500； 最大值： 1000。

数据源: 数据库

备注：

• 如果 fromId 未指定，则返回最近的交易。

响应:

{
    "id": "cffc9c7d-4efc-4ce0-b587-6b87448f052a",
    "status": 200,
    "result": [
        {
            "id": 0,
            "price": "0.00005000",
            "qty": "40.00000000",
            "quoteQty": "0.00200000",
            "time": 1500004800376,
            "isBuyerMaker": true,
            "isBestMatch": true
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 25
        }
    ]
}

查询历史大宗交易

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "blockTrades.historical",
    "params": {
        "symbol": "BNBBTC",
        "fromId": 582
    }
}

获取大宗交易记录。

权重: 25

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
fromId	LONG	YES	从该大宗交易ID开始查询
limit	LONG	NO	默认: 500; 最大: 1000

数据源: 数据库

响应:

{
    "id": "cffc9c7d-4efc-4ce0-b587-6b87448f052a",
    "status": 200,
    "result": [
        {
            "id": 582,
            "price": "0.052",
            "qty": "5838",
            "quoteQty": "303.576",
            "time": 1772506983321,
            "isBuyerMaker": true
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 10
        }
    ]
}

归集交易

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.aggregate",
    "params": {
        "symbol": "BNBUSDT"
    }
}

获取归集交易。

一个 归集交易 (aggtrade) 代表一个或多个单独的交易。

同时间，同 taker 订单和同价格的执行交易会被聚合为一条归集交易。

如果需要访问实时交易活动，请考虑使用 WebSocket Streams：

• <symbol>@aggTrade

如果需要历史总交易数据，可以使用 data.binance.vision。

权重: 4

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
fromId	LONG	NO	起始归集交易ID
startTime	LONG	NO	从该时刻之后的成交记录开始返回结果
endTime	LONG	NO	返回该时刻为止的成交记录
limit	INT	NO	默认值： 500； 最大值： 1000。

数据源: 数据库

• 如果指定了 fromId，则返回归集交易ID >= fromId 的归集交易。使用 fromId 和 limit 分页查询所有归集交易。
• 如果指定了 startTime 和/或 endTime，则按执行时间 (T) 过滤归集交易。fromId 不能与 startTime 和 endTime 同时使用。
• 如果没有指定条件，将返回最近的归集交易。

响应:

{
    "id": "189da436-d4bd-48ca-9f95-9f613d621717",
    "status": 200,
    "result": [
        {
            "a": 50000000,      // 归集成交ID
            "p": "0.00274100",  // 成交价
            "q": "57.19000000", // 成交量
            "f": 59120167,      // 被归集的首个成交ID
            "l": 59120170,      // 被归集的末个成交ID
            "T": 1565877971222, // 成交时间
            "m": true,          // 是否为主动卖出单
            "M": true           // 是否为最优撮合单(可忽略，目前总为最优撮合)
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

K线数据

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "klines",
    "params": {
        "symbol": "BNBUSDT",
        "interval": "1s"
    }
}

获取K线数据。

Klines 由其开盘时间和收盘时间为唯一标识。

如果您需要访问实时 kline 更新，请考虑使用 WebSocket Streams：

• <symbol>@kline_<interval>

如果需要历史K线数据，可以使用 data.binance.vision。

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
interval	ENUM	YES
startTime	LONG	NO
endTime	LONG	NO
timeZone	STRING	NO	默认值： 0 (UTC)
limit	INT	NO	默认值： 500； 最大值： 1000。

数据源: 数据库

支持的K线间隔 （区分大小写）：

间隔	间隔 值
seconds -> 秒	1s
minutes -> 分钟	1m， 3m， 5m， 15m， 30m
hours -> 小时	1h， 2h， 4h， 6h， 8h， 12h
days -> 天	1d， 3d
weeks -> 周	1w
months -> 月	1M

请注意：

• 如果未发送startTime和endTime，将返回最近的K线数据。
• timeZone支持的值包括：
  • 小时和分钟（例如 -1:00，05:45）
  • 仅小时（例如 0，8，4）
  • 接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
• 如果提供了timeZone，K线间隔将在该时区中解释，而不是在UTC中。
• 请注意，无论timeZone如何，startTime和endTime始终以UTC时区解释。

响应:

{
    "id": "1dbbeb56-8eea-466a-8f6e-86bdcfa2fc0b",
    "status": 200,
    "result": [
        [
            1499040000000,     // 开盘时间
            "0.01634790",      // 开盘价
            "0.80000000",      // 最高价
            "0.01575800",      // 最低价
            "0.01577100",      // 收盘价
            "148976.11427815", // 成交量
            1499644799999,     // 收盘时间
            "2434.19055334",   // 成交额
            308,               // 成交笔数
            "1756.87402397",   // 主动买入成交量
            "28.46694368",     // 主动买入成交额
            "0"                // 忽略字段
        ]
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

UI K线数据

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "uiKlines",
    "params": {
        "symbol": "BNBUSDT",
        "interval": "1s"
    }
}

请求参数和响应字段与k线接口相同。 uiKlines 是返回修改后的k线数据，针对k线图的呈现进行了优化。

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
interval	ENUM	YES
startTime	LONG	NO
endTime	LONG	NO
timeZone	STRING	NO	默认值： 0 (UTC)
limit	INT	NO	默认值： 500； 最大值： 1000。

数据源: 数据库

• 如果未发送 startTime 和 endTime，默认返回最近的交易。
• timeZone支持的值包括：
  • 小时和分钟（例如 -1:00，05:45）
  • 仅小时（例如 0，8，4）
  • 接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
• 如果提供了timeZone，K线间隔将在该时区中解释，而不是在UTC中。
• 请注意，无论timeZone如何，startTime和endTime始终以UTC时区解释。

响应:

{
    "id": "b137468a-fb20-4c06-bd6b-625148eec958",
    "status": 200,
    "result": [
        [
            1499040000000,     // 开盘时间
            "0.01634790",      // 开盘价
            "0.80000000",      // 最高价
            "0.01575800",      // 最低价
            "0.01577100",      // 收盘价
            "148976.11427815", // 成交量
            1499644799999,     // 收盘时间
            "2434.19055334",   // 成交额
            308,               // 成交笔数
            "1756.87402397",   // 主动买入成交量
            "28.46694368",     // 主动买入成交额
            "0"                // 忽略字段
        ]
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

当前平均价格

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "avgPrice",
    "params": {
        "symbol": "BNBUSDT"
    }
}

获取交易对的当前平均价格

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES

数据源: 缓存

响应:

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "mins": 5,                 // 平均价格间隔（以分钟为单位）
        "price": "0.01378135",     // 平均价格
        "closeTime": 1694061154503 // 最近成交时间
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

24hr 价格变动情况

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.24hr"
}

24 小时滚动窗口价格变动数据。 如果您需要持续监控交易统计，请考虑使用 WebSocket Streams:

• <symbol>@ticker
• <symbol>@miniTicker 或者 !miniTicker@arr

如果你想用不同的窗口数量，可以用 ticker 请求。

权重: 根据请求的交易对数量进行调整：

参数	提供Symbol数量	权重
symbol	1	2
	不提供	80
symbols	1-20	2
	21-100	40
	101+	80
	不提供	80

参数:

名称	类型	是否必须	描述
symbol	STRING	NO
symbols	ARRAY OF STRING	NO
type	ENUM	NO	Ticker 类型: FULL (默认) 或者 MINI
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。有效值： TRADING, HALT, BREAK

数据源: 缓存

备注:

• symbol 和 symbols 不能同时用。

• 如果未指定交易对，则返回有关当前在交易所交易的所有交易对的信息。

响应:

FULL 类型，对于单个交易对：

{
    "id": "9fa2a91b-3fca-4ed7-a9ad-58e3b67483de",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",            // 交易对
        "priceChange": "0.00013900",
        "priceChangePercent": "1.020",
        "weightedAvgPrice": "0.01382453",
        "prevClosePrice": "0.01362800",
        "lastPrice": "0.01376700",     // 间隔收盘价
        "lastQty": "1.78800000",
        "bidPrice": "0.01376700",
        "bidQty": "4.64600000",
        "askPrice": "0.01376800",
        "askQty": "14.31400000",
        "openPrice": "0.01362800",     // 间隔开盘价
        "highPrice": "0.01414900",     // 间隔最高价
        "lowPrice": "0.01346600",      // 间隔最低价
        "volume": "69412.40500000",    // 总交易量 (base asset)
        "quoteVolume": "959.59411487", // 总交易量 (quote asset)
        "openTime": 1660014164909,     // ticker间隔的开始时间
        "closeTime": 1660100564909,    // ticker间隔的结束时间
        "firstId": 194696115,          // 首笔成交id
        "lastId": 194968287,           // 末笔成交id
        "count": 272173                // 成交笔数
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

MINI 类型，对于单个交易对：

{
    "id": "9fa2a91b-3fca-4ed7-a9ad-58e3b67483de",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",            // 交易对
        "openPrice": "0.01362800",     // 间隔开盘价
        "highPrice": "0.01414900",     // 间隔最高价
        "lowPrice": "0.01346600",      // 间隔最低价
        "lastPrice": "0.01376700",     // 间隔收盘价
        "volume": "69412.40500000",    // 总交易量 (base asset)
        "quoteVolume": "959.59411487", // 总交易量 (quote asset)
        "openTime": 1660014164909,     // ticker间隔的开始时间
        "closeTime": 1660100564909,    // ticker间隔的结束时间
        "firstId": 194696115,          // 第一个交易 ID
        "lastId": 194968287,           // 最后一个交易ID
        "count": 272173                // 成交笔数
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2 // 成交笔数
        }
    ]
}

如果请求是有多个交易对，响应会是数组类型:

{
    "id": "901be0d9-fd3b-45e4-acd6-10c580d03430",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",            // 交易对
            "priceChange": "0.00016500",
            "priceChangePercent": "1.213",
            "weightedAvgPrice": "0.01382508",
            "prevClosePrice": "0.01360800",
            "lastPrice": "0.01377200",     // 间隔收盘价
            "lastQty": "1.01400000",
            "bidPrice": "0.01377100",
            "bidQty": "7.55700000",
            "askPrice": "0.01377200",
            "askQty": "4.37900000",
            "openPrice": "0.01360700",     // 间隔开盘价
            "highPrice": "0.01414900",     // 间隔最高价
            "lowPrice": "0.01346600",      // 间隔最低价
            "volume": "69376.27900000",    // 总交易量 (base asset)
            "quoteVolume": "959.13277091", // 总交易量 (quote asset)
            "openTime": 1660014615517,     // ticker间隔的开始时间
            "closeTime": 1660101015517,    // ticker间隔的结束时间
            "firstId": 194697254,          // 首笔成交id
            "lastId": 194969483,           // 末笔成交id
            "count": 272230                // 成交笔数
        },
        {
            "symbol": "BTCUSDT",
            "priceChange": "-938.06000000",
            "priceChangePercent": "-3.938",
            "weightedAvgPrice": "23265.34432003",
            "prevClosePrice": "23819.17000000",
            "lastPrice": "22880.91000000",
            "lastQty": "0.00536000",
            "bidPrice": "22880.40000000",
            "bidQty": "0.00424000",
            "askPrice": "22880.91000000",
            "askQty": "0.04276000",
            "openPrice": "23818.97000000",
            "highPrice": "23933.25000000",
            "lowPrice": "22664.69000000",
            "volume": "153508.37606000",
            "quoteVolume": "3571425225.04441220",
            "openTime": 1660014615977,
            "closeTime": 1660101015977,
            "firstId": 1592019902,
            "lastId": 1597301762,
            "count": 5281861
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

交易日行情(Ticker)

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.tradingDay",
    "params": {
        "symbols": [
            "BNBBTC",
            "BTCUSDT"
        ],
        "timeZone": "00:00"
    }
}

交易日价格变动统计。

权重: 每个交易对占用 4 个权重，与 windowSize 无关。当请求中的交易对数量超过 50 时，此请求的权重上限为 200。

参数:

名称	类型	是否必须	描述
symbol	STRING	NO
symbols	ARRAY OF STRING	NO
timeZone	STRING	NO	默认值： 0 (UTC)
type	ENUM	NO	Ticker 类型: FULL (默认) 或者 MINI
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。有效值： TRADING, HALT, BREAK

数据源: 数据库

注意:

• timeZone支持的值包括：
  • 小时和分钟（例如 -1:00，05:45）
  • 仅小时（例如 0，8，4）

响应:

FULL 类型，有 symbol:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        "priceChange": "-83.13000000",        // 绝对价格变动
        "priceChangePercent": "-0.317",       // 相对价格变动百分比
        "weightedAvgPrice": "26234.58803036", // 报价成交量 / 成交量
        "openPrice": "26304.80000000",
        "highPrice": "26397.46000000",
        "lowPrice": "26088.34000000",
        "lastPrice": "26221.67000000",
        "volume": "18495.35066000",           // 基础资产的成交量
        "quoteVolume": "485217905.04210480",
        "openTime": 1695686400000,
        "closeTime": 1695772799999,
        "firstId": 3220151555,
        "lastId": 3220849281,
        "count": 697727
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

FULL 类型，有 symbols:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "priceChange": "-83.13000000",        // 绝对价格变动
            "priceChangePercent": "-0.317",       // 相对价格变动百分比
            "weightedAvgPrice": "26234.58803036", // 报价成交量 / 成交量
            "openPrice": "26304.80000000",
            "highPrice": "26397.46000000",
            "lowPrice": "26088.34000000",
            "lastPrice": "26221.67000000",
            "volume": "18495.35066000",           // 基础资产的成交量
            "quoteVolume": "485217905.04210480",  // 报价资产的成交量
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 3220151555,                // 区间内的第一个交易的交易ID
            "lastId": 3220849281,                 // 区间内的最后一个交易的交易ID
            "count": 697727                       // 区间内的交易数量
        },
        {
            "symbol": "BNBUSDT",
            "priceChange": "2.60000000",
            "priceChangePercent": "1.238",
            "weightedAvgPrice": "211.92276958",
            "openPrice": "210.00000000",
            "highPrice": "213.70000000",
            "lowPrice": "209.70000000",
            "lastPrice": "212.60000000",
            "volume": "280709.58900000",
            "quoteVolume": "59488753.54750000",
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 672397461,
            "lastId": 672496158,
            "count": 98698
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

MINI 类型，有 symbol:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        "openPrice": "26304.80000000",
        "highPrice": "26397.46000000",
        "lowPrice": "26088.34000000",
        "lastPrice": "26221.67000000",
        "volume": "18495.35066000",          // 基础资产的成交量
        "quoteVolume": "485217905.04210480", // 报价资产的成交量
        "openTime": 1695686400000,
        "closeTime": 1695772799999,
        "firstId": 3220151555,               // 区间内的第一个交易的交易ID
        "lastId": 3220849281,                // 区间内的最后一个交易的交易ID
        "count": 697727                      // 区间内的交易数量
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

MINI 类型，有 symbols:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "openPrice": "26304.80000000",
            "highPrice": "26397.46000000",
            "lowPrice": "26088.34000000",
            "lastPrice": "26221.67000000",
            "volume": "18495.35066000",          // 基础资产的成交量
            "quoteVolume": "485217905.04210480", // 报价资产的成交量
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 3220151555,               // 区间内的第一个交易的交易ID
            "lastId": 3220849281,                // 区间内的最后一个交易的交易ID
            "count": 697727                      // 区间内的交易数量
        },
        {
            "symbol": "BNBUSDT",
            "openPrice": "210.00000000",
            "highPrice": "213.70000000",
            "lowPrice": "209.70000000",
            "lastPrice": "212.60000000",
            "volume": "280709.58900000",
            "quoteVolume": "59488753.54750000",
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 672397461,
            "lastId": 672496158,
            "count": 98698
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

滚动窗口价格变动统计

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker",
    "params": {
        "symbols": [
            "BNBBTC",
            "BTCUSDT"
        ],
        "windowSize": "7d"
    }
}

使用自定义窗口获取滚动窗口价格变化统计信息。

这个请求类似于 ticker.24hr，但统计数据是使用指定的任意窗口按需计算的。

注意： 窗口大小精度限制为1分钟。 虽然 closeTime 是请求的当前时间，openTime 总是从分钟边界开始。 因此，有效窗口可能比请求的 windowSize 宽59999毫秒。

窗口计算示例

例如，对 "windowSize": "7d" 的请求可能会导致以下窗口：

{
    "openTime": 1659580020000,
    "closeTime": 1660184865291
}

请求的时间 - closeTime - 是 1660184865291（2022年8月11日 02:27:45.291）。 请求的窗口大小应将 openTime 设置为7天之前 – 8月4日，02:27:45.291 – 但由于精度有限，它最终会提前一点：1659580020000（2022年8月4日 02:27:00），正好在一分钟开始。

如果您需要持续监控交易统计，请考虑使用 WebSocket Streams:

• <symbol>@ticker_<window_size> 或者 !ticker_<window-size>@arr

权重: 根据请求的交易对数量进行调整：

交易对	权重
1–50	每个交易对 4
51–100	200

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	获取单个交易对的ticker
symbols	ARRAY OF STRING	NO	获取多个交易对的ticker
type	ENUM	NO	Ticker 类型: FULL (默认) 或者 MINI
windowSize	ENUM	NO	默认为 1d
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。有效值： TRADING, HALT, BREAK

数据源: 数据库

支持的窗口 size:

单位	windowSize 值
minutes	1m, 2m ... 59m
hours	1h, 2h ... 23h
days	1d, 2d ... 7d

备注：

• 必须指定 symbol 或 symbols。

• 一个请求中的最大交易对数：200。

• 窗口 size 单位不能合并。 比如不支持 1d 2h。

响应:

FULL 类型，对于单个交易对：

{
    "id": "bdb7c503-542c-495c-b797-4d2ee2e91173",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "priceChange": "0.00061500",      // 价格变化
        "priceChangePercent": "4.735",    // 价格变化百分比
        "weightedAvgPrice": "0.01368242", // QuoteVolume / 成交量
        "openPrice": "0.01298900",
        "highPrice": "0.01418800",
        "lowPrice": "0.01296000",
        "lastPrice": "0.01360400",
        "volume": "587179.23900000",
        "quoteVolume": "8034.03382165",   // 此k线内所有交易的price(价格) x volume(交易量)的总和
        "openTime": 1659580020000,        // ticker的开始时间
        "closeTime": 1660184865291,       // ticker的结束时间
        "firstId": 192977765,             // 统计时间内的第一笔trade id
        "lastId": 195365758,
        "count": 2387994                  // 统计时间内交易笔数
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

MINI 类型，对于单个交易对：

{
    "id": "bdb7c503-542c-495c-b797-4d2ee2e91173",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "openPrice": "0.01298900",
        "highPrice": "0.01418800",
        "lowPrice": "0.01296000",
        "lastPrice": "0.01360400",
        "volume": "587179.23900000",
        "quoteVolume": "8034.03382165", // 此k线内所有交易的price(价格) x volume(交易量)的总和
        "openTime": 1659580020000,      // ticker的开始时间
        "closeTime": 1660184865291,     // ticker的结束时间
        "firstId": 192977765,           // 第一个交易 ID
        "lastId": 195365758,            // 最后交易 ID
        "count": 2387994                // 成交笔数
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4 // 成交笔数
        }
    ]
}

如果请求是有多个交易对，响应会是数组类型:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "priceChange": "0.00061500",      // 价格变化
            "priceChangePercent": "4.735",    // 价格变化百分比
            "weightedAvgPrice": "0.01368242", // QuoteVolume / 成交量
            "openPrice": "0.01298900",
            "highPrice": "0.01418800",
            "lowPrice": "0.01296000",
            "lastPrice": "0.01360400",
            "volume": "587169.48600000",
            "quoteVolume": "8033.90114517",   // 此k线内所有交易的price(价格) x volume(交易量)的总和
            "openTime": 1659580020000,        // ticker的开始时间
            "closeTime": 1660184820927,       // ticker的结束时间
            "firstId": 192977765,             // 统计时间内的第一笔trade id
            "lastId": 195365700,
            "count": 2387936                  // 统计时间内交易笔数
        },
        {
            "symbol": "BTCUSDT",
            "priceChange": "1182.92000000",
            "priceChangePercent": "5.113",
            "weightedAvgPrice": "23349.27074846",
            "openPrice": "23135.33000000",
            "highPrice": "24491.22000000",
            "lowPrice": "22400.00000000",
            "lastPrice": "24318.25000000",
            "volume": "1039498.10978000",
            "quoteVolume": "24271522807.76838630",
            "openTime": 1659580020000,
            "closeTime": 1660184820927,
            "firstId": 1568787779,
            "lastId": 1604337406,
            "count": 35549628
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

最新价格

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.price"
}

获取交易对最新价格

如果需要访问实时价格更新，请考虑使用 WebSocket Streams:

• <symbol>@aggTrade
• <symbol>@trade

权重: 根据请求的交易对数量进行调整：

参数	提供Symbol数量	权重
symbol	1	2
	不提供	4
symbols	任意	4

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	获取单个交易对的价格
symbols	ARRAY OF STRING	NO	获取多个交易对的价格
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。有效值： TRADING, HALT, BREAK

数据源: 缓存

备注：

• symbol 和 symbols 不能一起使用。

• 如果未指定交易对，则返回有关当前在交易所交易的所有交易对的信息。

响应 - 当查询单个交易对时:

{
    "id": "043a7cf2-bde3-4888-9604-c8ac41fcba4d",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "price": "0.01361900"
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

响应 - 当查询多个交易对时:

{
    "id": "e739e673-24c8-4adf-9cfa-b81f30330b09",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "price": "0.01363700"
        },
        {
            "symbol": "BTCUSDT",
            "price": "24267.15000000"
        },
        {
            "symbol": "BNBBUSD",
            "price": "331.10000000"
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

当前最优挂单

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.book"
}

在订单簿获取当前最优价格和数量。

如果您需要访问实时订单簿 ticker 更新，请考虑使用 WebSocket Streams:

• <symbol>@bookTicker

权重: 根据请求的交易对数量进行调整：

参数	提供Symbol数量	权重
symbol	1	2
	不提供	4
symbols	任意	4

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	获取单个交易对的ticker
symbols	ARRAY OF STRING	NO	获取多个交易对的ticker
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。有效值： TRADING, HALT, BREAK

数据源: 缓存

备注：

• symbol 和 symbols 不能一起使用。

• 如果未指定交易对，则返回有关当前在交易所交易的所有交易对的信息。

响应 - 当查询单个交易对时:

{
    "id": "9d32157c-a556-4d27-9866-66760a174b57",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "bidPrice": "0.01358000", // 最优买单价
        "bidQty": "12.53400000",  // 挂单量
        "askPrice": "0.01358100", // 最优卖单价
        "askQty": "17.83700000"   // 挂单量
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

响应 - 当查询多个交易对时:

{
    "id": "057deb3a-2990-41d1-b58b-98ea0f09e1b4",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "bidPrice": "0.01358000", // 最优买单价
            "bidQty": "12.53400000",  // 挂单量
            "askPrice": "0.01358100", // 最优卖单价
            "askQty": "17.83700000"   // 挂单量
        },
        {
            "symbol": "BTCUSDT",
            "bidPrice": "23980.49000000",
            "bidQty": "0.01000000",
            "askPrice": "23981.31000000",
            "askQty": "0.01512000"
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

查询参考价格

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "referencePrice",
    "params": {
        "symbol": "BAZUSD"
    }
}

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES

数据源: 缓存

如果该交易对从未设置过参考价格，则请求会被拒绝并返回：

{
    "code": -2043,
    "msg": "This symbol doesn't have a reference price."
}

响应:

如果设置了参考价格：

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "referencePrice": "0.00501900",
        "timestamp": 1770946889251 // 参考价格生效的时间
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

如果未设置参考价格：

{
    "id": "5132affb-0aba-4821-b475-f262504556b43",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "referencePrice": null,
        "timestamp": 1770946889251 // 参考价格生效的时间
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

如果从未设置过参考价格：

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 200,
    "result": {
        "code": -2043,
        "msg": "This symbol doesn't have a reference price."
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

查询参考价格计算方式

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "referencePrice.calculation",
    "params": {
        "symbol": "BAZUSD"
    }
}

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
symbolStatus	ENUM	NO

数据源: 缓存

响应:

如果参考价格由撮合引擎以算术平均数计算：

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "calculationType": "ARITHMETIC_MEAN",
        "bucketCount": 10,          // 如果参考价格由撮合引擎以算术平均数计算
        "bucketWidthMs": 1000,      // 如果参考价格由撮合引擎以算术平均数计算
        "externalCalculationId": 42 // 如果参考价格由撮合引擎外部计算
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

如果参考价格由撮合引擎外部计算：

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "calculationType": "EXTERNAL",
        "externalCalculationId": 42 // 如果参考价格由撮合引擎外部计算
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

如果参考价格未被计算：

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 400,
    "error": {
        "code": -2043,
        "msg": "This symbol doesn't have a reference price."
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}