mirror of https://github.com/discountry/ritmex-bot.git synced 2026-09-09 08:18:07 +00:00

Files

T

discountry a6394191d8 docs: update README and add bilingual configuration guides for exchanges

- Changed installation command from `npx` to `bunx` for consistency.
- Added bilingual configuration guides for Aster and Backpack exchanges.
- Updated exchange details in the README to reflect new market types and required settings.
- Enhanced clarity in the supported exchanges section with updated variable names and descriptions.

2026-07-12 11:51:45 +08:00

2.9 KiB

Raw Permalink Blame History

StandX 配置教程

English version: StandX Configuration Guide

适用范围

本教程用于 StandX 永续适配器。标准配置包含 JWT Token 和 Ed25519 请求签名私钥。JWT 负责身份认证，签名私钥负责交易类请求签名。

1. 获取 Token 与签名私钥

打开 StandX API Session。
连接钱包并完成登录。
生成 API Token。
保存页面显示的 JWT Token、Ed25519 Private Key、创建日期和有效期。

官方认证流程使用钱包签名获取 JWT，并使用 Ed25519 密钥签署请求正文。官方密钥格式为 Base58，适配器也接受 32 字节十六进制或 Base64 表示。

2. 最小配置

EXCHANGE=standx
STANDX_TOKEN=<your_standx_jwt>
STANDX_REQUEST_PRIVATE_KEY=<your_ed25519_private_key>
STANDX_SYMBOL=BTC-USD

STANDX_TOKEN 是适配器初始化的必填项。STANDX_REQUEST_PRIVATE_KEY 是下单、撤单和修改保证金模式等签名请求的必填项。

3. Token 到期提醒

StandX 官方认证流程的默认 JWT 有效期为 7 天。按 API 页面显示的信息配置到期提醒：

STANDX_TOKEN_CREATE_DATE=2026-07-12
STANDX_TOKEN_VALIDITY_DAYS=7

旧配置也支持 STANDX_TOKEN_EXPIRY，其值可以是秒级/毫秒级时间戳或 ISO 日期。

4. 可选配置

变量	默认值	说明
`STANDX_BASE_URL`	`https://perps.standx.com`	REST API 地址
`STANDX_WS_URL`	`wss://perps.standx.com/ws-stream/v1`	WebSocket 地址
`STANDX_SESSION_ID`	自动生成 UUID	订单响应流会话标识
`STANDX_WS_DEBUG`	`false`	输出 WebSocket 调试日志
`STANDX_WS_DEBUG_RAW`	`false`	输出原始 WebSocket 消息

交易对使用 BTC-USD 这类格式。通过市场规则确认 PRICE_TICK、QTY_STEP 和最小数量。

5. 验证配置

bun run index.ts doctor --exchange standx --symbol BTC-USD --json
bun run index.ts market ticker --exchange standx --symbol BTC-USD --json

以上命令不会创建订单。Token 到期后重新生成凭证，并同步更新 Token 与签名私钥。

常见问题

Missing STANDX_TOKEN：填写有效 JWT Token。
Request signature skipped：填写 STANDX_REQUEST_PRIVATE_KEY，确认 Base58 解码后为 32 字节。
401 或 Token 过期：重新生成 Token，更新到期配置。
订单响应流缺失：保持 STANDX_SESSION_ID 稳定并检查 WebSocket 地址。

安全要求

Token 与签名私钥组合具备交易能力，应按交易凭证级别保护。
使用独立 API 会话并定期轮换。
凭证泄露后立即在 StandX 撤销会话并生成新凭证。

2.9 KiB Raw Permalink Blame History