Display Settings
Customize your trading experience through the settings panel:
BTC Display Unit
Toggle between:
- BTC - Standard notation (0.00021 BTC)
- Satoshis - Smallest unit (21,000 sats)
Sats display can be easier for smaller amounts and helps avoid decimal point errors.
Currency Display
View USD equivalents for all amounts. Prices update in real-time.
Protocol Selection
Understanding Protocols
Each asset can be traded on different protocol layers:
| Layer | Format | Speed | Use Case |
|---|
| RGB/LN | RGB/LN | Fast | Day trading, frequent swaps |
| RGB/L1 | RGB/L1 | 10+ min | Larger amounts, cold storage |
| BTC/LN | BTC/LN | Fast | Bitcoin Lightning |
| BTC/L1 | BTC/L1 | 10+ min | On-chain Bitcoin |
Choosing the Right Layer
- Speed priority: Use Lightning (LN) variants
- Large amounts: On-chain (L1) may be more suitable
- Liquidity: Lightning typically has tighter spreads
Order Tracking
Order States
Every swap order progresses through a series of states. The order page displays a visual timeline so you can track progress in real time.
| State | Description | User Action |
|---|
| Awaiting Deposit | Order created, waiting for your payment | Pay the deposit address/invoice |
| Payment Confirmed | Your payment has been received | Wait for the maker to process |
| Executing Swap | The maker is processing and sending the asset | Wait for completion |
| Swap Completed | The swapped asset has been sent to your recipient address | Done |
| Expired | The order expired before payment was received | Create a new order |
| Cancelled | The order was cancelled | Create a new order |
| Failed | Something went wrong during execution | Check details, contact support |
| Pending Rate Decision | The rate changed and you need to decide | Accept or reject the new rate |
Order Timeline
The order page shows a four-step visual timeline:
Awaiting Deposit → Confirming → Exchanging → Completed
Order History
You can view your recent orders from the home page. The Recent Activity section lists your past orders with:
- Order ID
- Asset pair and amounts
- Order status
- Timestamp
Click any order to open its detail page.
Polling
The order page automatically polls for status updates every 10 seconds. You do not need to refresh the page. Polling stops once the order reaches a final state (completed, expired, cancelled, or failed).
Rate Decision
If the exchange rate changes after your order is created but before the swap is executed, you may be presented with a Rate Decision screen.
What Happens
- The rate changed between order creation and execution
- The order is paused at the Pending Rate Decision state
- You are shown the updated rate
Your Options
| Option | What Happens |
|---|
| Accept New Rate & Swap | The swap continues with the updated rate |
| Cancel & Request Refund | The order is cancelled and a refund is initiated |
If you do not make a decision before the order expires, the order will be automatically cancelled and a refund initiated.
How It Looks
When a rate decision is needed, a full-screen overlay appears on the order page showing:
- A warning that the rate has been updated
- The new rate details
- Two buttons: Accept New Rate & Swap or Cancel & Request Refund
Payment Issues
Overpayment or Underpayment
If the amount you paid does not match the expected deposit amount, the order page will display a Payment Issue screen.
| Scenario | What You See |
|---|
| Overpaid | The expected amount, the amount you sent, and the difference |
| Underpaid | The expected amount, the amount you sent, and the shortfall |
Resolution
Payment discrepancies require manual resolution. The payment issue screen provides:
- Email Support button - contact the team directly
- Telegram Support button - reach out via Telegram
Always pay the exact amount shown on the order page. Copy the invoice or address to avoid manual entry errors.
API Integration
Quote API
Direct API access for programmatic trading:
GET /api/get-quote?from=BTC&to=USDT&from_amount=1000000
- RFQ ID
- Price quote
- Expiry time
- Fee breakdown
List Pairs API
Discover available trading pairs:
Returns all active pairs with:
- Min/max amounts
- Protocol layers
- Asset metadata
WebSocket Updates
The app uses WebSocket for real-time data:
- Quote streaming - Live price updates as you type amounts
- Connection quality - Monitored and displayed in the UI
Keyboard Shortcuts
| Shortcut | Action |
|---|
Tab | Move between inputs |
Enter | Submit current action |
Esc | Close modals |
Mobile Experience
The web app is fully responsive:
- Touch-optimized - Large tap targets
- Swipe support - Natural gestures
- QR Codes - Scan deposit addresses from a mobile wallet
Caching
Static data (assets, pairs) is cached for performance. Manual refresh:
- Hard refresh:
Ctrl+Shift+R / Cmd+Shift+R
- Or close and reopen the app
Connection Issues
If experiencing slowness:
- Check internet connectivity
- Try a different browser
- Clear browser cache
- Disable browser extensions that might interfere
Developer Features
Debug Mode
Open browser console to see:
- API request/response logs
- WebSocket message flow
- State transitions
Network Inspection
Use browser DevTools Network tab to:
- Monitor API calls
- Check WebSocket frames
- Debug connectivity issues
