运行与复盘 / 约 9 分钟
API:让程序读行情的接口
读数据、查账户、下订单,是不同的权限。
学完这一课,你会
- 知道公开行情为何无需密钥
- 理解最小权限和密钥保护
- 理解限频、超时和断线后的正确处理
这一课的内容
API 可以理解成服务窗口
你在网页上点按钮,程序则通过 API 发出格式固定的请求。读取公开行情像看公告栏,查看个人余额像查询自己的账单,下单则是在提交交易指令。它们的权限不同。
Binance 提供无需 API key 的公开行情地址,本项目只向允许的公开接口发 GET 请求,因此不需要你的账号密码或密钥。能读到价格不代表登录了交易账户,也不代表任何受地区限制的交易服务已经获准使用。
有一天需要密钥,先确定用途
API key 像一把限定用途的钥匙。只查账就不应给交易权限;只是练习官方 Demo,就不应混用真实环境的密钥。权限、环境地址和账户必须一起核对,不能只凭文件名叫“模拟”就判断安全。
密钥不应该写进网页 JavaScript、公开仓库、截图或聊天记录。程序要用时应从服务端的受保护配置读取;若平台支持,可再限制来源 IP。更换、撤销密钥和检查权限也属于日常维护。当前学习站没有任何需要你填入密钥的步骤。
报错后,先弄清平台知道什么
HTTP 429 表示请求超过限频,应该依照平台的等待提示降低频率。重复猛发可能触发进一步限制。把请求开得越快并不等于行情越准确;程序还要标记过期数据、保存错误并检查恢复后的连续性。
若未来接入正式订单接口,超时可能意味着“状态未知”,而不一定是“下单失败”。平台可能已经收到订单,只是回复没到。应先按订单标识查询状态,再决定后续动作,不能盲目再发一单。这个原则也适用于模拟 API 的对接设计。
- 读行情失败:标记数据不新鲜,暂停依赖它的成交判断。
- 收到限频:停止密集重试,等待并降低请求负担。
- 订单状态未知:先查状态,避免重复下单。
- 恢复连接:核对时间和账本,不擅自补做错过的交易。
一步步算 / 教学假设
教学例子:超时为什么不能再点一次
- 假设一个未来接入平台的程序提交“买 1 个虚拟单位”。
- 平台已经记录订单,但网络断了一下,程序没有收到回复。
- 如果立刻再提交一次,可能变成买了 2 个。
- 更合理的顺序是:保留原订单标识,恢复后查询原单状态,再按预先设计的流程处理。
通信失败描述的是消息往来,不一定描述订单的最终结果。
容易弄错的地方
- 为了读取公开价格就交出带交易权限的密钥。
- 把真实与 Demo 环境的地址、密钥混着使用。
- 收到超时或 429 后不断重试同一笔下单。
带走一句话API 接通只是开始;权限、状态核对和断线处理同样重要。
检查一下理解
接口返回下单超时、执行状态未知时,应先做什么?
答对后,记录本课进度。可以重复练习。
本课来源与延伸阅读
概念依据见下列原始资料;教学算例由本课程编写。平台界面、费率与可用资格可能变化。
- Binance 官方:无需认证的公开行情接口
核对公开行情地址无需 API key,且不提供私人账户接口。
核实日期:2026-09-23 - Binance 官方:REST API 安全类型、限频与超时
核对 429、Retry-After、接口权限与订单超时后状态可能未知。
核实日期:2026-09-23 - Binance 官方:Demo Trading 使用与限制
核对官方模拟账户、API 支持、地区资格,以及模拟与真实成交存在差异。
核实日期:2026-09-23