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

admin okx快讯 2026-06-08 29

目录导读

前言：为什么选择欧易API？
第一步：欧易API接口申请全流程
第二步：Python环境配置与依赖安装
第三步：编写你的第一个交易脚本
第四步：常见问题与踩坑指南
问答环节：你关心的问题都在这里
从脚本到策略的进阶之路

前言：为什么选择欧易API？

说实话,刚接触加密货币交易的时候，我跟你一样——每天手动盯盘、挂单、撤单，累得跟狗一样，直到我开始研究欧易交易所官网的API接口，才发现原来交易可以这么省心。

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

通过API接口,你可以用Python编写脚本实现自动交易、实时数据抓取、策略回测，欧易API的文档结构清晰，支持的交易对覆盖主流币种，尤其是对于想入门量化交易的朋友来说，这是个非常友好的起点。

不过有个小提醒：在开始之前，确保你已经完成欧易交易所下载并注册账户，这个步骤很多人容易忽略，但却是后续一切操作的前提。

第一步：欧易API接口申请全流程

登录后台创建API密钥

登录你的欧易账户,在个人中心找到“API管理”选项（通常在安全设置里面），点击“创建API”，你会看到几个关键参数：

API Key：相当于你的身份ID
Secret Key：相当于你的交易密码，务必妥善保管
Passphrase：自定义的API连接密码

注意：创建时建议勾选“交易”和“读取”权限，但如果你只是测试，可以先只开“读取”权限，比较安全。

配置IP白名单

欧易API允许设置IP白名单,如果你用的是家里的动态IP，建议先不绑定IP，或者用“0.0.0.0/0”表示允许所有IP访问（仅限测试），生产环境建议绑定固定IP。

保存密钥文件

创建成功后,系统只会显示一次Secret Key，请立即复制并保存到本地加密文件中，丢失了就只能重新生成，比较麻烦。

第二步：Python环境配置与依赖安装

环境要求

Python 3.7及以上版本
推荐用虚拟环境管理依赖

安装必要库

打开命令行,执行以下命令：

pip install requests pandas python-dotenv

requests：HTTP请求库，用于调用欧易API
pandas：数据处理利器，后面写策略会用到
python-dotenv：管理敏感信息，避免密钥泄露

创建项目结构

建议按下面的方式组织文件：

okx_trading/
├── .env          # 存放API密钥（绝对不要上传到Git）
├── main.py       # 主脚本文件
├── config.py     # 配置加载脚本
└── utils.py      # 工具函数

第三步：编写你的第一个交易脚本

1 加载配置文件

在.env文件中写入你的密钥信息：

API_KEY=你的APIKey
SECRET_KEY=你的SecretKey
PASSPHRASE=你的Passphrase

然后在config.py中加载：

import os
from dotenv import load_dotenv
load_dotenv()
API_KEY = os.getenv('API_KEY')
SECRET_KEY = os.getenv('SECRET_KEY')
PASSPHRASE = os.getenv('PASSPHRASE')

2 实现API签名工具

欧易API使用HMAC-SHA256签名，这是安全性的核心，以下是一个通用的签名函数：

import hmac
import base64
import datetime
import requests
from config import API_KEY, SECRET_KEY, PASSPHRASE
def generate_sign(timestamp, method, request_path, body=''):
    message = timestamp + method.upper() + request_path + body
    mac = hmac.new(SECRET_KEY.encode('utf-8'), 
                   message.encode('utf-8'), 
                   digestmod='sha256')
    return base64.b64encode(mac.digest()).decode('utf-8')
def get_header(method, request_path, body=''):
    timestamp = datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
    sign = generate_sign(timestamp, method, request_path, body)
    return {
        'OK-ACCESS-KEY': API_KEY,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': PASSPHRASE,
        'Content-Type': 'application/json'
    }

3 获取账户余额

def get_account_balance():
    base_url = 'https://www.okx.com'
    request_path = '/api/v5/account/balance'
    headers = get_header('GET', request_path)
    response = requests.get(base_url + request_path, headers=headers)
    if response.status_code == 200:
        data = response.json()
        if data.get('code') == '0':
            return data['data'][0]['details']
    return None

运行完这段代码,如果能正确返回你账户里的币种余额，恭喜你——API连接已成功！

4 获取实时行情并下单

下面是一个简单的市价买入脚本示例：

def place_market_order(symbol, side, size):
    base_url = 'https://www.okx.com'
    request_path = '/api/v5/trade/order'
    order_data = {
        'instId': symbol,      # 交易对，如 'BTC-USDT'
        'tdMode': 'cash',      # 现货交易
        'side': side,           # 'buy' 或 'sell'
        'ordType': 'market',   # 市价单
        'sz': str(size)        # 数量
    }
    body = json.dumps(order_data)
    headers = get_header('POST', request_path, body)
    response = requests.post(base_url + request_path, headers=headers, data=body)
    return response.json()
# 使用示例：
# result = place_market_order('BTC-USDT', 'buy', 0.001)