行情接口

深度信息

GET /api/v3/depth

权重: 根据 limit 调整：

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

参数:

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

数据源: 缓存

响应:

{
    "lastUpdateId": 1027024,
    // 买单列表。每项为 [价格, 数量]。
    "bids": [
        [
            "4.00000000",  // 价位
            "431.00000000" // 挂单量
        ]
    ],
    // 卖单列表。每项为 [价格, 数量]。
    "asks": [
        [
            "4.00000200", // 价位
            "12.00000000" // 挂单量
        ]
    ]
}

近期成交

GET /api/v3/trades

获取近期成交

权重: 25

参数:

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

数据源: 缓存

响应:

[
    {
        "id": 28457,
        "price": "4.00000100",
        "qty": "12.00000000",
        "quoteQty": "48.000012",
        "time": 1499865549590,
        "isBuyerMaker": true,
        "isBestMatch": true
    }
]

查询历史成交

GET /api/v3/historicalTrades

权重: 25

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
limit	INT	NO	默认值： 500； 最大值： 1000。
fromId	LONG	NO	从哪一条成交id开始返回，缺省返回最近的成交记录

数据源: 数据库

响应:

[
    {
        "id": 28457,
        "price": "4.00000100",
        "qty": "12.00000000",
        "quoteQty": "48.000012",
        "time": 1499865549590,
        "isBuyerMaker": true,
        "isBestMatch": true
    }
]

查询历史大宗交易

GET /api/v3/historicalBlockTrades

获取大宗交易记录。

权重: 25

参数:

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

数据源: 数据库

响应:

[
    {
        "id": 582,
        "price": "0.052",
        "qty": "5838",
        "quoteQty": "303.576",
        "time": 1772506983321,
        "isBuyerMaker": true
    }
]

近期成交(归集)

GET /api/v3/aggTrades

与trades的区别是，同一个taker在同一时间同一价格与多个maker的成交会被合并为一条记录

权重: 4

参数:

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

数据源: 数据库

• 如果没有发送任何筛选参数(fromId, startTime, endTime)，默认返回最近的成交记录

响应:

[
    {
        "a": 26129,         // 归集成交ID
        "p": "0.01633102",  // 成交价
        "q": "4.70443515",  // 成交量
        "f": 27781,         // 被归集的首个成交ID
        "l": 27781,         // 被归集的末个成交ID
        "T": 1498793709153, // 成交时间
        "m": true,          // 是否为主动卖出单
        "M": true           // 是否为最优撮合单(可忽略，目前总为最优撮合)
    }
]

K线数据

GET /api/v3/klines

每根K线的开盘时间可视为唯一ID

权重: 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时区解释。

响应:

[
    [
        1499040000000,     // 开盘时间
        "0.01634790",      // 开盘价
        "0.80000000",      // 最高价
        "0.01575800",      // 最低价
        "0.01577100",      // 收盘价
        "148976.11427815", // 成交量
        1499644799999,     // 收盘时间
        "2434.19055334",   // 成交额
        308,               // 成交笔数
        "1756.87402397",   // 主动买入成交量
        "28.46694368",     // 主动买入成交额
        "0"                // 忽略字段
    ]
]

UIK线数据

GET /api/v3/uiKlines

请求参数与响应和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时区解释。

响应:

[
    [
        1499040000000,     // 开盘时间
        "0.01634790",      // 开盘价
        "0.80000000",      // 最高价
        "0.01575800",      // 最低价
        "0.01577100",      // 收盘价
        "148976.11427815", // 成交量
        1499644799999,     // 收盘时间
        "2434.19055334",   // 成交额
        308,               // 成交笔数
        "1756.87402397",   // 主动买入成交量
        "28.46694368",     // 主动买入成交额
        "0"                // 忽略字段
    ]
]

当前平均价格

GET /api/v3/avgPrice

权重: 2

参数:

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

数据源: 缓存

响应:

{
    "mins": 5,                 // 平均价格间隔（以分钟为单位）
    "price": "9.35751834",     // 平均价格
    "closeTime": 1694061154503 // 最近成交时间
}

24hr价格变动情况

GET /api/v3/ticker/24hr

请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高

权重:

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

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	参数 symbol 和 symbols 不可以一起使用
symbols	ARRAY OF STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
type	ENUM	NO	默认值： FULL。
symbolStatus	ENUM	NO

数据源: 缓存

响应:

FULL 类型，有 symbol:

{
    "symbol": "BNBBTC",           // 交易对
    "priceChange": "-94.99999800",
    "priceChangePercent": "-95.960",
    "weightedAvgPrice": "0.29628482",
    "prevClosePrice": "0.10002000",
    "lastPrice": "4.00000200",    // 间隔收盘价
    "lastQty": "200.00000000",
    "bidPrice": "4.00000000",
    "bidQty": "100.00000000",
    "askPrice": "4.00000200",
    "askQty": "100.00000000",
    "openPrice": "99.00000000",   // 间隔开盘价
    "highPrice": "100.00000000",  // 间隔最高价
    "lowPrice": "0.10000000",     // 间隔最低价
    "volume": "8913.30000000",    // 总交易量 (base asset)
    "quoteVolume": "15.30000000", // 总交易量 (quote asset)
    "openTime": 1499783499040,    // ticker间隔的开始时间
    "closeTime": 1499869899040,   // ticker间隔的结束时间
    "firstId": 28385,             // 首笔成交id
    "lastId": 28460,              // 末笔成交id
    "count": 76                   // 成交笔数
}

FULL 类型，有 symbols:

[
    {
        "symbol": "BNBBTC",           // 交易对
        "priceChange": "-94.99999800",
        "priceChangePercent": "-95.960",
        "weightedAvgPrice": "0.29628482",
        "prevClosePrice": "0.10002000",
        "lastPrice": "4.00000200",    // 间隔收盘价
        "lastQty": "200.00000000",
        "bidPrice": "4.00000000",
        "bidQty": "100.00000000",
        "askPrice": "4.00000200",
        "askQty": "100.00000000",
        "openPrice": "99.00000000",   // 间隔开盘价
        "highPrice": "100.00000000",  // 间隔最高价
        "lowPrice": "0.10000000",     // 间隔最低价
        "volume": "8913.30000000",    // 总交易量 (base asset)
        "quoteVolume": "15.30000000", // 总交易量 (quote asset)
        "openTime": 1499783499040,    // ticker间隔的开始时间
        "closeTime": 1499869899040,   // ticker间隔的结束时间
        "firstId": 28385,             // 首笔成交id
        "lastId": 28460,              // 末笔成交id
        "count": 76                   // 成交笔数
    }
]

MINI 类型，有 symbol:

{
    "symbol": "BNBBTC",           // 交易对
    "openPrice": "99.00000000",   // 间隔开盘价
    "highPrice": "100.00000000",  // 间隔最高价
    "lowPrice": "0.10000000",     // 间隔最低价
    "lastPrice": "4.00000200",    // 间隔收盘价
    "volume": "8913.30000000",    // 总交易量 (base asset)
    "quoteVolume": "15.30000000", // 总交易量 (quote asset)
    "openTime": 1499783499040,    // ticker间隔的开始时间
    "closeTime": 1499869899040,   // ticker间隔的结束时间
    "firstId": 28385,             // 统计时间内的第一笔trade id
    "lastId": 28460,              // 统计时间内的最后一笔trade id
    "count": 76                   // 统计时间内交易笔数
}

MINI 类型，有 symbols:

[
    {
        "symbol": "BNBBTC",
        "openPrice": "99.00000000",
        "highPrice": "100.00000000",
        "lowPrice": "0.10000000",
        "lastPrice": "4.00000200",
        "volume": "8913.30000000",
        "quoteVolume": "15.30000000",
        "openTime": 1499783499040,
        "closeTime": 1499869899040,
        "firstId": 28385,
        "lastId": 28460,
        "count": 76
    },
    {
        "symbol": "LTCBTC",
        "openPrice": "0.07000000",
        "highPrice": "0.07000000",
        "lowPrice": "0.07000000",
        "lastPrice": "0.07000000",
        "volume": "11.00000000",
        "quoteVolume": "0.77000000",
        "openTime": 1656908192899,
        "closeTime": 1656994592899,
        "firstId": 0,
        "lastId": 10,
        "count": 11
    }
]

交易日行情(Ticker)

GET /api/v3/ticker/tradingDay

交易日价格变动统计。

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

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	symbol 或者 symbols 必须提供之
symbols	ARRAY OF STRING	NO	symbol 或者 symbols 必须提供之一 symbols 可以接受的格式: ["BTCUSDT","BNBUSDT"] 或者 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D. symbols 最多可以发送100个.
timeZone	STRING	NO	默认值： 0 (UTC)
type	ENUM	NO	默认值： FULL。
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。 对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。 对于多个交易对，响应中不会包括状态不匹配的交易对。

数据源: 数据库

注意:

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

响应:

FULL 类型，有 symbol:

{
    "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                       // 区间内的交易数量
}

FULL 类型，有 symbols:

[
    {
        "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
    }
]

MINI 类型，有 symbol:

{
    "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                      // 区间内的交易数量
}

MINI 类型，有 symbols:

[
    {
        "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,
        "lastId": 3220849281,
        "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
    }
]

最新价格接口

GET /api/v3/ticker/price

返回最近价格

权重:

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

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的价格数据都会返回.
symbols	ARRAY OF STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的价格数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。 对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。 对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。

数据源: 缓存

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

{
    "symbol": "LTCBTC",
    "price": "4.00000200"
}

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

[
    {
        "symbol": "LTCBTC",
        "price": "4.00000200"
    },
    {
        "symbol": "ETHBTC",
        "price": "0.07946600"
    }
]

最优挂单接口

GET /api/v3/ticker/bookTicker

返回当前最优的挂单(最高买单，最低卖单)

权重:

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

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的bookTicker数据都会返回.
symbols	ARRAY OF STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的bookTicker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatus	ENUM	NO	过滤具有此 tradingStatus 的交易对。 对于单个交易对，如果状态不匹配，将返回错误 -1220 交易对与状态不匹配。 对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。

数据源: 缓存

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

{
    "symbol": "LTCBTC",
    "bidPrice": "4.00000000", // 最优买单价
    "bidQty": "431.00000000", // 挂单量
    "askPrice": "4.00000200", // 最优卖单价
    "askQty": "9.00000000"    // 挂单量
}

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

[
    {
        "symbol": "LTCBTC",
        "bidPrice": "4.00000000", // 最优买单价
        "bidQty": "431.00000000", // 挂单量
        "askPrice": "4.00000200", // 最优卖单价
        "askQty": "9.00000000"    // 挂单量
    },
    {
        "symbol": "ETHBTC",
        "bidPrice": "0.07946700",
        "bidQty": "9.00000000",
        "askPrice": "100000.00000000",
        "askQty": "1000.00000000"
    }
]

滚动窗口价格变动统计

GET /api/v3/ticker

注意: 此接口和 GET /api/v3/ticker/24hr 有所不同.

此接口统计的时间范围比请求的windowSize多不超过59999ms.

接口的 openTime 是某一分钟的起始，而结束是当前的时间. 所以实际的统计区间会比请求的时间窗口多不超过59999ms.

比如, 结束时间 closeTime 是 1641287867099 (January 04, 2022 09:17:47:099 UTC) , windowSize 为 1d. 那么开始时间 openTime 则为 1641201420000 (January 3, 2022, 09:17:00 UTC)

权重: 每个交易对占用 4 个权重，与 windowSize 无关。

当请求中的 symbols 数量超过 50 时，此请求的权重上限为 200。

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	参数 symbol 和 symbols 不可以一起使用
symbols	ARRAY OF STRING	NO	参数 symbol 和 symbols 不可以一起使用 如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
windowSize	ENUM	NO	默认值： 1d。 不可以组合使用, 比如1d2h
type	ENUM	NO	默认值： FULL。
symbolStatus	ENUM	NO

数据源: 数据库

响应:

FULL 类型，使用参数 symbol 返回:

{
    "symbol": "LTCBTC",
    "priceChange": "-8.00000000",     // 价格变化
    "priceChangePercent": "-88.889",  // 价格变化百分比
    "weightedAvgPrice": "2.60427807", // QuoteVolume / 成交量
    "openPrice": "0.10000000",
    "highPrice": "2.00000000",
    "lowPrice": "0.10000000",
    "lastPrice": "2.00000000",
    "volume": "39.00000000",
    "quoteVolume": "13.40000000",     // 此k线内所有交易的price(价格) x volume(交易量)的总和
    "openTime": 1656986580000,        // ticker的开始时间
    "closeTime": 1657001016795,       // ticker的结束时间
    "firstId": 0,                     // 统计时间内的第一笔trade id
    "lastId": 34,
    "count": 35                       // 统计时间内交易笔数
}

FULL 类型，使用参数 symbols 返回:

[
    {
        "symbol": "BTCUSDT",
        "priceChange": "-154.13000000",       // 价格变化
        "priceChangePercent": "-0.740",       // 价格变化百分比
        "weightedAvgPrice": "20677.46305250", // QuoteVolume / 成交量
        "openPrice": "20825.27000000",
        "highPrice": "20972.46000000",
        "lowPrice": "20327.92000000",
        "lastPrice": "20671.14000000",
        "volume": "72.65112300",
        "quoteVolume": "1502240.91155513",    // 此k线内所有交易的price(价格) x volume(交易量)的总和
        "openTime": 1655432400000,            // ticker的开始时间
        "closeTime": 1655446835460,           // ticker的结束时间
        "firstId": 11147809,                  // 统计时间内的第一笔trade id
        "lastId": 11149775,
        "count": 1967                         // 统计时间内交易笔数
    },
    {
        "symbol": "BNBBTC",
        "priceChange": "0.00008530",
        "priceChangePercent": "0.823",
        "weightedAvgPrice": "0.01043129",
        "openPrice": "0.01036170",
        "highPrice": "0.01049850",
        "lowPrice": "0.01033870",
        "lastPrice": "0.01044700",
        "volume": "166.67000000",
        "quoteVolume": "1.73858301",
        "openTime": 1655432400000,
        "closeTime": 1655446835460,
        "firstId": 2351674,
        "lastId": 2352034,
        "count": 361
    }
]

MINI 类型，使用参数 symbol 返回:

{
    "symbol": "LTCBTC",
    "openPrice": "0.10000000",
    "highPrice": "2.00000000",
    "lowPrice": "0.10000000",
    "lastPrice": "2.00000000",
    "volume": "39.00000000",
    "quoteVolume": "13.40000000", // 此k线内所有交易的price(价格) x volume(交易量)的总和
    "openTime": 1656986580000,    // ticker窗口的开始时间
    "closeTime": 1657001016795,   // ticker窗口的结束时间
    "firstId": 0,                 // 首笔成交id
    "lastId": 34,
    "count": 35                   // 统计时间内交易笔数
}

MINI 类型，使用参数 symbols 返回:

[
    {
        "symbol": "BNBBTC",
        "openPrice": "0.10000000",
        "highPrice": "2.00000000",
        "lowPrice": "0.10000000",
        "lastPrice": "2.00000000",
        "volume": "39.00000000",
        "quoteVolume": "13.40000000", // 此k线内所有交易的price(价格) x volume(交易量)的总和
        "openTime": 1656986880000,    // ticker窗口的开始时间
        "closeTime": 1657001297799,   // ticker窗口的结束时间
        "firstId": 0,                 // 首笔成交id
        "lastId": 34,
        "count": 35                   // 统计时间内交易笔数
    },
    {
        "symbol": "LTCBTC",
        "openPrice": "0.07000000",
        "highPrice": "0.07000000",
        "lowPrice": "0.07000000",
        "lastPrice": "0.07000000",
        "volume": "33.00000000",
        "quoteVolume": "2.31000000",
        "openTime": 1656986880000,
        "closeTime": 1657001297799,
        "firstId": 0,
        "lastId": 32,
        "count": 33
    }
]

查询参考价格

GET /api/v3/referencePrice

查询某个交易对的参考价格。

权重: 2

参数:

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

数据源: 缓存

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

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

响应:

如果设置了参考价格：

{
    "symbol": "BAZUSD",
    "referencePrice": "10.00", // 参考价格。如果没有设置参考价格，则为 `null`。
    "timestamp": 1770736694138 // 参考价格有效时的时间戳。
}

如果未设置参考价格：

{
    "symbol": "BAZUSD",
    "referencePrice": null,    // 参考价格。如果没有设置参考价格，则为 `null`。
    "timestamp": 1770736694138 // 参考价格生效的时间
}

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

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

查询参考价格计算方式

GET /api/v3/referencePrice/calculation

描述某个交易对的参考价格是如何计算的。

权重: 2

参数:

名称	类型	是否必须	描述
symbol	STRING	YES
symbolStatus	ENUM	NO	支持的值: TRADING, HALT, BREAK

数据源: 缓存

响应:

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

{
    "symbol": "BAZUSD",
    "calculationType": "ARITHMETIC_MEAN", // `ARITHMETIC_MEAN` 或 `EXTERNAL`。
    "bucketCount": 10,                    // 当 calculationType 为 ARITHMETIC_MEAN 时存在。
    "bucketWidthMs": 1000                 // 当 calculationType 为 ARITHMETIC_MEAN 时存在。
}

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

{
    "symbol": "BAZUSD",
    "calculationType": "EXTERNAL", // `ARITHMETIC_MEAN` 或 `EXTERNAL`。
    "externalCalculationId": 42    // 当 calculationType 为 EXTERNAL 时存在。
}

如果参考价格未被计算：

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