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

admin ok快讯 2026-06-01 3

目录导读

欧易交易所API接口概述
API接口申请与配置步骤
Python环境搭建与依赖库安装
编写第一个交易脚本：获取账户信息
进阶脚本：实现市价买入与卖出
常见问题与问答（FAQ）
安全与合规性建议

欧易交易所API接口概述

欧易交易所官网（OKX）作为全球领先的加密货币交易平台，提供了强大且开放的API接口，支持用户通过编程方式自动化执行交易策略，无论是量化交易、定投策略，还是简单的行情监控，API都能帮你高效实现，对于初学者，Python因其简洁性和丰富的金融库,成为编写交易脚本的首选语言。

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

在开始之前，你需要访问欧易交易所下载完成注册并创建API密钥，请确保你的账户已完成基础认证,否则API权限可能受限。

API接口申请与配置步骤

1 登录欧易交易所官网

访问 https://ox-okbb.com.cn/，登录你的账户，进入“账户设置” -> “API管理”页面。

2 创建API密钥

点击“创建API”,根据需求选择权限：

读取权限：用于查询账户余额、订单状态等。
交易权限：允许脚本下单、撤单等操作。
提币权限：建议仅在你完全信任的环境下启用,避免安全风险。

3 保存密钥

系统会生成api_key和secret_key（以及可选的passphrase），请立即复制并安全保存，因为密钥不会再次完整显示，建议将密钥存储在环境变量或加密配置文件中,切勿硬编码在代码中。

注意：当你需要测试脚本时，可先使用“模拟盘”（Demo）环境，欧易官网提供沙箱模式,避免真实资金风险。

Python环境搭建与依赖库安装

1 安装Python

建议使用Python 3.8及以上版本，可通过python.org下载。

2 安装必要库

在终端中运行以下命令：

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

你也可以安装python-okx等第三方封装库，但本文以原生requests为例,便于理解底层逻辑。

编写第一个交易脚本：获取账户信息

以下是一个简单示例，用于获取你欧易交易所账户的资产余额，请将API_KEY、SECRET_KEY和PASSPHRASE替换为你自己的值。

import requests
import base64
import hmac
import hashlib
import json
import datetime
import time
# 配置信息
API_KEY = '你的api_key'
SECRET_KEY = '你的secret_key'
PASSPHRASE = '你的passphrase'
BASE_URL = 'https://www.okx.com'
# 生成签名
def get_sign(timestamp, method, request_path, body=''):
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
    d = mac.digest()
    return base64.b64encode(d).decode('utf-8')
# 获取账户信息
def get_account():
    timestamp = datetime.datetime.utcnow().isoformat("T", "milliseconds") + "Z"
    method = 'GET'
    request_path = '/api/v5/account/balance'
    body = ''
    sign = get_sign(timestamp, method, request_path, body)
    headers = {
        'OK-ACCESS-KEY': API_KEY,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': PASSPHRASE,
        'Content-Type': 'application/json'
    }
    url = BASE_URL + request_path
    response = requests.get(url, headers=headers)
    return response.json()
# 执行
if __name__ == '__main__':
    account_info = get_account()
    print(json.dumps(account_info, indent=2))

运行后，你会看到类似以下输出,包含你各币种的余额和估值：

{
  "code": "0",
  "data": [
    {
      "totalEq": "1000.123456",
      "details": [
        {"ccy": "BTC", "eq": "0.5", "availBal": "0.5"},
        {"ccy": "USDT", "eq": "500.00", "availBal": "500.00"}
      ]
    }
  ]
}

进阶脚本：实现市价买入与卖出

假设你想用USDT市价买入0.01 BTC,可参考以下代码：

def place_order(side, sz, tdMode='cash', instId='BTC-USDT'):
    """
    side: 'buy' 或 'sell'
    sz: 数量（对于市价单，买入时输入USDT金额，卖出时输入币数量）
    """
    timestamp = datetime.datetime.utcnow().isoformat("T", "milliseconds") + "Z"
    method = 'POST'
    request_path = '/api/v5/trade/order'
    order_data = {
        "instId": instId,
        "tdMode": tdMode,
        "side": side,
        "ordType": "market",
        "sz": str(sz)
    }
    body = json.dumps(order_data)
    sign = get_sign(timestamp, method, request_path, body)
    headers = {
        'OK-ACCESS-KEY': API_KEY,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': PASSPHRASE,
        'Content-Type': 'application/json'
    }
    url = BASE_URL + request_path
    response = requests.post(url, headers=headers, data=body)
    return response.json()
# 买入0.01 BTC，使用市价单，消耗USDT
print(place_order('buy', 500, 'cash', 'BTC-USDT'))  # 花费500 USDT市价买入

注意：市价单不保证成交价格，建议在流动性充足时使用，如果你需要更高阶的策略（如限价单、止损单），可修改ordType参数。