Instrucciones de origen · Vista previa de solo lectura
name
xrpl_mm_deploy
description
End-to-end playbook for standing up an XRPL CLOB maker — preflight, planner, controller deploy, verify.
when_to_use
When asked to set up, deploy, or launch market making on an XRPL pair. Follow start to finish when running as a delegate task.
created
2026-07-28T00:00:00Z
source
agent:xrpl_market_maker
XRPL Maker Deploy
Default path: controller mode (pmm_simple). Fall back to executor mode only after a
real controller failure (schema reject, deploy/status error, or no on-ledger orders).
Phase 1 — Preflight
Pair quality — explore_geckoterminal(action="top_pools", network="xrpl"). Need
real depth and turnover. RLUSD/XRP is currently the only pair with both.
Issuer transfer fee = 0% — non-zero fees can erase the whole spread.
XRPL credentials configured — without them the keyless connector has empty trading
rules and nothing can size. Stop and tell the user; executor mode will not rescue this.
Balances — get_portfolio_overview(). Need free XRP for reserves (1 + 0.2×offers),
a trustline for the issued asset, and inventory on both sides.
requote_interval_sec is the bot's executor_refresh_time in controller mode — not
frequency_sec. Wrong interval → false viable: false.
If viable: false with the right interval → do not deploy. Shorten
executor_refresh_time or wait. Never tighten below the floor. Large
divergence_vs_reference_bps usually means stale data, not opportunity.
Phase 3 — Deploy (controller first)
pmm_simple only. Set leverage=1; leave stop_loss/take_profit/time_limit/
trailing_stopnull.
Override these four defaults:
Field
Default
Set to
executor_refresh_time
300
30 (from config)
skip_rebalance
false
true
buy_spreads / sell_spreads
0.01,0.02
planner controller_spreads (fractions)
total_amount_quote
100
planner controller_total_amount_quote (XRP on RLUSD-XRP)
pmm_simple centres on XRPL mid, not the CEX reference — if divergence is routinely
wide, recommend executor mode instead of deploying.
