欧易API自动交易设置指南：量化交易入门教程

填写 API 信息：

• API 名称： 为你的 API 密钥设置一个易于识别且具有描述性的名称。例如，"My Trading Bot - v1.0" 或 "Arbitrage Strategy - Server A"。清晰的命名有助于你在管理多个 API 密钥时进行区分和追踪，方便日后维护和审计。
• 绑定 IP 地址（可选）： 为了显著提升安全性，强烈建议将 API 密钥绑定到特定的 IP 地址。这意味着只有来自指定的 IP 地址的请求才能通过此 API 密钥访问你的账户。这可以有效防止密钥泄露后被恶意利用。如果你不确定你的 IP 地址，或者需要从多个 IP 地址访问 API，你可以留空此项，但必须清楚这会显著降低安全性。 更好的做法是，通过动态DNS服务获取一个固定的域名，然后将该域名解析到你的动态IP地址，并使用该域名进行绑定。你也可以添加多个 IP 地址，使用逗号分隔多个IP。 特别提示： 绑定 IP 地址后，请确保你的服务器 IP 地址没有变化，否则 API 密钥将失效。定期检查你的服务器 IP 地址，并及时更新 API 密钥的绑定设置。
• 交易权限： 务必谨慎选择 API 密钥的权限。对于自动交易程序，你至少需要启用 "交易" 权限，这将允许程序执行买卖操作。如果你的策略需要查询账户余额，则需要启用 "读取" 或 "查看" 权限。 某些交易所还提供更精细的权限控制，例如，只允许交易特定交易对。 重要提示： 授予 API 密钥过多的权限会增加潜在风险。 只授予你的策略真正需要的最低权限， 遵循最小权限原则。
• 资金划转权限： 资金划转权限允许 API 密钥进行资产转移，包括提现和内部转账。 此权限极其敏感，需要极其谨慎地选择。 除非你的交易策略明确需要自动提现功能（例如，在不同交易所之间进行套利），否则强烈建议不要授予此权限。 即使需要此权限，也应该设置非常严格的提现地址白名单，并限制单日提现额度。 安全警告： 恶意程序可能会利用资金划转权限窃取你的资金。 务必确保你的交易程序是安全可靠的，并且你了解其所有的操作。 定期审计你的 API 密钥权限，确保没有不必要的权限被授予。
• 阅读并同意协议： 在创建 API 密钥之前，请务必仔细阅读并理解交易所的 API 使用协议。协议中包含了关于 API 使用的限制、责任和风险。理解协议内容有助于你合法合规地使用 API，并避免因违反协议而导致账户被冻结。

获取 API 密钥：

完成所需的信息填写，例如邮箱地址、联系方式以及账户安全相关的验证信息，并仔细阅读并同意API的使用条款和服务协议后，点击 "创建" 或 "提交" 按钮。系统将根据您提供的信息和请求，自动生成一个 API 密钥（API Key）和一个密钥（Secret Key），用于后续的API访问和身份验证。

请务必妥善保存这两个密钥，它们将用于你的代码中验证身份。 API Key 相当于您的公开用户名，用于标识您的应用程序或账户，而 Secret Key 则是您的私有密码，用于安全地验证您的 API 请求。切勿将 Secret Key 泄露给任何第三方，以防止未经授权的访问和潜在的安全风险。 Secret Key 只会显示一次，请务必备份。 建议您将其存储在安全的地方，例如密码管理器或加密的配置文件中。如果 Secret Key 丢失或泄露，您可能需要重新生成新的密钥对，并更新您的应用程序配置。

import ccxt

替换成你的 API 密钥、Secret Key 及 API 口令

api_key = 'YOUR_API_KEY' 这是你的API密钥，用于交易所验证你的身份，务必妥善保管，切勿泄露给他人。密钥区分大小写。

secret_key = 'YOUR_SECRET_KEY' 这是你的私钥，与API密钥配合使用，用于生成签名，验证请求的合法性。私钥同样需要极其小心地保管，任何泄露都可能导致资金损失。私钥区分大小写。

password = 'YOUR_PASSWORD' #API 口令（passphrase），如果你设置了 某些交易所（例如OKX）支持API口令（passphrase），这相当于API密钥的第二层保护。如果你的账户设置了API口令，请在此处填写。如果未设置，则留空即可。

exchange = ccxt.okx({ 'apiKey': api_key, 'secret': secret_key, 'password': password, #API 口令（passphrase），如果你设置了 'options': { 'defaultType': 'swap', # 默认为永续合约 }, }) 这是一个使用CCXT库初始化OKX交易所对象的示例。 apiKey 和 secretKey 分别对应你的API密钥和私钥。 password 对应API口令。 options 参数用于设置交易所的默认选项，在这里我们将 defaultType 设置为 'swap' ，表示默认交易类型为永续合约。这意味着，后续你调用交易所的交易接口时，如果没有特别指定交易类型，CCXT将默认使用永续合约。请注意，根据你的交易需求，可以修改 defaultType 的值，例如设置为 'spot' 表示现货交易，或者 'future' 表示交割合约。 另外， options 还可以配置更多参数，例如代理服务器设置，超时时间设置等， 具体可以参考CCXT的官方文档。

获取账户余额

通过调用交易所的 fetch_balance() 方法，可以获取账户的余额信息。为了处理可能出现的异常情况，建议将代码块包裹在 try...except 结构中。

try: 块包含尝试执行的代码。如果交易所连接正常且API密钥有效， exchange.fetch_balance() 将返回一个包含账户余额信息的字典。

获取的余额信息通常包括可用余额、已用余额以及总余额。还可能包含各种加密货币的余额明细。例如：

{
    'info': ..., # 交易所返回的原始信息
    'free': {    # 可用余额
        'BTC': 1.234,
        'ETH': 5.678,
        'USD': 1000,
        ...
    },
    'used': {    # 已用余额
        'BTC': 0.1,
        'ETH': 0.2,
        ...
    },
    'total': {   # 总余额
        'BTC': 1.334,
        'ETH': 5.878,
        'USD': 1000,
        ...
    }
}

except ccxt.AuthenticationError as e: 块用于捕获认证失败的异常。如果API密钥不正确或已过期，将会抛出此异常。程序将打印出错误信息，帮助用户诊断问题。

except Exception as e: 块用于捕获其他类型的异常，例如网络连接问题或交易所API错误。程序同样会打印出错误信息，方便问题排查。

示例代码：

try:
    balance = exchange.fetch_balance()
    print(balance)
except ccxt.AuthenticationError as e:
    print(f"Authentication failed: {e}")
except Exception as e:
    print(f"An error occurred: {e}")

下单示例 (市价买入 BTC/USDT 1 个 BTC)

以下代码示例展示了如何使用CCXT库在交易所上进行市价买入操作，以BTC/USDT交易对为例，尝试买入0.001个BTC。请注意，实际交易数量可能需要根据交易所的最小交易单位进行调整。

try:
order = exchange.create_market_buy_order('BTC/USDT', 0.001)
print(order)
except ccxt.InsufficientFunds as e:
print(f"Insufficient funds: {e}")
except ccxt.ExchangeError as e:
print(f"Exchange error: {e}")
except Exception as e:
print(f"An error occurred: {e}")

此代码段利用Python的 try...except 结构来捕获潜在的异常情况，包括：

• ccxt.InsufficientFunds : 账户余额不足以完成订单。
• ccxt.ExchangeError : 交易所返回的错误信息，可能是由于网络问题、API限制或其他交易所特定的错误。
• Exception : 用于捕获其他未预见的错误。

在实际使用中，你需要确保你的账户中有足够的USDT来购买0.001个BTC。 同时，需要仔细检查交易所返回的错误信息，以便更好地诊断问题。

请务必将 'YOUR_API_KEY' 和 'YOUR_SECRET_KEY' 替换成你实际的 API 密钥和 Secret Key。 如果你设置了API passphrase，则需要将 'YOUR_PASSWORD' 替换成你的 passphrase。 API密钥、Secret Key 和 Passphrase 用于身份验证，允许你的程序代表你进行交易。 请妥善保管这些凭据，切勿泄露给他人。