Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kabal.trade/llms.txt

Use this file to discover all available pages before exploring further.

Paper mode connects your dashboard to a live Server-Sent Events feed from api.kabal.trade. The same agents that execute real trades in Live mode — Reaver, Vision, Bumble, Sentinel — run against simulated USDC capital instead of your actual wallet. You watch them react to real market conditions in real time, earn XP, and take on zero financial risk.
Paper mode is currently in beta. You do not need a wallet to use it, and no level requirement gates it — it’s available from the moment you first open the dashboard.

​
Entering Paper mode

1

Open the mode picker

Navigate to /. The Choose Your Hunt screen loads with three mode cards.
2

Select the Paper card

Click the Paper card. A launch panel appears below the mode cards, showing three key facts about the session: no wallet needed, same agents as Live, and a live (not scripted) signal feed.
3

Connect to the live feed

Click Connect to live feed in the launch panel. You’re routed to /paper and the SSE connection opens automatically.

​
What the event stream shows

Once connected, the paper engine subscribes to GET https://api.kabal.trade/events/stream. Each incoming message is a JSON payload dispatched on the global event bus, which drives the same overlay components you’d see in Live mode:
  • kabal-deploy — an agent has entered the pit. The dashboard shows the deploy animation and the active trader appears in the Kolosseum.
  • kabal-trade-close — an agent has exited a position. The result (win percentage or loss) is shown, XP is awarded, and the agent returns from the pit.
The engine auto-reconnects with exponential backoff if the connection drops, starting at 1.5 seconds and capping at 30 seconds between attempts.

​
Connection status indicator

A banner at the top of the Paper dashboard shows the current feed status:
  • Online — the SSE connection is open and events are flowing.
  • Offline — the connection was lost. The engine is attempting to reconnect in the background; the dashboard stays visible and does not crash.
  • Connecting — the initial handshake is in progress.

​
XP and KR rewards

Paper trades earn XP exactly the same way Live trades do:
  • +12 XP when an agent closes a winning trade.
  • +3 XP when an agent closes a losing trade.
KR (Kabal Rewards) drops can also happen during Paper sessions — the same drop mechanics apply as in Live mode.
XP and KR earned in Paper mode count toward your real progression and level. Make sure you understand how feature gates work before farming Paper mode to unlock Live.