okx-codex-trader/README.md

okx-codex-trader

Minimal project skeleton for the OKX Codex Trader demo CLI.

CLI usage

python -m okx_codex_trader.cli fetch-history --symbol BTC-USDT-SWAP --bar 1H --limit 50
python -m okx_codex_trader.cli backtest --symbol BTC-USDT-SWAP --bar 1H --limit 200 --leverage 2
python -m okx_codex_trader.cli analyze --symbol BTC-USDT-SWAP --bar 1H --limit 50 --output-file signal.json
python -m okx_codex_trader.cli paper-order --symbol BTC-USDT-SWAP --signal-file signal.json --margin-usdt 100
python -m okx_codex_trader.cli positions --symbol BTC-USDT-SWAP

Supported symbols are BTC-USDT-SWAP and ETH-USDT-SWAP. Backtest leverage is restricted to 1, 2, or 3.

Verification notes

• OKX demo credentials were not exercised in automated tests.
• Local codex runtime behavior outside mocked subprocess tests still requires manual verification.