币安 Binance调用手册
读取最近的现货小时 K线
读取最近 10 根 1 小时 K线,掌握 OHLC、成交量和时间字段。
← 返回平台功能接入准备
- 公共现货行情请求,无需 API Key。
本场景的示例无需设置环境变量;按参数说明替换示例中的资源标识。
调用步骤
- 01
设置 symbol=BTCUSDT、interval=1h、limit=10;Binance 小时周期是小写 h。
- 02
将数组行按开盘时间解释,并按时间去重保存。
- 03
采集历史时设置 startTime/endTime 为 UTC 毫秒;收到不满页或到达目标时间即停止,避免无限循环。
调用 01
查询 K线
省略开始结束时间时返回最近 K线;默认时区 UTC。
GET
https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=10请求头
Acceptapplication/json
参数说明
参数表可左右滑动,查看完整说明。
| 字段 / 位置 | 类型 / 必填 | 说明 |
|---|---|---|
symbolQuery | string必填 | 现货交易对,例如 BTCUSDT。 |
intervalQuery | string必填 | 区间大小写敏感,示例 1h;1m 是分钟,1M 是月。 |
limitQuery | integer可选 | 默认 500、最大 1000;示例 10。 |
startTime / endTimeQuery | integer可选 | UTC 毫秒时间戳;即便提供 timeZone,这两个边界仍按 UTC 解释。 |
调用代码
替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
--request GET \
--url "https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=10" \
--header "Accept: application/json"
import json
import os
import re
import urllib.request
import urllib.error
def expand(value):
return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
lambda match: os.environ[match.group(1)], value)
url = expand("https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=10")
headers = {
"Accept": expand("application/json"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
except urllib.error.HTTPError as error:
print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
return process.env[name];
});
}
const url = expand("https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=10");
const headers = Object.fromEntries(
Object.entries({
"Accept": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
method: "GET",
headers,
signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
返回示例
按官方结构整理的节选示意,非实测结果。每行固定 12 项:[开盘毫秒,o,h,l,c,基础币量,收盘毫秒,报价币量,成交笔数,主动买入基础币量,主动买入报价币量,忽略项]。 以下为结构示意,非本站实测结果。
[
[
1735689600000,
"60000",
"60200",
"59800",
"60100",
"12",
1735693199999,
"720000",
30,
"6",
"360000",
"0"
]
]常见错误与排查
-1121无效交易对- 使用现货交易对标识 BTCUSDT,不加连字符;先核对 exchangeInfo。
HTTP 429 / -1003IP 请求权重或请求频率超限- 按 Retry-After 等待并降低调用频率,不持续重试导致 IP 封禁。
调用注意
- 当前请求权重为 2;最新一根可能仍未收盘,做历史回测应根据收盘时间排除当前区间。
注意事项
- 本轮仅提供只读查询;示例不含下单、杠杆、划转或提现。Binance.com 服务与各地区独立站点的账户和资格不能互换。
- 公开行情无需 API Key,但仍消耗 IP 请求权重;查询权重不是交易手续费,实际交易另按账户费率。
核验来源
本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。
- 01Binance REST 签名与时间窗口核验日期 2026-10-15
- 02Binance Spot 市场查询参数核验日期 2026-10-15
- 03Binance 现货错误码核验日期 2026-10-15
