Use when the task requires operating exchanges with the ritmex-bot CLI, including capability checks, market/account/position queries, order operations, strategy run, dry-run simulation, and JSON output parsing.
This skill is for running ritmex-bot in an agent-safe, exchange-compatible way.
ritmex-bot commands directly.--json output.--dry-run before real writes.--symbol; pass it through exactly.UNSUPPORTED), do not fake behavior.order create, order cancel, ), prefer first unless the user explicitly asks to skip simulation.order cancel-all--dry-run--json whenever output must be consumed by another agent/tool.Use one of these:
ritmex-bot <command>
npx ritmex-bot <command>
bunx ritmex-bot <command>
bun run index.ts <command>
If ritmex-bot is unavailable, use bun run index.ts <command> from repo root.
exchange listexchange capabilities --exchange <id>--json).--dry-run --json.order open, position list, or account snapshot as needed.| Flag | Short | Meaning |
|---|---|---|
--exchange | -e | Exchange override |
--symbol | - | Trading symbol (pass-through) |
--json | -j | JSON output |
--dry-run | -d | Simulate write ops |
--timeout | -t | Timeout in ms (default 25000) |
--help | -h | Show help |
helpdoctorexchangemarketaccountpositionorderstrategydoctorritmex-bot doctor
ritmex-bot doctor --exchange binance --symbol BTCUSDT --json
Returns effective setup and runtime capabilities.
exchangeritmex-bot exchange list
ritmex-bot exchange capabilities --exchange standx
If runtime adapter cannot initialize, capabilities may fallback to static metadata.
marketritmex-bot market ticker --exchange <id> --symbol <symbol>
ritmex-bot market depth --exchange <id> --symbol <symbol> --levels 10
ritmex-bot market kline --exchange <id> --symbol <symbol> --interval 1m --limit 100
Rules:
kline requires --interval.depth --levels is optional.kline --limit is optional.accountritmex-bot account snapshot --exchange <id>
ritmex-bot account summary --exchange <id>
summary is an alias of snapshot.
positionritmex-bot position list --exchange <id>
ritmex-bot position list --exchange <id> --symbol <symbol>
orderritmex-bot order open --exchange <id> --symbol <symbol>
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000
Required:
--side = buy|sell--type = limit|market|stop|trailing-stop|close--quantity or --qtyConditional required:
limit: --pricestop: --stop-pricetrailing-stop: --activation-price and --callback-rateOptional:
--time-in-force (GTC|IOC|FOK|GTX)--reduce-only (true|false)--close-position (true|false)--trigger-type (UNSPECIFIED|TAKE_PROFIT|STOP_LOSS)--sl-price--tp-priceritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id>
ritmex-bot order cancel-all --exchange <id> --symbol <symbol>
strategyritmex-bot strategy run --strategy maker --exchange standx --silent
ritmex-bot strategy run --strategy offset --exchange binance --dry-run
Supported strategy IDs:
trendswingguardianmakermaker-pointsoffset-makerliquidity-makerbasisgridAliases:
offset -> offset-makermakerpoints / maker_points -> maker-pointsliquidity / liquiditymaker / liquidity_maker -> liquidity-makerExtra flags:
--silent (short alias -q)--dry-run# 1) Simulate
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000 --dry-run --json
# 2) Execute live only after confirmation
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type limit --quantity 0.01 --price 90000 --json
# 1) Simulate
ritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id> --dry-run --json
# 2) Execute live
ritmex-bot order cancel --exchange <id> --symbol <symbol> --order-id <id> --json
Prefer --json and parse:
success (boolean)command (executed command kind)exchangesymboldryRundata (success payload)error.code, error.message, error.retryable (failure payload)Human-readable mode is fine for manual terminal use; --json is preferred for automation.
Map failures by code/exit code:
INVALID_ARGS -> exit 2MISSING_ENV -> exit 3UNSUPPORTED -> exit 5EXCHANGE_ERROR -> exit 6TIMEOUT -> exit 7Handling policy:
INVALID_ARGS: fix command arguments and retry once.MISSING_ENV: report missing configuration; do not invent env keys.UNSUPPORTED: return clearly as unsupported for that exchange.EXCHANGE_ERROR: return details and retry only if user requests.TIMEOUT: optionally retry with larger --timeout once.BTCUSDT, BTCUSDC, BTC_USD_PERP, BTC-PERP).--symbol is provided, let existing exchange config resolve it.--exchange is provided, let existing env resolution decide it.ritmex-bot exchange list --json
ritmex-bot exchange capabilities --exchange <id> --json
ritmex-bot doctor --exchange <id> --symbol <symbol> --json
ritmex-bot market ticker --exchange <id> --symbol <symbol> --json
ritmex-bot market depth --exchange <id> --symbol <symbol> --levels 20 --json
ritmex-bot market kline --exchange <id> --symbol <symbol> --interval 1m --limit 120 --json
ritmex-bot account snapshot --exchange <id> --json
ritmex-bot position list --exchange <id> --symbol <symbol> --json
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type market --qty 0.01 --dry-run --json
ritmex-bot order create --exchange <id> --symbol <symbol> --side buy --type market --qty 0.01 --json
ritmex-bot order open --exchange <id> --symbol <symbol> --json
ritmex-bot strategy run --strategy trend --exchange <id> --dry-run
ritmex-bot strategy run --strategy trend --exchange <id> --silent
Before returning results to user:
dryRun or live.order open / position list).