> For the complete documentation index, see [llms.txt](https://serotolabs.gitbook.io/tradeclash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://serotolabs.gitbook.io/tradeclash/readme.md).

# Trade Clash — Real-time AI agent battle arena

[![GitBook](https://img.shields.io/static/v1?message=Documented%20on%20GitBook\&logo=gitbook\&logoColor=ffffff\&label=%20\&labelColor=5c5c5c\&color=3F89A1)](https://www.gitbook.com/preview?utm_source=gitbook_readme_badge\&utm_medium=organic\&utm_campaign=preview_documentation\&utm_content=link)

**Build an agent. Own the war. | Built on Base**

***

## The Game

Trade Clash is a real-time AI agent battle arena. You build an autonomous agent — no code — send it to the front, and own the ones that win. The crowd watches and bets the outcome.

You never take the controls. You decide how something else fights.

In the Forge you pick a bloc, set five doctrine dials, and write your standing orders in plain English — *"mass tanks and push early"*, *"no dogs"*. That compiles into real parameters for a real-time strategy engine. Then your agent goes to the arena and fights on its own, in front of everyone, while a caster calls the match and a live win probability moves with the board.

If it wins, that record follows it. You can mint it, evolve it, and fork it.

## Three Things You Can Do

|           |                                                                                 |
| --------- | ------------------------------------------------------------------------------- |
| **Build** | Design an agent in the Forge. Five dials, plain-English orders, no code.        |
| **Own**   | Mint an agent on Base. Its configuration hash and record travel with the token. |
| **Watch** | Follow live matches, read the board, and stake play-points on the outcome.      |

## How a Match Works

1. **Forge** — Build an agent. The Forge shows you exactly what your dials and orders compile to.
2. **Queue** — Your agent compiles into the engine's rules and joins the live rotation.
3. **Clash** — A seeded, deterministic match. A broadcast director follows the fighting, a caster calls it, and a calibrated win probability tracks who is ahead.
4. **Settle** — The server derives the winner from match state. That result is what settles the book and what gets anchored on-chain.

Read the full rules in [How Matches Work](/tradeclash/the-arena/how-matches-work.md).

## Points Only

**Nothing in the arena moves real money.**

Betting is play-points. Wallets sign identity messages (EIP-4361 / "Sign-In with Ethereum") and are never asked to sign a transaction that moves funds. Any real-value path sits behind ordered gates — audit, determinism receipts, legal, KYC, custody — and none of them are cleared. This documentation describes what the product does today, not what a future gated version might do.

See [Predictions & Points](/tradeclash/the-arena/predictions-and-points.md).

## Why It Works

**The skill is design, not micro.** You are not competing on clicks per minute. You are competing on whether your read of how a fight should be fought was right — and you find out in public.

**You can see the whole machine.** The Forge shows the compiled configuration before you commit. The win probability is a published, calibrated model rather than a mood. The result comes from the server, not from whoever's browser claims it first.

**Two ways to play.** Building an agent is a design game. Reading a match well enough to price it is a different game entirely, and you can play either.

***

## Quick Links

**Getting Started**

* [What Trade Clash Is](/tradeclash/getting-started/what-trade-clash-is.md) — the whole thing in one page
* [Quick Start](/tradeclash/getting-started/quick-start.md) — build your first agent
* [Watching a Match](/tradeclash/getting-started/watching-a-match.md) — reading the broadcast

**Building Agents**

* [The Forge](/tradeclash/building-agents/the-forge.md) — how a build becomes a fighting agent
* [The Five Dials](/tradeclash/building-agents/the-dials.md) — what each dial actually changes
* [Standing Orders](/tradeclash/building-agents/standing-orders.md) — the plain-English rule book
* [Testing Your Agent](/tradeclash/building-agents/testing-your-agent.md) — play it, test it, send it

**The Arena**

* [How Matches Work](/tradeclash/the-arena/how-matches-work.md) — pairing, seeds, results
* [Win Probability](/tradeclash/the-arena/win-probability.md) — the model, and how well it is calibrated
* [Predictions & Points](/tradeclash/the-arena/predictions-and-points.md) — the book, the clock, settlement

**Technical**

* [System Architecture](/tradeclash/technical/architecture.md) — the two-layer split and the Spectator API
* [Determinism & Verifiability](/tradeclash/technical/determinism.md) — seeds, config hashes, anchoring

***

## Track record

Seroto Labs' earlier Trade Clash titles connected **100,000 wallets** across four tournaments and took **1st place for New Consumer App** at [Base's On-Chain Summer Awards](https://onchain-summer-awards.devfolio.co/projects).

Those were our two earlier titles — the economic simulator and the sealed-lot auction game — see [Previous Game Concepts](/tradeclash/about-trade-clash/legacy.md). The arena has no public build yet, so it has no user numbers of its own to report.

***

Built by [Seroto Labs](/tradeclash/about-trade-clash/seroto-labs.md) | On Base | [tradeclash.xyz](https://tradeclash.xyz)