欧易API接口申请教程，如何使用Python编写简单的交易脚本？

admin ok快讯 2026-07-10 2

目录导读

欧易API接口简介与申请流程
Python环境配置与依赖安装
API密钥管理与安全规范
编写简单的交易脚本：从获取行情到下单
常见问题与错误处理
问答环节

欧易API接口简介与申请流程

欧易（OKX）作为全球领先的数字资产交易平台，为开发者提供了完善的REST API和WebSocket接口，支持行情查询、交易执行、账户管理等核心功能，通过API，交易者可以实现程序化交易、量化策略和自动化套利等高级操作。

欧易API接口申请教程，如何使用Python编写简单的交易脚本？-第1张图片-欧易交易所

申请步骤：

访问欧易交易所官网（本文演示使用镜像站 ox-okbb.com.cn ）,注册并完成KYC认证。
登录后进入“API管理”页面，点击“创建API密钥”。
选择权限类型：建议勾选“交易”和“读取”权限，避免启用“提现”权限以保障资金安全。
设置IP白名单（可选但推荐）,仅允许特定IP访问API。
完成安全验证后，系统生成 api_key、secret_key 和 passphrase,请妥善保存。

注意：创建后务必立即保存密钥，关闭页面后将无法再次查看 secret_key。

Python环境配置与依赖安装

编写交易脚本前，请确保已安装Python 3.7及以上版本,推荐使用虚拟环境隔离依赖。

安装核心库：

pip install requests
pip install hashlib
pip install hmac
pip install base64

如果你需要更便捷的封装,也可以安装第三方库：

pip install okx-py   # 非官方，但社区使用广泛

验证环境：

import requests
print("环境配置成功！")

API密钥管理与安全规范

在正式编写脚本前,务必遵守以下安全准则：

绝不硬编码密钥：将密钥存储在环境变量或配置文件中，并通过 .gitignore 排除提交。
限制API权限：仅开启所需的最小权限，例如只读策略只需“查看”权限。
IP白名单：若服务器IP固定,务必启用白名单功能。
定期轮换密钥：建议每3个月更换一次API密钥。

安全示例（加载环境变量）：

import os
from dotenv import load_dotenv
load_dotenv()
API_KEY = os.getenv("OKX_API_KEY")
SECRET_KEY = os.getenv("OKX_SECRET_KEY")
PASSPHRASE = os.getenv("OKX_PASSPHRASE")

编写简单的交易脚本：从获取行情到下单

以下是一个完整的Python脚本示例，功能包括：获取BTC/USDT实时行情、查询账户余额、执行市价买入100 USDT的BTC。

import requests
import hmac
import base64
import hashlib
import json
import time
class OKXClient:
    def __init__(self, api_key, secret_key, passphrase):
        self.base_url = "https://www.okx.com"
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
    def _generate_signature(self, timestamp, method, request_path, body=''):
        message = timestamp + method + request_path + body
        mac = hmac.new(bytes(self.secret_key, 'utf-8'), 
                      bytes(message, 'utf-8'), 
                      digestmod=hashlib.sha256)
        return base64.b64encode(mac.digest()).decode('utf-8')
    def _request(self, method, path, body=None):
        timestamp = str(int(time.time()))
        signature = self._generate_signature(timestamp, method, path, body or '')
        headers = {
            'OK-ACCESS-KEY': self.api_key,
            'OK-ACCESS-SIGN': signature,
            'OK-ACCESS-TIMESTAMP': timestamp,
            'OK-ACCESS-PASSPHRASE': self.passphrase,
            'Content-Type': 'application/json'
        }
        url = self.base_url + path
        if method == 'GET':
            response = requests.get(url, headers=headers)
        else:
            response = requests.post(url, headers=headers, data=body)
        return response.json()
    def get_ticker(self, inst_id):
        """获取行情"""
        path = f"/api/v5/market/ticker?instId={inst_id}"
        return self._request('GET', path)
    def get_account_balance(self):
        """查询账户余额"""
        path = "/api/v5/account/balance"
        return self._request('GET', path)
    def place_order(self, inst_id, td_mode, side, ord_type, sz, px=''):
        """下单交易"""
        path = "/api/v5/trade/order"
        body = {
            "instId": inst_id,
            "tdMode": td_mode,
            "side": side,
            "ordType": ord_type,
            "sz": sz,
            "px": px
        }
        # 市价单无需价格
        if ord_type == 'market':
            body.pop('px', None)
        return self._request('POST', path, json.dumps(body))
# 使用示例（请替换为真实密钥）
client = OKXClient(API_KEY, SECRET_KEY, PASSPHRASE)
# 获取BTC/USDT最新价格
ticker = client.get_ticker("BTC-USDT")
print("BTC当前价格：", ticker['data'][0]['last'])
# 查询账户USDT余额
balance = client.get_account_balance()
print("账户余额：", balance)
# 市价买入100 USDT的BTC
order = client.place_order("BTC-USDT", "cash", "buy", "market", "100")
print("订单结果：", order)

代码说明：