Binance API接口教程：如何获取实时行情与交易数据-游吧乐下载

最近不少朋友在问币安API到底怎么用，尤其是想获取实时行情或者做量化交易的小白，网上资料东一块西一块，看着头大。我自己从零折腾过币安API，踩了不少坑，今天干脆把经验整理成一篇接地气的教程，从申请API Key到写代码拉数据、下单，一步步带大家走一遍，保证你看完能直接上手。

币安API接口教程封面预览图

先说明一下，这篇文章主要针对的是币安现货和USDT本位合约的API，数据接口和交易接口都会讲到。文章里会有Python代码示例，但就算你不懂Python，光看流程和注意事项也能帮你少走很多弯路。

第一步：怎么申请Binance API Key？

要用币安API，首先你得有个币安账号，然后登录后台去创建API Key。路径很简单：右上角头像 → API管理 → 创建API。创建的时候会让你输入一个备注名，随便起个比如“我的交易机器人”就行。接着会让你设置安全验证，一般是用邮箱验证码+谷歌验证器，输完就创建成功了。

这里提醒几个关键点：第一，API Key和Secret Key只显示一次，Secret Key一定要保存好，不然关掉页面就再也看不到了。第二，建议把“仅限读取”的权限打开，如果你只是拉行情数据，完全不需要交易权限，这样就算Key泄露了，别人也动不了你的钱。第三，如果要做交易，建议把IP访问限制打开，只允许你自己的服务器IP调用，安全系数高很多。

创建好之后，你会看到类似这样的信息：

api_key = "你的API Key"
api_secret = "你的Secret Key"

记得保密，别直接贴到GitHub或者聊天群里，不然等着被盗吧。

第二步：实时行情怎么获取？用REST接口还是WebSocket？

获取实时行情有两种主流方式：REST接口和WebSocket。REST接口适合低频拉取，比如你每隔几秒请求一次；WebSocket适合高频实时推送，比如做盘口监控或者高频交易。下面分别介绍。

先看REST接口，币安的现货行情基础地址是 https://api.binance.com，获取最新价格可以用：

GET /api/v3/ticker/price?symbol=BTCUSDT

用Python的requests库很简单：

import requests
url = "https://api.binance.com/api/v3/ticker/price"
params = {"symbol": "BTCUSDT"}
resp = requests.get(url, params=params)
print(resp.json())
# 输出：{'symbol': 'BTCUSDT', 'price': '50000.00'}

如果你想同时获取多个交易对的价格，也可以不传symbol，一次性拉全量数据，不过数据量比较大，不建议频繁请求。

再说说K线数据，也就是蜡烛图数据，做技术分析必备。接口是：

GET /api/v3/klines?symbol=BTCUSDT&interval=1h&limit=10

返回的是一堆列表，每个列表代表一根K线，依次是：开盘时间、开盘价、最高价、最低价、收盘价、成交量、收盘时间、成交额、成交笔数等等。具体字段顺序币安文档写得很清楚，新手容易搞混，建议直接打印看看。

然后就是WebSocket，币安的WebSocket地址是 wss://stream.binance.com:9443，订阅实时行情用类似这样的流：

wss://stream.binance.com:9443/ws/btcusdt@trade

用Python的websocket库就能连上，推送的数据是JSON格式，包含价格、数量、时间戳等。WebSocket的好处是延迟低，基本实时推送，适合需要秒级响应的场景。

Binance API实时行情获取代码示例预览图

第三步：如何用binance API下单交易？现货和合约都讲讲

下单之前，一定要先测试环境！币安提供了测试网，网址是 testnet.binance.vision，可以申请测试API Key，然后随便造，不用担心亏钱。我建议新手一定要先在测试网上跑通整个流程，再上实盘。

现货下单接口是：

POST /api/v3/order

需要签名，签名方式是用HMAC SHA256对参数做哈希，然后把签名加在请求里。具体流程是：把所有参数按字母序排列，拼成字符串，然后用Secret Key做HMAC加密，得到的摘要就是签名。Python代码里一般用 hmac 模块实现。

下面是一个简单的限价买单示例：

import hashlib
import hmac
import time
import requests

api_key = "你的API Key"
api_secret = "你的Secret Key"

params = {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "type": "LIMIT",
    "timeInForce": "GTC",
    "quantity": "0.001",
    "price": "40000"
}

query_string = "&".join([f"{k}={v}" for k, v in sorted(params.items())])
signature = hmac.new(api_secret.encode(), query_string.encode(), hashlib.sha256).hexdigest()

url = "https://api.binance.com/api/v3/order"
headers = {"X-MBX-APIKEY": api_key}
params["signature"] = signature
resp = requests.post(url, headers=headers, data=params)
print(resp.json())

注意，如果交易对不是USDT本位，可能精度不同，比如BTC的数量精度是6位，价格精度是2位，具体可以在交易所页面上看，或者用交易所信息接口查。

再讲合约交易，币安USDT本位合约的接口基础地址是 https://fapi.binance.com，下单接口是：

POST /fapi/v1/order

参数和现货类似，但多了个 positionSide（单向持仓还是双向持仓），还有 reduceOnly 之类的字段。合约交易风险大，杠杆倍数高，一定要设置好止损。

我自己的经验是，合约下单前最好先查一下当前合约的持仓模式和保证金类型，不然很容易报错。比如你开了双向持仓，但你下单时没指定positionSide，币安会直接拒绝。

第四步：常见报错和踩坑提醒，API调用总失败？看这里

新手经常遇到各种奇奇怪怪的报错，这里总结几个最常见的，帮你排查。

- **-1021 错误：时间戳过期**。这个是因为你的服务器时间和币安服务器时间差太多，需要同步时间。解决办法是调整系统时间，或者调用币安的时间接口 GET /api/v3/time 获取服务器时间，然后计算偏移量，在参数里加上 recvWindow 字段，默认5000毫秒。

- **-2015 错误：签名无效或者权限不足**。检查API Key和Secret Key是否正确，签名算法是不是SHA256，还有参数是否按照字母序排列。另外，如果你只开了读取权限，但尝试下单，就会报这个错。

- **-1102 错误：参数无效**。比如symbol写错了，或者quantity精度不对，price精度不对。建议先用 GET /api/v3/exchangeInfo 查一下交易对的精度规则。

- **-1111 错误：精度超限**。这类报错通常是因为下单数量或者价格小数位数超过了交易所规定的最大精度。

另外，请求频率也要注意，币安REST接口有权重限制，每个请求都会消耗一定权重，短时间请求太频繁会被封IP或者限制访问。建议加个限速，比如每秒不超过5次请求，或者使用官方推荐的权重管理策略。

还有一个很多人忽略的坑：如果你在国内，访问币安API可能会遇到网络问题，需要科学上网，而且节点不稳定会导致超时。这种情况下可以考虑用币安云（Binance Cloud）或者第三方代理，但我不推荐，自己注意安全。

Binance API常见错误码排查对照表预览图

第五步：有没有现成的Python库？binance-connector了解一下

如果你不想自己写签名和请求逻辑，币安官方提供了Python SDK，叫 binance-connector，GitHub上有开源，文档也齐全。安装很简单：

pip install binance-connector

然后你就可以直接用了，比如：

from binance.spot import Spot

client = Spot(api_key='你的API Key', api_secret='你的Secret Key')

# 获取BTCUSDT最新价格
print(client.ticker_price('BTCUSDT'))

# 获取K线数据
print(client.klines('BTCUSDT', '1h', limit=5))

# 下单示例
order = client.new_order('BTCUSDT', side='BUY', type='LIMIT', quantity=0.001, price='40000', timeInForce='GTC')
print(order)

这个库内部已经处理好了签名、请求、超时重试等逻辑，对于大多数开发者来说足够用了。不过底层原理还是需要了解一下，不然出了问题不知道怎么排查。

另外，网上还有一些第三方库比如 python-binance，功能也很强大，支持WebSocket封装，但更新可能不及时，建议优先用官方库。

第六步：如何获取历史交易数据？做回测和数据分析必备

如果你想做策略回测或者数据分析，需要获取历史K线数据，币安REST接口最多只能拿到最近1000根K线，如果需要更早的数据，就得通过 /api/v3/klines 接口循环请求，每次用不同的startTime和endTime。

比如你要拿BTCUSDT最近一年的小时K线，可以这样循环：

import requests
import time

base_url = "https://api.binance.com/api/v3/klines"
symbol = "BTCUSDT"
interval = "1h"
start_time = int(time.time()*1000) - 365*24*3600*1000
end_time = int(time.time()*1000)

all_klines = []
while start_time < end_time:
    params = {
        "symbol": symbol,
        "interval": interval,
        "startTime": start_time,
        "limit": 1000
    }
    resp = requests.get(base_url, params=params)
    data = resp.json()
    if not data:
        break
    all_klines.extend(data)
    start_time = data[-1][0] + 1
    time.sleep(0.2)  # 控制请求频率

print(f"总共获取 {len(all_klines)} 根K线")

注意控制请求频率，别一口气请求太多，不然会被封。另外，大周期K线比如日线、周线，可以直接用1000根，能覆盖好几年，基本够用。

如果你需要更精细的tick级别交易数据，那就只能通过WebSocket实时订阅并自己保存，或者从一些第三方数据商购买，币安本身不提供历史tick下载。