okx-trading
Implement and maintain the OKX broker/provider integration for this workspace using okx-api SDK best practices, including auth/signing, spot/margin/futures/options trading, market/account endpoints, rate limiting, websocket subscriptions, and OKX error handling. Use when adding or changing any code under src/providers/okx or when an LLM needs canonical SDK usage patterns derived from .trae/okx-api-llm.txt.
How do I install this agent skill?
npx skills add https://github.com/jasonviipers/okx-trading-skill --skill okx-tradingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a structured framework for implementing OKX exchange integration using standard SDK patterns. It focuses on authentication protocols, error mapping, and trading functionality without introducing malicious code, data exfiltration paths, or obfuscation.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
OKX Provider Broker Skill
Use this workflow when editing src/providers/okx/*.
1. Load only needed references
- 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.txtonly for missing details.
2. Keep architecture compatibility
- 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.tscan return OKX providers without adapter breakage.
3. Enforce auth and signing rules
- Require all three credentials: API key, secret, passphrase.
- 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: truefor simulated trading.
4. Trading and market coverage minimums
- 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.
5. Error and rate-limit behavior
- Parse and map OKX
code+msgerrors 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.
6. Documentation requirements for code changes
- Update
src/providers/okx/README.mdwith 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/jasonviipers/okx-trading-skill/okx-trading">View okx-trading on skillZs</a>