币启 ZH EN JA KO 币安官方
首页 教程 专栏 关于我们 币安官方
ZH EN JA KO

币安API接口怎么申请和配置

当你想用交易机器人自动下单、用第三方工具分析持仓、或者自己写程序调用行情数据的时候,都需要用到币安的API接口。API就像是你交给程序的一把"钥匙",程序拿着这把钥匙可以代替你执行特定操作。

还没有币安账号的话,先通过 币安官网 注册一个,注册链接自带手续费折扣。如果你习惯手机操作,也可以 下载币安App 完成注册和后续设置。

什么是API Key和Secret Key

创建API后,你会得到两样东西:

  • API Key:相当于你的用户名,用来告诉币安"我是谁"
  • Secret Key:相当于你的密码,用来验证请求确实是你发出的

这两个值配合使用,程序才能通过API与你的币安账户交互。Secret Key只在创建时显示一次,之后就看不到了,所以务必在创建时立即保存。

申请API Key的前置条件

在创建API之前,你的账户需要满足:

  1. 完成身份认证(KYC)
  2. 开启双重验证(推荐Google Authenticator)
  3. 账户状态正常,没有安全限制

如果这些都已经完成,就可以开始创建了。

创建API Key的完整步骤

第一步:找到API管理页面

登录币安网页端,点击右上角的个人头像,在下拉菜单中选择"API管理"。你也可以直接在页面顶部的搜索栏里搜"API"快速跳转。

第二步:给API取个名字

进入API管理页面后,在输入框中填一个标签名,比如"量化机器人"或"行情读取"。这个名字只是方便你自己区分,不影响任何功能。然后点击"创建API"。

第三步:完成安全验证

系统会要求你完成双重验证——通常是邮箱验证码加上Google Authenticator验证码。按提示操作即可。

第四步:保存Secret Key

验证通过后,页面会同时显示API Key和Secret Key。这是Secret Key唯一一次完整显示的机会。立即把它复制并保存到安全的地方,比如密码管理器里。千万不要截图发给别人,也不要存在聊天记录里。

配置API权限

创建好API Key之后,接下来最重要的一步是设置权限。默认情况下,新创建的API Key只有"读取"权限。你需要根据实际用途手动开启其他权限:

读取权限(默认开启)

可以查询账户余额、历史订单、行情数据等。如果你只是想用第三方工具看持仓分析,只开这个权限就够了。

交易权限

允许通过API下单、撤单、修改订单。跑量化交易机器人的话必须开启。开启后,程序就能在你的账户上自动买卖。

提现权限

允许通过API发起提现操作。除非你非常确定需要,否则强烈建议不要开启。绝大多数使用场景都不需要这个权限。一旦API Key泄露,开启了提现权限意味着资金可能被转走。

权限配置的原则是"最小够用":程序需要什么权限就只开什么权限,能不开的就不开。

设置IP白名单

这是很多人忽略但极其重要的一步。IP白名单的意思是:只允许特定IP地址使用这个API Key。

为什么要设IP白名单?

如果不设白名单,任何人拿到你的API Key和Secret Key,从任何地方都能调用你的账户。设了白名单之后,即使密钥泄露,对方因为IP不在白名单里也无法使用。

怎么设置:

  1. 在API详情页面找到"IP访问限制"选项
  2. 选择"限制仅受信任的IP访问"
  3. 填入你的服务器IP地址或本地IP地址
  4. 保存设置

如果你在本地电脑上运行程序,填写你的公网IP(可以在搜索引擎搜"我的IP"查看)。如果用的是云服务器,填写服务器的IP。

需要注意的是,如果你的IP是动态的(大多数家庭宽带都是),每次IP变了都需要回来更新白名单。这种情况下,使用固定IP的云服务器会方便很多。

实际接入测试

配置完成后,建议先做一个简单的测试,确认API能正常工作。

用Python举个最基本的例子:

from binance.client import Client

api_key = '你的API_Key'
api_secret = '你的Secret_Key'

client = Client(api_key, api_secret)

# 测试连接:获取账户信息
account = client.get_account()
print(account['balances'][:5])  # 打印前5个币种余额

如果返回了账户余额信息,说明API配置成功。如果报错,常见原因包括:

  • Secret Key复制错了(多了空格或少了字符)
  • IP不在白名单里
  • 权限没有正确开启
  • 系统时间不同步(API请求对时间戳有严格要求,电脑时间偏差超过几秒就会失败)

API使用的安全建议

API的安全性再怎么强调都不过分。一旦密钥泄露且权限设置不当,损失可能是立即且不可逆的。

绝对不要做的事情:

  • 不要把API Key和Secret Key写在公开的代码仓库里(GitHub上因此丢币的案例很多)
  • 不要在微信、Telegram等聊天工具里发送密钥
  • 不要给不信任的第三方工具授权交易和提现权限

应该做的安全措施:

  • 使用环境变量或配置文件存储密钥,不要硬编码在程序里
  • 定期轮换API Key,删除不再使用的旧Key
  • 设置IP白名单
  • 关闭不需要的权限
  • 开启币安的API交易风控提醒

常见问题

Q:一个账户最多能创建多少个API Key?

普通用户通常可以创建30个API Key。VIP用户的限额更高。

Q:API Key有有效期吗?

默认没有有效期,除非你手动删除或者触发了安全风控。但如果90天内没有使用过,币安可能会自动停用。

Q:用API交易手续费跟手动交易一样吗?

一样的,手续费按照你的VIP等级和是否使用BNB抵扣来计算,跟是否通过API下单没有关系。

API是一个强大的工具,但能力越大责任越大。第一次使用时,建议先用小金额测试,确认一切正常后再放开交易规模。

下载币安App

安卓APK直接装,苹果换海外ID即可

现在就注册币安

通过本站链接注册,每笔交易自动享受20%手续费减免