-请替换成你自己的信息_OK交易官网 -ok下载官方APP-欧yi交易所

欧易交易所API使用指南：从零开始构建你的交易自动化

在数字货币的浪潮中，手动交易往往效率低下且容易受情绪影响，为了实现更高效的策略执行、自动化交易以及获取更全面的市场数据，越来越多的交易者和开发者开始使用交易所提供的API（应用程序编程接口），欧易交易所（OKX，原OKEx）作为全球领先的加密货币交易平台，其功能强大且文档完善的API,为用户打开了通往程序化交易的大门。

本文将作为一份详尽的入门指南，带你一步步了解欧易交易所API是什么,以及如何开始使用它。

什么是欧易API？

欧易API就像是欧易交易所为你打开的一扇“后门”，通过这扇门，你编写的程序（脚本）可以与欧易的服务器进行安全通信,从而实现：

自动化交易：根据预设的算法（如网格交易、定投、套利等）自动执行买卖操作,无需人工盯盘。
获取市场数据：实时获取K线图、交易深度、市场行情等数据,用于策略分析和回测。
账户管理：查询账户资产、交易历史、订单状态等信息,实现精细化的资产管理。
构建工具：开发自己的交易面板、行情分析工具或与其他软件集成。

欧易API主要分为两类：REST API 和 WebSocket API，REST API适合请求-响应模式，如获取历史数据或下单；WebSocket API则适合需要实时推送数据的场景,如实时行情和订单状态更新。

准备工作：获取你的API Key

在开始之前,你必须在欧易交易所完成以下准备工作：

完成身份认证：确保你的欧易账户已经完成了相应的身份认证（KYC）,这是使用API的前提。
创建API Key：
- 登录你的欧易账户，进入【账户中心】 -> 【API管理】。
- 点击【创建API Key】，系统会要求你设置一个IP访问白名单，出于安全考虑，强烈建议你在此处填写你程序将要运行的服务器或电脑的公网IP地址，如果暂时不确定，可以填写 0.0.0/0，但这意味着任何IP都可以访问，风险极高,完成开发后务必修改为具体IP。
- 设置权限，根据你的需求勾选权限：
  - 只读：只能查询账户信息和市场数据，不能进行交易,适合做数据分析工具。
  - 交易：可以进行下单、撤单等交易操作，权限更高,风险也更大。
- 妥善保存你的API Key和Secret Key，它们是访问你账户的唯一凭证，切勿泄露给任何人，页面只会显示一次,请务必安全保存。

API的核心要素：签名机制

欧易API为了保证请求的安全性，要求所有涉及权限的操作（如下单、查询账户）都必须进行签名认证，签名过程就像是给你的请求信盖上一个独特的“印章”,服务器通过验证这个印章来确认请求的合法性和完整性。

签名的基本流程如下（以REST API为例）：

生成请求时间戳 (Timestamp)：使用UTC时间,精确到毫秒。
构建请求体 (Body)：将所有请求参数（如交易对、价格、数量等）按照字母顺序拼接成字符串。
拼接待签名字符串：将HTTP-Method + Request-Path + Query-String + Body + Timestamp这几个部分拼接成一个完整的字符串。
生成签名：使用你保存的Secret Key，通过HMAC-SHA256算法对上一步的待签名字符串进行加密,生成最终的签名值。
发送请求：在HTTP请求的OK-Access-Key和OK-Access-Sign请求头中，分别填入你的API Key和生成的签名值。

欧易官方提供了详细的API文档，其中包含了不同编程语言（如Python, JavaScript, Java）的签名示例代码，对于初学者，直接使用官方示例是最高效、最安全的方式。

实战演练：一个简单的Python下单示例

假设你已经完成了准备工作，并安装了Python的requests库，我们可以尝试编写一个简单的脚本，来查询账户余额（只读权限）。

步骤1：导入库并设置API信息

import requests
import time
import hmac
import hashlib
import base64
API_KEY = '你的API_Key'
SECRET_KEY = '你的Secret_Key'
PASSPHRASE = '你在创建API时设置的Passphrase' # 如果有的话
BASE_URL = 'https://www.okx.com' # 生产环境
# -----------------------------
# 获取当前UTC时间戳
def get_timestamp():
    return str(int(time.time() * 1000))
# 生成签名
def sign(method, request_path, body, secret_key, timestamp):
    if body is None:
        body = ''
    message = method + request_path + body + timestamp
    signature = base64.b64encode(
        hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).digest()
    )
    return signature.decode('utf-8')
# 查询账户资产
def get_account_balance():
    timestamp = get_timestamp()
    request_path = '/api/v5/account/balance'
    method = 'GET'
    body = '' # GET请求通常没有body
    # 生成签名
    signature = sign(method, request_path, body, SECRET_KEY, timestamp)
    # 设置请求头
    headers = {
        'OK-ACCESS-KEY': API_KEY,
        'OK-ACCESS-SIGN': signature,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': PASSPHRASE,
        'Content-Type': 'application/json'
    }
    # 发送请求
    response = requests.get(BASE_URL + request_path, headers=headers)
    # 解析响应
    result = response.json()
    if result['code'] == '0':
        print("账户资产查询成功:")
        for currency in result['data'][0]['details']:
            if float(currency['availBal']) > 0:
                print(f"币种: {currency['ccy']}, 可用余额: {currency['availBal']}")
    else:
        print(f"查询失败: {result['msg']}")
# 执行函数
if __name__ == '__main__':
    get_account_balance()

代码解读：

我们首先定义了API密钥、基础URL等变量。
get_timestamp()函数用于生成符合API要求的时间戳。
sign()函数是核心，它按照欧易的规范，使用HMAC-SHA256算法生成签名。
get_account_balance()函数构建了请求头，包含了API-Key、Timestamp和Sign等关键信息，然后通过requests库向欧易服务器发送了一个GET请求。
我们解析服务器返回的JSON数据,并打印出账户中余额大于0的币种。