当你想用交易机器人自动下单、用第三方工具分析持仓、或者自己写程序调用行情数据的时候,都需要用到币安的API接口。API就像是你交给程序的一把"钥匙",程序拿着这把钥匙可以代替你执行特定操作。
还没有币安账号的话,先通过 币安官网 注册一个,注册链接自带手续费折扣。如果你习惯手机操作,也可以 下载币安App 完成注册和后续设置。
什么是API Key和Secret Key
创建API后,你会得到两样东西:
- API Key:相当于你的用户名,用来告诉币安"我是谁"
- Secret Key:相当于你的密码,用来验证请求确实是你发出的
这两个值配合使用,程序才能通过API与你的币安账户交互。Secret Key只在创建时显示一次,之后就看不到了,所以务必在创建时立即保存。
申请API Key的前置条件
在创建API之前,你的账户需要满足:
- 完成身份认证(KYC)
- 开启双重验证(推荐Google Authenticator)
- 账户状态正常,没有安全限制
如果这些都已经完成,就可以开始创建了。
创建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不在白名单里也无法使用。
怎么设置:
- 在API详情页面找到"IP访问限制"选项
- 选择"限制仅受信任的IP访问"
- 填入你的服务器IP地址或本地IP地址
- 保存设置
如果你在本地电脑上运行程序,填写你的公网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是一个强大的工具,但能力越大责任越大。第一次使用时,建议先用小金额测试,确认一切正常后再放开交易规模。