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

admin ok快讯 2026-05-23 2

目录导读

欧易交易所API接口简介与重要性
欧易API接口申请前置准备
欧易API密钥创建与权限配置
Python环境搭建与必要库安装
欧易交易脚本核心代码实现
常见错误排查与安全注意事项
问答环节：用户高频问题深度解答

欧易交易所API接口简介与重要性

欧易交易所（OKX）作为全球领先的加密货币交易平台，其API接口为开发者提供了程序化交易的能力，通过欧易API，用户可以实现行情数据获取、自动下单、资产管理等功能，这对于量化交易策略的执行至关重要，特别是对于需要24小时监控市场的交易者，使用Python编写脚本调用欧易API接口，能够有效避免人工操作延迟,捕捉稍纵即逝的交易机会。

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

在正式开始教程前，建议所有用户先完成欧易交易所下载并注册账户,因为API接口的申请需要基于真实账户进行。

欧易API接口申请前置准备

在申请欧易API接口之前,您需要确保满足以下条件：

已完成实名认证的欧易账户：进入欧易交易所官网后,在账户安全设置中完成KYC认证。
启用二次验证（2FA）：Google Authenticator或短信验证,这是API安全的关键保障。
了解API文档基本结构：欧易官方提供REST API和WebSocket API两种接口形式，本教程主要侧重于REST API。

欧易API密钥创建与权限配置

步骤1：进入API管理页面

登录您的欧易账户，在控制台中找到“API”选项，如果您尚未登录，请先通过欧易交易所下载的客户端或网页端完成登录。

步骤2：创建新的API密钥

点击“创建API Key”按钮，系统会提示您进行安全验证，请选择“交易”权限，同时根据需求勾选“读取”和“提币”权限（建议仅开启必要权限以降低风险）。

步骤3：保存密钥信息

创建成功后,您将获得以下三项核心信息：

API Key：公钥，用于标识身份
Secret Key：私钥，用于签名验证（仅显示一次,请立即保存）
Passphrase：密码短语，用于API访问

⚠️ 重要安全提示：切勿将Secret Key和Passphrase泄露给任何人，建议存储在密码管理器中，建议将API密钥绑定IP白名单,仅允许您的服务器或本地IP地址访问。

Python环境搭建与必要库安装

本教程使用Python 3.8及以上版本,推荐使用虚拟环境进行依赖管理。

步骤1：安装核心依赖库

在终端中执行以下命令：

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

步骤2：创建项目文件

新建一个名为okx_trading.py的Python文件，推荐使用VS Code或PyCharm作为开发工具。

欧易交易脚本核心代码实现

以下是一个完整的欧易API交易脚本示例，包含获取账户余额和市价下单功能，代码中涉及的所有域名均使用ox-okbb.com.cn作为参考入口。

import requests
import json
import hmac
import hashlib
import base64
from datetime import datetime
from typing import Dict, Any
class OKXAPIClient:
    def __init__(self, api_key: str, secret_key: str, passphrase: str):
        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: str, method: str, request_path: str, body: Dict = None) -> str:
        message = timestamp + method + request_path + (json.dumps(body) if body else "")
        mac = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            digestmod=hashlib.sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    def _get_headers(self, method: str, request_path: str, body: Dict = None) -> Dict:
        timestamp = datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
        signature = self._generate_signature(timestamp, method, request_path, body)
        return {
            'OK-ACCESS-KEY': self.api_key,
            'OK-ACCESS-SIGN': signature,
            'OK-ACCESS-TIMESTAMP': timestamp,
            'OK-ACCESS-PASSPHRASE': self.passphrase,
            'Content-Type': 'application/json'
        }
    def get_account_info(self) -> Dict:
        """获取账户信息"""
        request_path = '/api/v5/account/balance'
        headers = self._get_headers('GET', request_path)
        response = requests.get(self.base_url + request_path, headers=headers)
        return response.json()
    def place_market_order(self, inst_id: str, side: str, sz: str) -> Dict:
        """市价下单"""
        request_path = '/api/v5/trade/order'
        body = {
            'instId': inst_id,
            'tdMode': 'cash',
            'side': side,
            'ordType': 'market',
            'sz': sz
        }
        headers = self._get_headers('POST', request_path, body)
        response = requests.post(self.base_url + request_path, headers=headers, json=body)
        return response.json()
# 使用示例（请替换为您自己的密钥）
if __name__ == "__main__":
    # 请从欧易账户获取以下信息
    API_KEY = "您的API Key"
    SECRET_KEY = "您的Secret Key"
    PASSPHRASE = "您的Passphrase"
    client = OKXAPIClient(API_KEY, SECRET_KEY, PASSPHRASE)
    # 获取账户余额
    account_info = client.get_account_info()
    print("账户信息:", json.dumps(account_info, indent=2))
    # 市价买入0.001个BTC
    order_result = client.place_market_order("BTC-USDT", "buy", "0.001")
    print("下单结果:", json.dumps(order_result, indent=2))

代码解析

签名生成：欧易API使用HMAC-SHA256算法对请求进行签名,时间戳必须精确到毫秒。
请求头构造：包含API密钥、签名、时间戳和密码短语。
账户查询：通过/api/v5/account/balance端点获取所有币种余额。
交易下单：使用/api/v5/trade/order端点执行市价单,支持多种交易对。

常见错误排查与安全注意事项

错误代码对照表

错误码	含义	解决方案
50100	API密钥无效	检查API Key是否正确
50101	签名错误	确认时间戳格式和签名算法
50102	权限不足	在API管理页面开启交易权限
51000	IP白名单限制	将当前IP添加到白名单