欧易 API 怎么申请？API Key、密钥与 Passphrase 设置

欧易 API Key 在账户的 API 管理 页面创建，需要先开启双重验证（2FA）。和币安不同的是，创建时你要 自己设定一个 Passphrase（API 密码），系统再生成 API Key 与 Secret Key，三者缺一不可。权限分读取、交易、提币，建议只开程序用到的项目，并绑定 IP 白名单。

只想查行情或资金费率，不需要任何 Key，见 用 API 获取资金费率。

申请欧易 API 需要什么条件？

创建 API Key 不收费，常见的前提条件有：

1. 开启双重验证：例如身份验证器 App，这是创建 Key 的必要条件。
2. 完成身份认证：一般需要先完成身份认证才能使用交易相关功能，要求以页面提示为准。
3. 所在地区可以使用服务：欧易的服务范围因地区而异，是否能使用以官方说明为准。
4. 想交易合约，账户要能交易合约：例如账户模式需要支持永续合约，否则程序调用合约接口会失败。

欧易 API Key 怎么创建？

菜单位置与按钮名称可能随版本调整，以页面显示为准，大致流程如下：

1. 登录欧易网页版，在个人中心或账户菜单里找到 API 相关的管理页面。
2. 选择创建 API Key，填写备注名，例如“资金费率记录”。
3. 设定 Passphrase：按页面要求输入一组自己的密码，这组密码之后无法在页面上查看，要另外保存好。
4. 选择权限：读取、交易、提币，按用途勾选。
5. 填写 IP 白名单（可选但强烈建议），可以填一个或多个固定 IP。
6. 完成安全验证后，页面显示 API Key 与 Secret Key，立即保存。

保存时建议把三样东西放在密码管理工具或加密文件里，而不是记在手机备忘录或聊天记录里。

OKX API Passphrase 是什么？忘了怎么办？

Passphrase 可以理解为“这个 Key 的第二道密码”。程序调用私有接口时，请求头里要同时带上 API Key、签名、时间戳与 Passphrase，欧易核对全部正确才会执行。

几个容易混淆的地方：

• 它不是登录密码，也不是资金密码，只属于这一个 API Key。
• 每个 Key 可以设不同的 Passphrase，建议不要和任何其他密码重复。
• 忘记后一般无法找回，页面也不会再显示，只能删除旧 Key、重新创建并更新程序设置，以页面提示为准。

因为多了一层 Passphrase，单独外泄 Secret Key 时攻击者还缺一样东西，但不要因此放松。很多泄露是整份配置文件一起外泄，三者往往同时落入他人手中。

API Key、Secret Key、Passphrase 有什么区别？

项目	由谁产生	作用	可以给别人吗
API Key	系统生成	标识是哪个 Key，放在请求头	尽量不要
Secret Key	系统生成	对请求计算签名	绝对不行
Passphrase	你自己设定	额外的验证密码，放在请求头	绝对不行

签名的做法是用 Secret Key 对“时间戳 + 请求方法 + 路径 + 请求内容”计算哈希，再放进请求头。具体格式以 欧易 API 文档 为准，建议使用成熟的开源库，不要自己拼接后又随手贴到论坛求助，求助时也一定要先删掉 Key 与密码。

欧易 API 权限怎么选？

权限	能做什么	适合的用途	建议
读取	查询资产、持仓、订单、账单	记账、盈亏统计、监控	默认开启
交易	下单、撤单、调整杠杆与保证金	网格、套利、自建策略	程序要下单才开
提币	把资产提到外部地址	极少数自建资金调度	不建议开启

欧易的交易权限通常同时涵盖现货与合约，不像币安分成现货和合约两个开关，所以开交易权限前，要确认程序只会做你预期的市场。若想限制程序能动用的资金，可以用子账户把资金隔开，再在子账户下创建 Key，子账户的开通条件以欧易页面为准。

欧易 API 要不要绑定 IP 白名单？

建议绑定。绑定后，即使 API Key、Secret Key 与 Passphrase 全部外泄，攻击者从其他 IP 发出的请求也会被拒绝。

绑定的前提是程序运行在固定 IP 的机器上，例如云服务器。家用网络的 IP 可能变动，绑定后要留意连线失败的情况。未绑定 IP 的 Key 在有效期或权限方面可能有额外规则，以欧易官方说明为准。完整的安全做法见 交易所 API 安全。

欧易模拟盘 API 怎么用？

欧易提供模拟交易环境，适合在投入真实资金前测试程序。模拟盘需要在模拟交易模式下另外创建 API Key，调用时也要按文档标示为模拟交易请求，具体方式以官方文档为准。

建议的顺序是：先用公开接口练习读取数据，再用模拟盘 Key 测试下单逻辑，最后才用小额真实资金运行。模拟盘的成交深度与真实市场不同，测试结果只能参考。

创建后怎么测试？调用失败怎么排查？

建议先只开读取权限，用程序查询一次账户余额。返回成功，代表 Key、Passphrase、签名与 IP 都设置正确，之后再按需要加开交易权限。欧易的接口会在返回内容里附上代码，成功时是 "0"，失败时会带有错误代码与说明。常见的失败原因有：

1. Passphrase 输入错误：大小写、空格或复制时多带了字符，都会验证失败。
2. 签名对不上：时间戳格式、请求路径或请求内容和签名时使用的不一致。
3. 本机时间偏差：时间戳与服务器时间相差太多会被拒绝，开启系统自动校时即可。
4. IP 不在白名单：程序所在机器的出口 IP 与设置不同。
5. 权限或账户模式不符：例如只开了读取却调用下单接口，或账户模式不支持该产品。

各错误代码的含义以欧易官方文档为准。排查时不要把完整的请求头贴到公开场合，里面就包含 Key 与 Passphrase。不再使用的 Key 要及时删除，换机器或换程序时直接创建新 Key 更安全。

欧易 API 和币安 API 有什么不同？

项目	欧易	币安
组成	API Key + Secret Key + Passphrase	API Key + Secret Key
交易权限	通常是一个交易开关	现货及杠杆、合约分开勾选
提币权限	有，不建议开	有，须先设置 IP 限制才能开
公开资金费率接口	/api/v5/public/funding-rate	/fapi/v1/premiumIndex
合约手续费（一般用户）	挂单 0.02%、吃单 0.05%	挂单 0.02%、吃单 0.05%

两家通过 API 下单的手续费都与手动下单相同。举例：程序以吃单开一笔 20,000 USDT 的永续仓位，手续费是 20,000 × 0.05% = 10 USDT，再以吃单平仓又是约 10 USDT，进出一次合计约 20 USDT。若开平仓都改用挂单，是 20,000 × 0.02% × 2 = 8 USDT。费率细节见 欧易手续费指南，币安的申请步骤见 币安 API 怎么申请。

还没有账户的话，注册入口见文末或 邀请码页。