欧易全球站 API 密钥获取指南
本指南旨在详细介绍如何在欧易全球站（OKX）获取 API 密钥，以便您能够利用 API 接口进行自动化交易、数据分析等操作。请务必仔细阅读并遵循以下步骤。
第一步：登录您的欧易全球站账户
为了开始使用欧易全球站的API，您需要访问其官方网站 www.okx.com ，并使用您已注册的账户名和密码安全登录。请务必确认您访问的是官方网站，以防止钓鱼攻击和信息泄露。如果您尚未拥有欧易全球站账户，则需要先注册一个。注册流程通常包括提供有效的邮箱地址或手机号码，并设置一个高强度的安全密码。强烈建议启用双重身份验证（2FA），例如Google Authenticator或短信验证，以提高账户安全性。成功注册后，您必须完成身份验证 (KYC – Know Your Customer)，这通常涉及提交身份证明文件、进行人脸识别等步骤，以解锁完整的 API 功能。欧易全球站根据其政策，将用户划分为不同的 KYC 级别，每个级别对应不同的 API 访问权限、交易额度限制以及其他相关服务的使用资格。例如，未经KYC认证的账户可能只能进行非常有限的API调用或交易，而更高级别的KYC认证则可以解锁更高的API调用频率限制和更大的交易额度。
第二步：进入API管理页面
成功登录您的加密货币交易所账户后，请将鼠标指针悬停在页面右上角，通常显示您个人资料的头像图标上。此时，一个下拉菜单将会展开。在这个下拉菜单中，仔细查找名为“API”、“API管理”或者类似的选项，具体的名称可能因交易所而异，但其核心功能均为 API 密钥的管理。点击此选项，系统将会自动将您重定向至API管理页面。该页面是您创建、查看、编辑和删除API密钥的核心枢纽，也是进行API相关配置的关键位置。请确保网络连接稳定，以便顺利加载API管理页面及其包含的各项功能。
第三步：创建新的API密钥
为了能够安全且高效地与加密货币交易所或服务进行交互，你需要创建一对API密钥：一个公钥（API Key）和一个私钥（Secret Key）。API密钥就像用户名和密码一样，但它们专门用于程序化访问，而不是人工登录。在API管理页面，通常会有一个清晰可见的按钮，例如“创建API密钥”、“生成API密钥”或类似的文字。这个按钮的作用是启动创建新密钥对的过程。点击此按钮，系统将引导你完成后续步骤，配置新API密钥的权限和访问级别。
第四步：填写API密钥信息
点击创建按钮后，系统将引导您填写关于 API 密钥的详细信息。正确配置这些信息对于 API 密钥的安全使用和功能实现至关重要。您需要填写的信息通常包括以下几个方面：
API 密钥名称： 为您的 API 密钥指定一个易于识别的名称。例如，您可以根据您使用 API 的目的命名，如“量化交易策略”、“数据分析”、“自动跟单” 等。 选择一个清晰明确的名称可以帮助您在管理多个 API 密钥时进行区分。- 只读： 此权限允许您读取市场数据、账户信息等，但不能进行任何交易操作。这是最安全的权限，适用于数据分析等不需要交易的场景。
- 交易： 此权限允许您进行现货交易、合约交易等。选择此权限时，请务必谨慎，并采取额外的安全措施，例如启用提币白名单。
- 提币： 此权限允许您从欧易账户中提币。请谨慎使用此权限，因为它具有最高的安全风险。强烈建议不要将此权限授予给您不完全信任的应用程序。 如果您需要使用 API 进行提币操作，请务必启用提币白名单，并设置提币限额，以最大限度地降低风险。
- 永续合约： 允许您进行永续合约交易。
- 交割合约： 允许您进行交割合约交易。
- 模拟交易： 允许您在模拟交易环境中测试您的策略。
第五步：启用双重验证 (2FA)
在您确认所有API密钥申请信息均准确无误后，系统将强制执行双重验证(2FA)流程，以进一步增强账户的安全性。此步骤至关重要，用于验证您的身份并确保只有授权用户才能生成API密钥。
双重验证通常采用以下方式之一：
- Google Authenticator 代码: 您需要使用已绑定到交易所账户的Google Authenticator应用程序生成一次性密码 (OTP)。 每次登录或进行敏感操作（例如创建API密钥）时，应用程序都会生成一个新的唯一代码。
- 短信验证码 (SMS): 交易所会将一个包含验证码的短信发送到您注册时提供的手机号码。 您需要在指定时间内输入该验证码才能继续操作。请注意，某些地区可能不支持短信验证码，或者存在延迟。
- 电子邮件验证码: 交易所会将一个包含验证码的电子邮件发送到您注册时使用的电子邮件地址。 检查您的收件箱（以及垃圾邮件/垃圾箱），找到验证邮件并输入其中的代码。
请务必妥善保管您的双重验证设备（手机或备份密钥）并且定期检查双重验证设置，确保其有效且最新。 丢失双重验证设备可能会导致账户访问困难，您可能需要联系交易所客服进行身份验证和账户恢复。
强烈建议您启用并使用2FA，即使交易所没有强制要求，因为这是保护您的加密货币资产和API密钥免受未经授权访问的最有效方法之一。
第六步：保存API密钥
成功启用双重验证后，系统会生成并显示您的 API 密钥 (API Key) 和密钥 (Secret Key)。 务必采取一切必要措施妥善保管您的 Secret Key，因为它是您访问 API 的唯一凭证，类似于您的密码。 Secret Key 只会**完整地**显示一次，一旦离开此页面或关闭窗口，将无法再次查看。如果您遗失或忘记了 Secret Key，出于安全考虑，您将需要删除当前 API 密钥并重新生成一个全新的 API 密钥。建议您立即将 Secret Key 复制并存储在安全可靠的位置，例如加密的密码管理器、离线存储介质，或者其他您信任的安全存储方案中。务必避免将 Secret Key 存储在不安全的云服务、电子邮件或未加密的文本文件中，以防止未经授权的访问。请将 API Key 和 Secret Key 视为银行账户的账号和密码，谨慎保管至关重要。不当保管可能会导致您的账户遭受潜在的风险，例如未经授权的交易或数据泄露。
第七步：启用API密钥
成功创建API密钥后，需要等待一段时间才能使其生效。密钥的激活延迟是出于安全考虑，以防止未经授权的访问和滥用。您可以稍后返回欧易交易所的API管理页面，仔细查看新创建API密钥的状态。通常，状态会显示为“已激活”、“可用”或类似的字样，表明该密钥已准备就绪，可以用于访问欧易的API服务。
如果API密钥的状态长时间显示为“未激活”、“待处理”或类似的未激活状态，请耐心等待一段时间后再次检查。API密钥的激活时间可能受到多种因素影响，例如系统负载、安全审核等。如果等待时间过长（例如超过几小时），API密钥仍然处于未激活状态，建议及时联系欧易交易所的客服人员，寻求专业的技术支持和帮助，以便尽快解决问题并启用您的API密钥。提供密钥ID或相关信息可以帮助客服人员更快速地定位并解决问题。同时，请务必确保您按照欧易交易所的官方文档和指南正确地完成了API密钥的创建和配置步骤，避免因操作失误导致激活失败。
API密钥安全注意事项
- 切勿分享您的 API 密钥和 Secret Key 给任何人。 API 密钥和 Secret Key 是访问您账户的凭证，泄露它们将导致资金损失和数据泄露的风险。请将它们视为高度机密信息，如同您的银行密码一样保护。
- 避免在不安全的地方存储 API 密钥和 Secret Key，例如明文文件、代码仓库或公共服务器。 使用加密的密钥管理工具或环境变量来安全地存储这些敏感信息。考虑使用硬件安全模块 (HSM) 或密钥管理服务 (KMS) 以获得更高的安全性。
- 定期轮换您的 API 密钥，尤其是在发现潜在安全漏洞或密钥泄露的情况下。 轮换密钥可以降低因旧密钥被盗用而造成的损失。 建议至少每 90 天轮换一次 API 密钥。
- 启用提币白名单和IP地址绑定等安全设置，以限制 API 密钥的使用范围。 提币白名单只允许 API 密钥将资金转移到预先批准的地址，而IP地址绑定则限制 API 密钥只能从特定的 IP 地址访问。 这些措施可以有效防止未经授权的提币操作。
- 密切监控您的 API 使用情况，包括交易量、请求频率和账户余额变动，以便及时发现异常行为。 设置警报系统，以便在检测到可疑活动时立即收到通知。 分析 API 日志以识别潜在的安全威胁。
- 使用完毕后，立即禁用或删除不再使用的 API 密钥。 长期不使用的 API 密钥可能会成为攻击目标，因此应及时清理。 确保撤销所有与已删除 API 密钥相关的权限。
- 仔细阅读欧易官方的 API 文档，充分了解 API 的使用规则、限制和最佳实践。 掌握 API 的功能和限制对于安全有效地使用 API 至关重要。 特别注意速率限制、身份验证方法和数据格式。
- 在生产环境中使用 API 之前，务必在模拟环境（也称为沙箱环境或测试网）中进行充分的测试和调试。 在真实资金面临风险之前，确保您的 API 集成工作正常且安全可靠。 验证所有交易逻辑和错误处理机制。