Wallet Overview
Manage your XRPL wallet and token balances
Wallet History
Timeline of on-ledger transactions and your XRP balance over time.
| Date | Type | Result | Balance (XRP) | Δ XRP | Swap Currency | Token Amount | Token Price (XRP) |
|---|---|---|---|---|---|---|---|
Runs
Browse your bot runs and view basic summaries.
Run Summary
Portfolio Performance
Track your trading performance over time
Total Value
Total Trades
Win Rate
Trading Configuration
Configure your trading bot settings
Bot Options
Risk & Allocation
Stop Loss
Take Profit
BUY Strategies
SELL Strategies
Profit & Loss
Detailed P&L analysis and trade history
Realized P&L
Unrealized P&L
Total P&L
Recent Runs
Trading Bot Control
Monitor and control your trading bot
Bot Status
Trading Mode
Currently Trading
Enabled Strategies
P&L
Run Trades
Positions
Duration
Market Chart
Signals
Profile
Manage your account settings
Support the project or unlock features using Telegram Stars. Choose a package below. If not opened inside Telegram, the invoice link will open in a new tab.
Log out of your account.
FAQ / Help
Learn what the bot can do and how to configure and operate it
- ⚡ Live trading on XRPL AMM paths with smart trustline handling and pool fee awareness.
- 🧪 Simulation mode to test strategies without risking funds.
- 🧠 Multiple technical strategies (RSI, Bollinger, MACD, SuperTrend, EMA crosses, ADX, Volume, DCA).
- 🤝 Signal modes: single, majority, consensus, and multi‑timeframe alignment.
- 🛡️ Risk controls: Stop Loss, Take Profit, and trailing variants.
- 📏 Position sizing: fixed USD or percent of spendable funds.
- 📊 Portfolio limits: max open positions, token allocation cap, cash reserve.
- 🎯 Default slippage: set a global slippage used for swaps, buys, and sells (overridable per action).
- 🪄 AI Assist: get one‑click strategy suggestions or continuous tuning of strategies and risk.
- 📈 Detailed run dashboard with indicators, signals, trade log, and fee tracking.
1) Choose Token 🔍
On the Configuration page, set the token contract as currencyHex.issuer and a friendly name. This becomes your active trading pair.
2) Timeframe ⏱️
Select your candle timeframe (e.g., 5m). Indicators and signals are computed on this timeframe. Optionally set a higher timeframe for confirmation.
3) Position Sizing 📐
Pick Percent (e.g., 10–20%) or Fixed USD. A minimum trade guard applies (default $1) to avoid dust orders.
4) Portfolio Limits 🧭
Set Max open positions, Max % in tokens, and Cash reserve %. These govern when buys are allowed.
5) Strategies 🧩
Enable the BUY/SELL strategies you want. Use Signal Mode to decide how strategies combine into a trade decision.
6) Protections 🛡️
Configure Stop Loss and Take Profit (fixed or trailing). When triggered, the log will show “Stop Loss” or “TAKE Profit”.
7) Mode 🔁
Choose Simulation or Live. Live mode uses your wallet’s real balances and requires a trustline to the token.
8) Save 💾
Click Save to persist configuration. Changes take effect immediately on a running bot.
- ▶️ Start/Stop: Go to Bot → click the status badge to toggle Online/Offline.
- 📜 Trade Log: Shows signals, executed trades, and any skipped trades with explicit reasons.
- 💧 Pool Fee: Displayed under “Currently Trading”. If not shown immediately, the bot will fetch it on startup.
- 🧯 Liquidate: On the Wallet page you can liquidate token holdings back to XRP (respecting slippage).
Why didn’t a BUY execute even though there was a signal?
Open positions limit, portfolio token cap, cash reserve, or minimum trade threshold can block buys. The log line will include “Reason: …” with details (e.g., min_trade_not_met or max_open_positions). You can also see a breakdown printed as [DEBUG/MIN-TRADE] in the server logs.
How do I ensure there’s a trustline?
For local wallets (keys on server), the bot can auto‑create a trustline if missing. For Xaman‑linked wallets (no local keys), add the trustline from your Xaman app or use Manage Trustlines → Remove (push flow sends a TrustSet to your device).
What does Pool fee mean?
It’s the AMM trading fee (in bps) for the IOU/XRP pool. The bot fetches it at startup and during trades to display on the dashboard.
What is Signal Mode?
Single executes on any enabled strategy. Majority requires more than half of enabled strategies agree (by side). Consensus requires all enabled strategies agree. Multi‑TF requires alignment with a higher timeframe.
How do I set the default slippage?
Go to Profile → Default Swap Slippage. Enter a percentage (e.g., 0.50%) and click Save Slippage. This becomes the default for quotes and for Swap/Buy/Sell operations. It’s stored per-user and can be overridden per action.
What does AI Assist do?
Click AI Assist on the Configuration page to open the AI Strategy Suggestion modal. Choose a one‑shot suggestion to quickly prefill strategies and risk, or enable continuous assistance to let AI help tune thresholds and protections as you trade. You can review changes before saving.
How do Stop Loss and Take Profit appear?
When triggered, SELL log entries are prefixed with “Stop Loss:” or “TAKE Profit:”.
How are my wallet keys handled and when are they decrypted? 🔐
• We hold your wallet seed/keys in encrypted form on our servers at all times (at rest).
• They are only decrypted in memory just‑in‑time to sign a transaction (e.g., a trade, trustline update), and immediately released after signing. ✅
• Keys are never stored in plaintext, never logged, and never sent to third‑party servers. ☁️🚫
• Encryption uses authenticated crypto (AES‑EAX) with a key derived from your login; changing your password re‑derives the wallet encryption key. 🔄
Why do I get a QR instead of a push to my Xaman app?
Push notifications require a user_token from Xaman. The first time you approve a Xaman SignIn or transaction for this app, Xaman issues the token. We capture it automatically when the payload resolves. After that, login, swap, withdraw, and bot trades will be pushed directly to your device. If you still see a QR:
• Approve one SignIn via QR to seed the token.
• Ensure you are using the same XUMM App (API key/secret) as before.
• You can clear the cached token under your browser’s local storage key xumm_user_token and SignIn again.
Does this work on a dev server that isn’t public?
Yes. We use polling for payload status and don’t require webhooks or OAuth redirects. Your server only needs outbound access to XUMM and XRPL. Webhooks are optional for production.
- 🔐 Sign in with Xaman: QR for first approval; thereafter we PUSH to your device (no QR) using the stored
user_token. - 💱 Swap / Buy / Sell: For Xaman-linked users, confirmations are sent to the app; we wait until you approve or reject.
- 🏧 Withdraw/Send: XRP and IOU sends create a Xaman payload with optional Destination Tag and Memo.
- 🔗 Trustlines: List trustlines without a local wallet; remove via a guided two‑step push (sell any balance ➜ TrustSet limit=0).
- 📜 Wallet History: If no local
.walletfile exists, we load history using your linked address (read‑only fallback).
Tip: You’ll see a modal with a QR and deeplink if PUSH isn’t available yet for your device/account.
For Xaman‑linked wallets the Liquidate action sends one transaction at a time to your phone and waits before sending the next to avoid ledger sequence errors. Each IOU with a positive balance triggers an IOU→XRP payment with slippage, then proceeds to the next.
- ⏳ You’ll receive multiple push requests — approve each in sequence.
- 💤 If a token has no liquidity or only dust, we may skip selling and keep the trustline unchanged.
- 🧪 Status: Beta. If a step fails or is rejected, you’ll get a partial summary and can retry.
- 🔄 IOU→IOU swaps are not supported yet (XRP↔IOU is supported).
- 📈 P&L view currently requires a local
.walletfile; Xaman‑only P&L is planned. - 🔔 Webhook callbacks are optional; we rely on polling by default. OAuth/OIDC Sign‑in with Xaman is not used in this app.