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

admin ok快讯 2026-06-02 27

目录导读

欧易API接口基础认知
API申请与权限配置完整流程
Python环境搭建与依赖库安装
编写第一个交易脚本（含实战代码）
常见问题与问答解析
安全注意事项与合规建议

欧易API接口基础认知

欧易（OKX）作为全球领先的数字资产交易平台，其提供的API接口允许开发者通过程序化方式实现行情获取、下单交易、账户管理等操作，对于使用Python编写交易脚本的用户而言,掌握API申请与调用是自动化交易的第一步。

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

核心概念：

REST API：通过HTTP请求与服务器交互，适合非实时操作
WebSocket API：保持长连接，用于实时行情与订单更新
签名机制：通过API Key、Secret Key和Passphrase进行身份验证

提示：若需下载欧易交易客户端，可访问欧易交易所下载获取官方版本,确保交易环境安全。

API申请与权限配置完整流程

1 登录官网并进入API管理

访问欧易官网并登录账号
导航至“账户” -> “API管理”
点击“创建新的API Key”

2 设置权限与IP白名单

权限选择：
- 只读权限：仅查看账户信息与行情
- 交易权限：允许下单、撤单等操作
- 提币权限：安全性要求极高，建议不开启
IP绑定：填入服务器公网IP，防止密钥泄露后被盗用

3 保存密钥信息

创建成功后，系统会显示：

API Key：公开密钥标识
Secret Key：用于签名的私密密钥（仅显示一次）
Passphrase：自定义密码短语（签名时需要）

⚠️ 请将密钥存储在安全环境,切勿上传至公开代码仓库。

Python环境搭建与依赖库安装

1 安装Python与虚拟环境

建议使用Python 3.8以上版本,通过venv或conda创建独立环境：

python -m venv okx_env
source okx_env/bin/activate  # Linux/Mac
okx_env\Scripts\activate     # Windows

2 安装必要库

使用pip安装核心依赖：

pip install requests pandas python-dotenv

requests：发送HTTP请求
pandas：数据处理
python-dotenv：读取环境变量（安全存储密钥）

编写第一个交易脚本（实战代码）

1 脚本功能设计

本示例脚本实现：

获取BTC/USDT当前行情
查询账户余额
执行市价买入0.001 BTC

2 完整代码实现

import requests
import json
import time
import hmac
import base64
from hashlib import sha256
# 请从环境变量或安全的配置文件中读取
API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"
PASSPHRASE = "your_passphrase"
BASE_URL = "https://www.okx.com"
def generate_signature(timestamp, method, request_path, body):
    message = timestamp + method + request_path + (body or "")
    mac = hmac.new(SECRET_KEY.encode('utf-8'), message.encode('utf-8'), sha256)
    return base64.b64encode(mac.digest()).decode('utf-8')
def get_headers(method, request_path, body=""):
    timestamp = str(time.time())
    signature = generate_signature(timestamp, method, request_path, body)
    return {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": PASSPHRASE,
        "Content-Type": "application/json"
    }
# 获取当前行情
def get_ticker(symbol="BTC-USDT"):
    path = f"/api/v5/market/ticker?instId={symbol}"
    headers = get_headers("GET", path)
    response = requests.get(BASE_URL + path, headers=headers)
    return response.json()
# 获取账户余额
def get_account_balance():
    path = "/api/v5/account/balance"
    headers = get_headers("GET", path)
    response = requests.get(BASE_URL + path, headers=headers)
    return response.json()
# 市价买入
def market_buy(symbol, size):
    path = "/api/v5/trade/order"
    body = json.dumps({
        "instId": symbol,
        "tdMode": "cash",
        "side": "buy",
        "ordType": "market",
        "sz": str(size)
    })
    headers = get_headers("POST", path, body)
    response = requests.post(BASE_URL + path, headers=headers, data=body)
    return response.json()
if __name__ == "__main__":
    print("=== 当前行情 ===")
    ticker = get_ticker()
    print(json.dumps(ticker, indent=2))
    print("=== 账户余额 ===")
    balance = get_account_balance()
    print(json.dumps(balance, indent=2))
    print("=== 执行交易 ===")
    order = market_buy("BTC-USDT", 0.001)
    print(json.dumps(order, indent=2))