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

admin ok快讯 2026-05-18 6

目录导读

为什么需要欧易API接口？
欧易API接口申请完整流程
Python环境搭建与依赖安装
编写第一个交易脚本：获取账户余额
进阶脚本：实现限价单交易
常见问题与问答
安全注意事项与合规建议

为什么需要欧易API接口？

在数字资产交易领域,手动操作往往效率低下且容易错失良机，通过欧易API接口，交易者可以实现自动化交易策略，包括网格交易、套利策略以及止损止盈设置，Python因其丰富的库支持和简洁的语法，成为编写交易脚本的首选语言，对于想要在欧易交易所下载后进行程序化交易的用户，掌握API调用是迈向自动化交易的关键一步。

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

欧易API接口申请完整流程

步骤1：注册并登录账号

访问欧易官网完成注册，若尚未拥有账号，可点击右上角“注册”，使用邮箱或手机号完成验证。

步骤2：进入API管理页面

登录后,将鼠标悬停在右上角头像，选择“API”选项，或直接访问控制台的API管理界面。

步骤3：创建API密钥

点击“创建API”按钮
选择权限：至少勾选“读取”和“交易”权限（如需提币则额外勾选“提币”）。
安全保障：创建后务必保存API Key和Secret Key，且Secret Key仅显示一次。
设置IP白名单（强烈建议）：仅允许特定IP地址调用接口。

步骤4：完成安全验证

根据提示输入资金密码或进行二次验证（如谷歌验证器），成功创建后，你会获得：

API Key：abc123-def456-ghi789
Secret Key：jkl012-mno345-pqr678
Passphrase：创建时设置的交易密码

提醒：切勿将密钥明文存储或上传至公共仓库。

Python环境搭建与依赖安装

环境要求

Python 3.8及以上版本
安装pip包管理器

安装必要库

在终端执行以下命令：

pip install requests hashlib hmac base64 json time

主要依赖说明：

requests：发起HTTP请求
hashlib与hmac：生成签名
base64：编码参数
json：解析响应数据

测试连接

通过简单的GET请求验证网络连通性：

import requests
url = "https://www.okx.com/api/v5/public/time"
response = requests.get(url)
print(response.json())

若成功返回服务器时间,则环境配置完毕。

编写第一个交易脚本：获取账户余额

以下脚本演示如何调用欧易API获取账户总权益（适合已完成欧易交易所下载的用户）。

import requests
import json
import hmac
import hashlib
import base64
import time
# 配置你的API密钥
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
passphrase = "YOUR_PASSPHRASE"
# 基础URL（请替换为当前有效的API域名）
base_url = "https://www.okx.com"
def get_signature(timestamp, method, request_path, body):
    message = timestamp + method + request_path + (body if body else '')
    mac = hmac.new(bytes(secret_key, encoding='utf8'), 
                   bytes(message, encoding='utf-8'), 
                   digestmod=hashlib.sha256)
    return base64.b64encode(mac.digest()).decode()
def get_account_balance():
    timestamp = str(round(time.time(), 3))
    method = "GET"
    request_path = "/api/v5/account/balance"
    body = ""
    signature = get_signature(timestamp, method, request_path, body)
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": signature,
        "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()
# 执行查询
balance_data = get_account_balance()
print(json.dumps(balance_data, indent=4))

运行结果示例：
返回数据中data[0]['totalEq']即为总权益（折合USDT）。

进阶脚本：实现限价单交易

若想通过脚本下单,需添加交易权限，以下示例为挂一个BTC/USDT的限价买单：

def place_limit_order(side, inst_id, px, sz):
    timestamp = str(round(time.time(), 3))
    method = "POST"
    request_path = "/api/v5/trade/order"
    body = {
        "instId": inst_id,       # 交易对，如 BTC-USDT
        "tdMode": "cash",        # 保证金模式：现金
        "side": side,            # buy 或 sell
        "ordType": "limit",      # 限价单
        "px": str(px),           # 价格
        "sz": str(sz)            # 数量
    }
    body_json = json.dumps(body)
    signature = get_signature(timestamp, method, request_path, body_json)
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": signature,
        "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_json)
    return response.json()
# 示例：以30000 USDT买入0.01个BTC
order_result = place_limit_order("buy", "BTC-USDT", 30000, 0.01)
print(order_result)

注意事项：