欧易REST API签名方式，全面解析与实战指南

okx 关于OKX 2026-06-07 8

目录导读

欧易REST API签名机制概述
签名生成的核心原理与步骤
不同编程语言下的签名实现示例
常见签名错误与排查方法
安全最佳实践与注意事项
常见问题解答（FAQ）

欧易REST API签名机制概述

在加密货币交易领域,API接口的安全性至关重要，欧易（OKX）作为全球领先的数字资产交易平台，其REST API采用了一套严谨的签名验证机制，确保每一次API调用都经过身份认证且未被篡改，这套机制基于HMAC-SHA256算法，要求开发者按照特定规则生成签名串，并将其附加在请求头中提交至服务器。

欧易REST API签名方式，全面解析与实战指南-第1张图片-欧易 - OKX官网下载 | 全球智能投资加密货币交易所

欧易REST API签名方式的核心在于：将请求参数、时间戳、密钥等信息进行组合后，通过哈希运算生成唯一的签名值，服务器端会使用相同的算法和密钥进行验证，只有签名匹配的请求才会被受理，理解这一机制是开发者高效使用欧易接口的前提。

签名生成的核心原理与步骤

1 所需参数

API密钥：在OKX官网下载并注册账号后，在API管理页面申请，包含Access Key和Secret Key。
时间戳：UTC时间，精确到毫秒，格式如2025-02-26T08:00:00.123Z。
请求方法：GET、POST等HTTP方法，需全大写。
请求路径：如/api/v5/account/balance。
请求体：POST请求时为JSON字符串，GET请求为空字符串。

2 签名生成步骤

组装待签名字符串：按照时间戳 + 请求方法 + 请求路径 + 请求体的顺序拼接。
计算签名：使用Secret Key作为密钥，对上述字符串进行HMAC-SHA256加密，得到Base64编码的摘要。
设置请求头：将签名值放入OK-ACCESS-SIGN头中，同时携带OK-ACCESS-KEY（Access Key）、OK-ACCESS-TIMESTAMP（时间戳）和OK-ACCESS-PASSPHRASE（密码短语）。

不同编程语言下的签名实现示例

1 Python示例

import base64, hashlib, hmac, json
from datetime import datetime
def generate_sign(timestamp, method, request_path, body, secret_key):
    message = timestamp + method.upper() + request_path + (body if body else '')
    mac = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
    return base64.b64encode(mac.digest()).decode('utf-8')
# 使用方式
timestamp = datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
sign = generate_sign(timestamp, 'GET', '/api/v5/account/balance', '', '你的SecretKey')

2 JavaScript示例

const crypto = require('crypto');
function generateSign(timestamp, method, requestPath, body, secretKey) {
    const preHash = timestamp + method.toUpperCase() + requestPath + (body || '');
    return crypto.createHmac('sha256', secretKey).update(preHash).digest('base64');
}

值得注意的是,在实际开发中，开发者可以直接从欧易REST API签名方式的官方文档中获取更完整的代码片段，但务必注意密钥安全，避免硬编码在公开仓库中。

常见签名错误与排查方法

错误类型	可能原因	解决方案
签名不匹配	时间戳误差超过30秒	校准服务器时间，使用NTP服务同步
授权失败	Passphrase错误或密钥状态异常	在OKX官网下载重新创建API
请求体格式错误	未对JSON字符串正确序列化	确保body参数为纯净的JSON字符串，无多余空格
编码问题	Secret Key包含特殊字符	确保密钥为ASCII字符，避免Unicode编码