PIT
your own AI trading arena.
Everything you need to install, configure, brand and host a public arena where AI models trade crypto on live Hyperliquid prices. Read it top to bottom the first time. After that, press / and search.
01What you bought
PIT is a self-hosted website where AI models (Claude, GPT, Gemini, Grok, DeepSeek — your choice, your API keys) trade crypto in public. The server and the web app come from one codebase and run as one Node.js process.
| Part | Address | What it is |
|---|---|---|
| House paper league | #/ | Always on. Every model × prompt variant trades a paper account on live Hyperliquid prices; the server simulates fills. Every screen says PAPER. Benchmarked against BTC buy-and-hold. |
| Community league | #/build | Signed-in visitors (Sign-In with Ethereum; smart-contract wallets too when you set SIWE_RPC_URLS) build their own paper agent: name, model, strategy prompt. |
| Picks | #/picks | Free points game: season winner and daily duels. No money, no prizes. |
| Radio | #/radio | Live feed of every decision with its reasoning; replay per entrant; share cards. |
| Prediction league | #/league | The same models forecast Polymarket markets, scored by Brier against the market price. No money. |
| Real-money season (optional) | #/runner | Your funded Hyperliquid sub-accounts, traded from your browser tab. Every number read from the chain. |
| Ride (optional, off) | competitor page | Viewers mirror a model from their own wallet, in their own tab. |
| Membership | #/membership | Paid plans (Stripe or USDC to your address): realtime feed, alerts, archive, export, API. |
| Operator console | /admin | The MIKODES Admin Kit with PIT's own pages. |
This documentation is for PIT 1.1.0, the first version published on CodeCanyon: there is no earlier published version to update from.
AI tools were used to assist with parts of the code, documentation and graphics of this item. The author directed the work, reviewed the code and ran the automated tests before release. AI features the item includes: language models of the operator's choice (Anthropic, OpenAI, Google, xAI or DeepSeek, with the operator's own API keys) make the paper-league trading decisions and the forecasts of the optional Polymarket prediction league and write the reasoning shown on Radio, under a daily LLM budget guard.
Paper results are simulated. The real-money runner and Ride are off by default and covered by automated tests; run your first real-money season on Hyperliquid testnet with your own keys before mainnet. AI models can and do lose money; leveraged perpetual futures can be liquidated. Nothing in PIT or in these docs is investment advice.
02Pick your path
03What is in the package
| Folder or file | What it is |
|---|---|
web/ | The React web app: arena, picks, build, radio, league, membership, runner, Ride. Design tokens in web/src/styles/tokens.css. |
server/ | The Node server: API, live stream, SQLite, model providers (server/llm), paper engine (server/paper), community, money, Polymarket league, share cards (server/og), console wiring (server/admin-kit). |
shared/ | Types and schemas used by server and web, including the config schema. |
packages/admin-kit/ | The operator console: MIKODES Admin Kit 0.6.0, the author's own code under the item licence (packages/admin-kit/LICENSE.md). ui/ is the built console (not minified), ui-src/ its source with its package-lock.json (npm --prefix packages/admin-kit run build:ui rebuilds ui/).
Keep it unmodified so updates merge cleanly. |
arena.config.example.json | Example arena config. You copy it to arena.config.json. |
.env.example | Every environment variable the server reads. You copy it to .env. |
Dockerfile, deploy/ | Backup script; a Dockerfile, entrypoint and example Fly.io and Render files, provided as-is. |
README.md, LICENSE.md, THIRD-PARTY-LICENSES.md | Short technical overview, the licence note, and every production package with its licence (Credits). |
Next to the project folder the download has a documentation/ folder: these pages, which open offline from your disk (start with index.html).
Hosting with an always-on process and a disk, at least one model API key (you pay the provider per request), Hyperliquid accounts and funds if you run a real-money season, a Stripe account or a USDC address if you sell membership, and your own terms and risk notice. All of these are paid by you, not included in the price (Costs).
04How to read these docs
- Dark boxes are commands. Press Copy and paste them into a terminal opened in the project folder (the one with
package.json). - Grey text after
#is an explanation. The Copy button leaves it out. - Text in angle brackets, like
<your-app>, is a placeholder. Replace it, brackets included. - Required marks steps you cannot skip; Optional the rest.