okx-trading

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Use this workflow when editing

src/providers/okx/*

在编辑

src/providers/okx/*

文件时使用本工作流。

For SDK usage patterns and method names, read
```
references/okx-sdk-usage.md
```
.
For error-to-action mapping, read
```
references/okx-error-map.md
```
.
For full source context, consult
```
.trae/okx-api-llm.txt
```
only for missing details.

Preserve compatibility with

src/providers/types.ts

(

BrokerProvider

MarketDataProvider

OptionsProvider

Put OKX-specific expanded APIs behind OKX provider interfaces (for example
```
OkxTradingProvider
```
) while keeping generic provider methods working.
Ensure
```
src/providers/broker-factory.ts
```
can return OKX providers without adapter breakage.

保持与

src/providers/types.ts

中定义的

BrokerProvider

、

MarketDataProvider

、

OptionsProvider

兼容。

Use OKX signing prehash:

timestamp + UPPERCASE_METHOD + requestPathWithQuery + rawBody

Use HMAC SHA256 base64 signing for both REST and private websocket auth via
```
customSignMessageFn
```
.
Pass
```
demoTrading: true
```
for simulated trading.

使用OKX签名预哈希规则：

timestamp + UPPERCASE_METHOD + requestPathWithQuery + rawBody

。

Trading: spot, margin, swap/futures, options order placement + cancel/query + list.
Account: balances, positions, bills/transactions, fills.
Market data: ticker(s), order book, trades, candles, instruments.
Websocket: ticker, orderbook, trades, candles, account/orders/positions subscriptions.

Parse and map OKX
```
code
```
+
```
msg
```
errors into internal error categories.
Handle known auth/order/risk/rate-limit codes explicitly.
Apply request throttling + retry with exponential backoff and jitter for retryable failures.
Avoid retrying invalid input/auth failures.

Update
```
src/providers/okx/README.md
```
with examples that match current method names.
Include one example each for: spot order, futures order, option order, account history, websocket subscription.
Keep examples SDK-realistic and aligned with
```
references/okx-sdk-usage.md
```
.