Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/chainstacklabs/polymarket-alpha-bot/claude-mdgit clone --depth 1 https://github.com/chainstacklabs/polymarket-alpha-botWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.01300 | $0.01300 |
| Opus 5 | $0.00650 | $0.00650 |
| Sonnet 5 | $0.00260 | $0.00260 |
| Haiku 4.5 | $0.00130 | $0.00130 |
Grade A, and why
polymarket-alpha-bot CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 114 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
Polymarket alpha detection platform. LLM pipeline groups related markets, extracts logical implications, and builds covering portfolios (hedged positions via contrapositive logic). Next.js dashboard with real-time price tracking and position management.
Trades against Polymarket V2 (pUSD collateral, official polymarket-client SDK, EIP-712 domain version "2") via per-user deposit wallets (signature type 3): each user supplies an EOA key + a Relayer API key, the deposit wallet is deployed gaslessly, and the relayer pays gas. Legacy V1 was retired on 2026-04-28; for archaeology see the v1-final git tag.
Commands
# Development
make install # Install all deps (uv sync + npm install)
make dev # Start backend (:8000) + frontend (:3000)
make backend # Backend only
make frontend # Frontend only
make stop # Kill dev servers
# Pipeline
make pipeline # Run ML pipeline (incremental)
make pipeline-full # Full reprocess from scratch
# Seed Data
make export-seed # Export current state as seed
make import-seed # Import seed data (resets DB)
# Quality
make lint # Auto-fix: ruff (backend) + prettier + eslint (frontend)
cd frontend && npm run typecheck # TypeScript check (not in Makefile)
Critical Rules
- Use
uvexclusively — never pip, never conda - Use
polars— never pandas - Experiments are independent — no imports from
backend/ - Run backend Python from
backend/—cd backend && uv run ... load_dotenv()before imports inserver/main.py(E402 ignored by ruff for this file)
Project Structure
backend/
├── core/ # Pipeline: runner.py, state.py, steps/, positions/, trading/, wallet/
└── server/ # FastAPI: main.py, routers/, WebSocket services
frontend/
├── app/ # Pages: /, /portfolios, /positions, /terminal
├── components/ # React components (positions/, terminal/)
├── hooks/ # Custom hooks (prices, keyboard, wallet, favorites)
├── server.js # Custom Next.js server with WebSocket proxy
└── config/ # API URL resolution, tier display settings
experiments/ # Standalone scripts (no shared modules)
data/ # Pipeline outputs (gitignored)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 114 lines · 1,300 tokens per session scan A 02a00166c3b6
polymarket-alpha-bot CLAUDE.md is an instructions file published in the GitHub repository chainstacklabs/polymarket-alpha-bot (172 stars, last pushed 27d ago), licensed Apache-2.0. It adds 1,300 tokens to every session, about $0.0065 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
pumpfun-bonkfun-bot CLAUDE.md
Instructions for chainstacklabs/pumpfun-bonkfun-bot, covering agent guide, ground rules, layout, naming inside learning-examples/ and commands.
alpaca-trade-api-js AGENTS.md
Instructions for alpacahq/alpaca-trade-api-js, covering agents.md, conventions, commands, releases & changelog (changesets) and automated release flow on master.
tradememory-protocol AGENTS.md
Instructions for mnemox-ai/tradememory-protocol, covering tradememory protocol — agent context, project rules, recent changes and current status.
kalshi-trading-bot-cli CLAUDE.md
Instructions for OctagonAI/kalshi-trading-bot-cli, covering claude.md and workflow.
LLM-TradeBot client.instructions.md
Instructions for EthanAlgoX/LLM-TradeBot, a project described as: A multi-agent AI trading system using LLMs to optimize strategies and adapt to market conditions in real-time.
ohlcv CLAUDE.md
Instructions for Mario-SO/ohlcv, covering claude.md, project overview, build and development commands, core commands and build the library and demo.