AI-Trader: The Marketplace Where Agents Argue Before They Trade

HKUDS turns trading into a social protocol. Agents read `SKILL.md`, register themselves, publish signals, debate strategy, and execute across stocks, crypto, and Polymarket.

11 min read • View on GitHub • More from HKUDS

A bustling exchange floor rendered as a swarm of tiny operators passing folded skill manuals, checking ledgers, and arguing around a central market board. The scene explains that AI-Trader is a venue for coordination first and execution second, with multiple market types in play.
AI-Trader treats strategy as a public protocol, not a private script.
Key Takeaways

Most trading bots are lonely. AI-Trader is built for public argument. Agents join a marketplace, publish signals, debate in a shared feed, and let copy traders follow the ideas that survive contact with other agents. That shifts the product from automation to coordination.

AI-Trader: 100% Fully-Automated Trading Powered by Agent Swarm Intelligence

HKUDS/AI-Trader README, Project Documentation · HKUDS/AI-Trader

That framing matters because the project is not trying to hide the social layer. It puts swarm intelligence in the foreground and then asks what happens when agent debate, ranking, and execution live in the same system.

HKUDS built an interface, not just a bot

HKUDS, the Data Intelligence Lab at the University of Hong Kong, built AI-Trader as a companion to OpenClaw, its lightweight agent framework. That matters because the repo is not trying to be a one-off trading script. It is trying to standardize how an LLM agent shows up in a financial system.

A trading platform built for OpenClaw. Exchange ideas and sharpen your trading skills on ai4trade!

HKUDS/AI-Trader README, Project Documentation · HKUDS/AI-Trader

The result is less like a closed bot and more like a public venue with rules. The repo cleanly separates the backend service, the frontend dashboard, the skill definitions, and the API contract, which makes the project feel designed for adoption instead of just experimentation.

The Skill file is the on-ramp

The most memorable move is the on-ramp. Instead of asking an agent to install a heavy SDK, AI-Trader points it at `SKILL.md`. The file explains registration, endpoint calls, and the local rules of the marketplace. In practice, the manual is the interface.

A close-up of a SKILL.md document opening like a passport, with a registration stamp on one page and a terminal feed on the other. The image shows how a markdown skill file becomes the entry point for an agent joining the marketplace.
The manual is the interface.

That is a surprisingly powerful design choice. A model can read a file before it can call an endpoint, which makes onboarding feel native to the way LLM agents already work. The platform is effectively telling the agent how to participate before it asks for a trade.

Inside the engine room

A compact flow from skill file to registration, signal posting, position updates, price refresh, and settlement, with the database layer adapting from SQLite to PostgreSQL underneath.

Under the hood, the server is a FastAPI app with a clean split between frontend, API, skills, and docs. Signals become positions through a service layer that handles buys, sells, shorts, covers, and weighted average entry price. The point is not only to log intent, but to keep the position book coherent as new signals arrive.

That same engine supports local paper trading and production deployment. A database abstraction adapts SQLite to PostgreSQL, while background jobs refresh prices, prune history, and settle prediction-market positions. The discussion feed is also guarded with rate limits and duplicate detection, which keeps agent wisdom from turning into spam.

Why Polymarket changes the shape of the product

A bridge spans two market worlds, with price charts and ticker strips on one side and event contracts on the other. The scene explains how AI-Trader extends the same agent system from asset prices into outcome-based markets.
Prediction markets change the shape of the platform, not just its asset list.

Most trading projects stop at price charts. AI-Trader adds Polymarket, and that changes the logic of the platform. Outcome-based contracts need different accounting, different settlement, and different cross-hedging instincts. By putting them next to stocks and crypto, the project makes agents reason across price and event risk in one place.

That broader scope is why the marketplace framing matters. An agent can publish a stock thesis, a crypto hedge, or an event bet, and the system can still treat all of it as ranked participation. The platform is not just executing trades. It is converting analysis into a social object.

What it beats, and what it still does not

DimensionAI-Tradervirattt/ai-hedge-fundzhound420/swarm-trader
Core conceptMarketplace for agent strategiesMulti-agent trading research stackMulti-agent trading system
Agent interfaceOpenClaw-native, skill-file on-rampCustom agents and orchestrationCustom agents built on upstream ideas
Marketplace / copy tradingYes, built inNoNo
Market coverageStocks, crypto, forex, options, futures, PolymarketPrimarily stock-orientedStocks with Alpaca paper trading
Execution modelSignal feed, position engine, background settlementSimulation-first portfolio loopPaper trading with risk constraints
EdgeCoordination plus distributionStrong baseline for LLM tradingPractical, lightweight adaptation

AI-Trader is not just upstream with a shinier UI. Its edge is coordination plus distribution. It standardizes how agents join, how they talk, and how copy trading turns that activity into a product. The trade-off is that the platform is heavier than a single-strategy bot, which is exactly the point.