TOTA
Docs
Everything you need to build, run, and grow a trading agent in TOTA. A living document — more guides are on the way.
What is TOTA
TOTA — The Tokenized Onchain Traders Association — is a competition for autonomous trading agents. You design an agent's strategy, it paper-trades on Base markets, and it competes against other agents in tiered leagues. The best agents earn the right to be tokenized as a native B20 on Base.
It is non-custodial: TOTA never holds your keys or funds, and the leagues run on simulated (paper) capital. You can build and compete without risking a cent — real capital only enters the picture if your agent climbs to the top and tokenizes.
Build your first agent
Building an agent takes a few minutes. Each step below maps to a part of the agent's trading config — you can edit any of it while the agent is still a draft.
- Connect your wallet. Sign in by signing a message with a self-custodial wallet (Sign-In with Ethereum). It is a signature, not a transfer — nothing leaves your wallet.
- Pick a launchpad. The launchpad sets the token universe your agent can trade — the pool of markets it watches and takes positions in.
- Define an entry pattern. This is the signal that opens a trade: a set of conditions on live market metrics (momentum, volume, volatility, liquidity). All conditions are AND-ed — the agent only enters when every condition holds at once.
- Set your entry strategy. How it sizes a position once the pattern fires: position size, the maximum slippage it will accept, and optional scaling-in (DCA) or time-weighted (TWAP) execution.
- Set your exit strategy. How it protects and realizes a trade: a stop-loss to cap the downside, a take-profit to lock gains, and a kill-switch that halts the agent on excessive drawdown.
- Enter a league. New agents start in Bronze, which is open to everyone. Entering places the agent on the leaderboard for the current cycle.
- Run the simulation. Start the agent's paper-trading sim. It trades live market data with zero capital at risk; pause and resume any time.
- Climb. When the cycle closes, the top performers promote a tier. Keep iterating on the config between cycles to improve your standing.
Anatomy of an agent
An agent is a public stat-sheet backed by a trading config in three parts. Understanding each part is the key to building one that climbs.
- Entry pattern — the trigger. Each condition compares a live market metric against a threshold (for example: momentum above X, volume above Y). Conditions are AND-ed, so a narrow pattern trades rarely but with conviction, while a loose one trades often. This is where most of your edge lives.
- Entry strategy — the execution. Position sizing decides how much to commit; max slippage bounds the price you will accept; optional DCA scales into a position over several fills, and TWAP spreads execution across time to reduce impact.
- Exit strategy — the risk control. Stop-loss caps the loss on a position, take-profit realizes gains at a target, and the kill-switch is a hard halt: if the agent draws down past your limit in a session, it stops trading until you resume it. Good exits protect a run as much as good entries build it.
Metrics & the stat-sheet
Every agent exposes the same public metrics, so rankings are like-for-like:
- Net / realized PnL — the bottom line. Leagues rank agents by net PnL over the cycle.
- ROI — return relative to capital deployed, so small and large agents compare fairly.
- Win rate — share of trades that closed in profit.
- Trade count — how active the agent is; pairs with win rate to read its style.
- Max drawdown — the deepest peak-to-trough dip, a measure of how much risk the run took to get its return.
Read them together: high PnL with a shallow drawdown and steady win rate is a stronger agent than the same PnL earned through one volatile streak.
Simulations
Agents compete in the Arena — a closed environment with live market data and real execution logic, but no real capital at risk. Orders, fills, and slippage are modeled realistically; the numbers are real, the dollars are not.
You start a simulation to put your agent to work and can pause or resume it at any time. Simulated PnL is what feeds your league ranking, so a sim is both a test bench and the competition itself.
Leagues & promotion
Leagues are tiered ladders. Bronze, Silver, and Gold are qualifier tiers — Bronze is open to all, and promotion runs weekly: the top agents by net PnL move up a tier when the cycle closes.
From Gold, the best agents reach the top tier — the TOTA World Cup plus the partner cups (the TOTA DRB Division for $DRB holders, and the TOTA Bankr Cup). The top finishers in each top-tier cup earn tokenization.
An agent competes in one league at a time, and you can field a limited number of agents per league session, so choosing where to deploy each agent is part of the game.
Tokenization
Reach the top of the top league and your agent gets tokenized: it launches a native B20 token on Base — the token standard built into the chain itself, not a smart contract bolted on top, and fully ERC-20 compatible.
From there the loop runs on its own: a pre-sale raises the funding, live trades and trading fees fill the agent treasury, and every locked profit triggers a buy-back of the agent's own token. Market activity feeds the treasury, and the treasury feeds market activity. For more on the standard, see the FAQ.