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

admin ok快讯 2026-07-04 1

📚 目录导读

欧易API申请前的准备工作
详细申请步骤与常见问题解答
Python交易脚本开发环境搭建
核心代码实现：自动交易脚本实战
风险控制与脚本优化建议

欧易API申请前的准备工作

1 什么是欧易API？

欧易API（应用程序编程接口）允许开发者通过编程方式与欧易交易平台交互，实现自动化交易、数据获取、账户管理等功能，通过欧易API，你可以编写Python脚本来自动执行买卖指令,无需手动操作。

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

2 申请API需要哪些条件？

拥有一个欧易平台的注册账户
完成实名认证（KYC级别不低于Lv2）
账户无异常冻结记录

3 安全须知

在申请前，请务必理解API密钥的安全性：API密钥相当于你的账户操作权限令牌，泄露后可能导致资产损失,建议为API设置严格的IP白名单和操作权限。

详细申请步骤与常见问题解答

1 申请步骤详解

登录欧易官网（推荐通过欧易交易所下载获取最新官方链接）
进入“个人中心”→“API管理”
点击“创建API密钥”
填写标签（如：Python交易脚本）
设置权限（建议勾选“交易”和“读取”权限）
设置IP白名单（强烈推荐）
完成安全验证（邮箱/手机/谷歌验证器）
保存API Key和Secret Key（注意：Secret Key只显示一次）

2 常见问题问答

Q1: API申请后为什么无法连接？
A: 常见原因包括：①未设置IP白名单 ②API密钥配错 ③账户未完成实名认证,请逐项检查。

Q2: API密钥丢失怎么办？
A: 立即在API管理页面删除该密钥并重新创建,已丢失的密钥不可找回。

Q3: 使用欧易交易所下载的官方客户端是否支持API？
A: 支持，但建议使用 ox-okbb.com.cn 上的API文档获取最新接口信息。

Q4: 一个账户可以创建多少个API密钥？
A: 通常限制为10个,如需更多请联系客服。

Python交易脚本开发环境搭建

1 环境要求

Python 3.7+
操作系统：Windows/Mac/Linux均可
建议使用虚拟环境隔离项目依赖

2 安装必要库

pip install requests hashlib hmac base64 json time

3 获取API文档

建议参考欧易API接口申请教程中的官方文档，文档包含所有接口的请求格式、参数说明和返回示例。

4 创建项目结构

okx_trading_bot/
├── config.py          # 存储API密钥配置
├── okx_api.py         # API调用封装
├── trading_bot.py     # 主交易逻辑
└── requirements.txt   # 依赖清单

核心代码实现：自动交易脚本实战

1 配置模块（config.py）

API_KEY = 'your_api_key_here'
SECRET_KEY = 'your_secret_key_here'
PASSPHRASE = 'your_passphrase_here'
# API基础URL
BASE_URL = 'https://ox-okbb.com.cn/api/v5'

2 API调用封装（okx_api.py）

import requests
import hmac
import hashlib
import base64
import json
import time
class OKXAPI:
    def __init__(self, api_key, secret_key, passphrase):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        self.base_url = 'https://ox-okbb.com.cn/api/v5'
    def _generate_signature(self, timestamp, method, request_path, body=''):
        message = timestamp + method + request_path + body
        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 _make_request(self, method, endpoint, body=None):
        url = self.base_url + endpoint
        timestamp = str(time.time())
        if body:
            body_str = json.dumps(body)
        else:
            body_str = ''
        signature = self._generate_signature(timestamp, method, endpoint, body_str)
        headers = {
            'OK-ACCESS-KEY': self.api_key,
            'OK-ACCESS-SIGN': signature,
            'OK-ACCESS-TIMESTAMP': timestamp,
            'OK-ACCESS-PASSPHRASE': self.passphrase,
            'Content-Type': 'application/json'
        }
        response = requests.request(method, url, headers=headers, data=body_str)
        return response.json()
    def get_account_info(self):
        """获取账户信息"""
        return self._make_request('GET', '/account/balance')
    def place_order(self, inst_id, side, size, ord_type='market'):
        """下单交易"""
        body = {
            'instId': inst_id,
            'tdMode': 'cash',
            'side': side,
            'ordType': ord_type,
            'sz': str(size)
        }
        return self._make_request('POST', '/trade/order', body)

3 交易脚本主程序（trading_bot.py）

from config import API_KEY, SECRET_KEY, PASSPHRASE
from okx_api import OKXAPI
import time
def main():
    # 初始化API客户端
    api = OKXAPI(API_KEY, SECRET_KEY, PASSPHRASE)
    # 获取账户余额
    balance = api.get_account_info()
    print(f"当前账户状态: {balance}")
    # 示例：买入0.001 BTC市价单
    trading_pair = 'BTC-USDT'
    buy_size = 0.001
    print(f"正在执行买入操作: {trading_pair} 数量 {buy_size}")
    result = api.place_order(trading_pair, 'buy', buy_size)
    if result.get('code') == '0':
        print(f"订单成功: {result['data'][0]['ordId']}")
    else:
        print(f"订单失败: {result.get('msg', '未知错误')}")
if __name__ == '__main__':
    main()