运行与复盘 / 约 9 分钟

API:让程序读行情的接口

读数据、查账户、下订单,是不同的权限。

学完这一课,你会

  • 知道公开行情为何无需密钥
  • 理解最小权限和密钥保护
  • 理解限频、超时和断线后的正确处理
这一课的内容
01

API 可以理解成服务窗口

你在网页上点按钮,程序则通过 API 发出格式固定的请求。读取公开行情像看公告栏,查看个人余额像查询自己的账单,下单则是在提交交易指令。它们的权限不同。

Binance 提供无需 API key 的公开行情地址,本项目只向允许的公开接口发 GET 请求,因此不需要你的账号密码或密钥。能读到价格不代表登录了交易账户,也不代表任何受地区限制的交易服务已经获准使用。

02

有一天需要密钥,先确定用途

API key 像一把限定用途的钥匙。只查账就不应给交易权限;只是练习官方 Demo,就不应混用真实环境的密钥。权限、环境地址和账户必须一起核对,不能只凭文件名叫“模拟”就判断安全。

密钥不应该写进网页 JavaScript、公开仓库、截图或聊天记录。程序要用时应从服务端的受保护配置读取;若平台支持,可再限制来源 IP。更换、撤销密钥和检查权限也属于日常维护。当前学习站没有任何需要你填入密钥的步骤。

03

报错后,先弄清平台知道什么

HTTP 429 表示请求超过限频,应该依照平台的等待提示降低频率。重复猛发可能触发进一步限制。把请求开得越快并不等于行情越准确;程序还要标记过期数据、保存错误并检查恢复后的连续性。

若未来接入正式订单接口,超时可能意味着“状态未知”,而不一定是“下单失败”。平台可能已经收到订单,只是回复没到。应先按订单标识查询状态,再决定后续动作,不能盲目再发一单。这个原则也适用于模拟 API 的对接设计。

  • 读行情失败:标记数据不新鲜,暂停依赖它的成交判断。
  • 收到限频:停止密集重试,等待并降低请求负担。
  • 订单状态未知:先查状态,避免重复下单。
  • 恢复连接:核对时间和账本,不擅自补做错过的交易。

一步步算 / 教学假设

教学例子:超时为什么不能再点一次

  1. 假设一个未来接入平台的程序提交“买 1 个虚拟单位”。
  2. 平台已经记录订单,但网络断了一下,程序没有收到回复。
  3. 如果立刻再提交一次,可能变成买了 2 个。
  4. 更合理的顺序是:保留原订单标识,恢复后查询原单状态,再按预先设计的流程处理。

通信失败描述的是消息往来,不一定描述订单的最终结果。

容易弄错的地方

  • 为了读取公开价格就交出带交易权限的密钥。
  • 把真实与 Demo 环境的地址、密钥混着使用。
  • 收到超时或 429 后不断重试同一笔下单。

带走一句话API 接通只是开始;权限、状态核对和断线处理同样重要。

检查一下理解

接口返回下单超时、执行状态未知时,应先做什么?

答对后,记录本课进度。可以重复练习。

本课来源与延伸阅读

概念依据见下列原始资料;教学算例由本课程编写。平台界面、费率与可用资格可能变化。

独立学习资料 / 教学与模拟

非币安或 Claude 官方网站。练习数字为教学假设,不承诺收益。

学习路线资料来源