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

admin ok快讯 2026-06-25 2

目录导读

欧易API接口概述与申请流程
Python交易脚本开发环境搭建
核心代码实现：从认证到下单
常见问题与问答（FAQ）
安全建议与风险提示

欧易API接口概述与申请流程

在数字货币量化交易领域,欧易交易所（OKX）是全球领先的交易平台之一，其提供的API接口允许开发者通过程序自动化执行交易策略，无论是进行网格交易、套利策略还是简单定投，掌握API调用都是入门必备技能。

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

1 什么是欧易API？

欧易API是一组RESTful接口,支持现货、合约、期权等产品的交易数据查询与订单管理，通过API，你可以实现：

获取实时行情（K线、深度、Ticker）
管理账户资产与订单
执行买入/卖出操作
设置止盈止损

2 如何申请API密钥？

第一步：登录欧易官网 访问欧易交易所官网（建议直接访问欧易交易所下载获取最新地址），登录你的账户。

第二步：进入API管理页面 点击右上角头像 → “API” → “创建新的API密钥”。

第三步：设置权限

交易权限：开启后可进行下单操作
读取权限：查询行情和账户信息
提币权限：强烈建议关闭，防止资金被盗

第四步：完成安全验证 输入手机/邮箱验证码，部分账户还需谷歌身份验证器。

第五步：保存密钥 创建成功后，会生成 API Key 和 Secret Key，请务必：

立即复制并保存到安全位置（如密码管理器）
不要将密钥明文存储在代码或公开仓库中
建议设置IP白名单限制访问来源

💡 小贴士：建议定期轮换密钥，每次更换后需重新配置脚本。

Python交易脚本开发环境搭建

1 环境要求

Python 3.7+
推荐使用虚拟环境（venv或conda）

2 安装依赖库

pip install requests hashlib hmac base64 json time

注意：requests 用于发送HTTP请求，hashlib 和 hmac 用于生成签名。

3 获取基础参数

你需要准备以下变量：

api_key：你的API Key
secret_key：你的Secret Key
passphrase：创建API时设置的密码短语
base_url：欧易API端点（默认 https://www.okx.com）

核心代码实现：从认证到下单

下面是一个完整的Python脚本示例,包含签名生成、行情获取和市价下单功能。

1 签名生成函数

import hmac
import base64
import hashlib
import json
import time
import requests
def generate_sign(timestamp, method, request_path, body=''):
    """生成OKX API签名"""
    message = timestamp + method.upper() + request_path + body
    mac = hmac.new(
        bytes(secret_key, encoding='utf8'),
        bytes(message, encoding='utf-8'),
        digestmod='sha256'
    )
    return base64.b64encode(mac.digest()).decode('utf-8')
def get_headers(api_key, sign, timestamp, passphrase):
    """构造请求头"""
    return {
        'OK-ACCESS-KEY': api_key,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': passphrase,
        'Content-Type': 'application/json'
    }

2 获取账户余额

def get_account_balance():
    path = '/api/v5/account/balance'
    timestamp = str(time.time())
    sign = generate_sign(timestamp, 'GET', path)
    headers = get_headers(api_key, sign, timestamp, passphrase)
    url = base_url + path
    response = requests.get(url, headers=headers)
    return response.json()

3 查看实时行情

def get_ticker(symbol='BTC-USDT'):
    """获取指定交易对的最新行情"""
    path = f'/api/v5/market/ticker?instId={symbol}'
    timestamp = str(time.time())
    sign = generate_sign(timestamp, 'GET', path)
    headers = get_headers(api_key, sign, timestamp, passphrase)
    url = base_url + path
    response = requests.get(url, headers=headers)
    data = response.json()
    return data['data'][0] if 'data' in data else None

4 执行市价买入

def place_market_order(symbol, side, size):
    """市价单：side='buy'或'sell', size为买入数量"""
    path = '/api/v5/trade/order'
    body = {
        'instId': symbol,
        'tdMode': 'cash',
        'side': side,
        'ordType': 'market',
        'sz': str(size)
    }
    timestamp = str(time.time())
    json_body = json.dumps(body)
    sign = generate_sign(timestamp, 'POST', path, json_body)
    headers = get_headers(api_key, sign, timestamp, passphrase)
    url = base_url + path
    response = requests.post(url, headers=headers, data=json_body)
    return response.json()

5 完整脚本示例

# 配置参数（请替换为实际值）
api_key = 'YOUR_API_KEY'
secret_key = 'YOUR_SECRET_KEY'
passphrase = 'YOUR_PASSPHRASE'
base_url = 'https://www.okx.com'
# 查询BTC当前价格
print('获取BTC行情...')
ticker = get_ticker('BTC-USDT')
if ticker:
    print(f"最新价格: {ticker['last']} USDT")
# 检查账户余额
balance = get_account_balance()
print(f"账户数据: {balance}")
# 执行小额测试交易（强烈建议先用模拟盘）
# result = place_market_order('BTC-USDT', 'buy', 0.001)
# print(f"订单结果: {result}")