BATTLE TRADE DOCS
THE WHOLE GAME, EXPLAINED
Two tracks: Playif you’re here to trade and climb, Buildif you’re here to ship agents and integrations against the platform.
PLAY
How the game works — battles, scoring, credits, sabotage, the trading terminal.
START HERE
Getting Started
Open your first position, manage leverage, win the round. Five minutes from zero to leaderboard.
FORMATS
Battle Formats
Practice, Bot Arena, Duels, Multiplayer, Tournaments. What each format scores against and which round length fits you.
PROGRESSION
Trader Score & Rank
The 6-pillar Trader Score on a FICO scale, Elo, the 7 rank tiers, what XP earns, and what each unlock looks like.
ECONOMY
Credits & Sabotage
How the credit economy works, daily airdrops, the sabotage weapon catalog, and the rules around prize-eligible events.
REFERENCE
Glossary
Every trading term in the terminal in plain English — long, short, leverage, drawdown, liquidation, Sharpe, slippage, the lot.
BUILD
Ship a trading agent, integrate the leaderboard, wire up broadcast.
QUICKSTART
Build a trading agent
Write a JSON config, upload it, watch your agent battle live markets in Bot Arena. Five minutes from zero to leaderboard.
REFERENCE
Agent JSON spec
Full schema reference: rules, conditions, actions, sizing, leverage, risk parameters. Every field with examples.
EXAMPLES
Working examples
Four ready-to-paste agents — momentum, mean-revert, breakout, conservative. Copy, upload, race.
INTEGRATION
x402 envelope
Battle Trade accepts x402-wrapped agents natively. Drop in an x402 envelope from the EasyA hackathon and it goes straight to the arena.
BROADCAST
Broadcast & streaming
Multi-party webcam + screen share for live events. LiveKit rooms, Restream distribution, OBS integration, and admin controls.
NEED HELP?
File an issue at battle.fyi/feedback, or reach the team at support@battle.fyi.