API 文档

概览

• Base URL：https://api.rurix.org/api/v1
• 交易对使用大写拼接，例如 BTCUSDT。
• 公开行情无需签名；交易 / 账户 / 充提需要签名。
• Key 权限：READ（查询）、TRADE（下单划转）。不提供程序提现。

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {}
}

code=0 表示成功；非 0 时 data 一般为 null。

鉴权签名

在账户中心创建 API Key 后，私有接口请带以下请求头：

• X-ACCESS-KEY
• X-ACCESS-TIMESTAMP（毫秒时间戳）
• X-ACCESS-SIGN（HMAC-SHA256 十六进制）

签名串（五段用换行拼接）

timestamp
METHOD
path
query
body

path 含 /api/v1/...，不含 query。query 为原始 QUERY_STRING，无则空串；body 为原始请求体，无则空串。可选 recvWindow（毫秒，默认 5000，最大 60000）。也兼容旧版 WS：HMAC(secret, access_id={key}&tonce={ts})。

Python

import hmac, hashlib, time, requests

base = "https://api.rurix.org/api/v1"
key, secret = "rx_xxx", "your_secret"
ts = str(int(time.time() * 1000))
method, path = "GET", "/api/v1/account/balance"
query, body = "asset=USDT", ""
payload = "\n".join([ts, method, path, query, body])
sign = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest()

r = requests.get(base + "/account/balance", params={"asset": "USDT"}, headers={
    "X-ACCESS-KEY": key,
    "X-ACCESS-TIMESTAMP": ts,
    "X-ACCESS-SIGN": sign,
})
print(r.json())

市价买入现货用 quoteOrderQty（计价币金额）；市价卖出用 quantity。合约 BUY=开多，SELL=开空。

系统 · PUBLIC

行情（现货，公开） · PUBLIC

现货交易 · SIGNED

合约 · SIGNED

账户 · SIGNED

充提 · SIGNED

API Key · SIGNED

用户数据流 · SIGNED

错误码

后台 API 开关关闭时，全部 /api/v1 返回 50301。程序提现默认关闭。