polymarket-arbitrage-bot — Claude Code skill: setup & guide
polymarket-arbitrage-bot automates dump-and-hedge strategies on Polymarket 15-minute Up/Down crypto markets. Helps configure TypeScript trading bots, manage CLOB orders, and test without real capital.
no license 815 installs ★ 98 updated 2026-10-09
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a claude-codeWhat polymarket-arbitrage-bot does
This skill provides architecture patterns and code templates for a TypeScript bot targeting Polymarket short-term binary markets across BTC, ETH, SOL, and XRP. The core strategy detects rapid price drops on one outcome, enters the first leg at the ask, and hedges by buying the opposite side whenever the total cost remains under the profit target.
The system polls Gamma API endpoints to resolve the active 15-minute market window and coordinates orderbook monitoring with CLOB order routing. Code organization cleanly separates market discovery, orderbook polling loops, stop-loss wait timers, and settlement logging.
Live order execution demands PRIVATE_KEY and PROXY_WALLET_ADDRESS configured in .env. Running npm run sim first is critical because unexpected volatility can leave the first leg unhedged if the opposite token fails to meet the target price.
What it helps with
- automate dump-and-hedge execution on Polymarket 15-minute contracts
- wire TypeScript clients to Gamma and CLOB API endpoints
- evaluate trading parameters in simulation mode before committing funds
- configure stop-loss intervals and price drop thresholds
Example prompts for the agent
- Set up the .env configuration for polymarket-arbitrage-bot to trade SOL markets
- Explain the two-leg hedge logic inside dumpHedgeTrader.ts
- Run polymarket-arbitrage-bot in simulation mode to verify orderbook polling
How to install polymarket-arbitrage-bot
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a claude-code2Manually: put the files in place
~/.claude/skills/polymarket-arbitrage-bot/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/polymarket-arbitrage-bot/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a codex2Manually: put the files in place
.agents/skills/polymarket-arbitrage-bot/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a cursor2Manually: put the files in place
.cursor/skills/polymarket-arbitrage-bot/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills skills/polymarket-arbitrage-bot2Manually: put the files in place
.github/skills/polymarket-arbitrage-bot/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/polymarket-arbitrage-botManually: put the files in place
.devin/skills/polymarket-arbitrage-bot/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about polymarket-arbitrage-bot
How do I install polymarket-arbitrage-bot in Claude Code?
Run npx skills add reason-machines/trending-skills --skill polymarket-arbitrage-bot -a claude-code. The skill file installs to ~/.claude/skills/polymarket-arbitrage-bot/SKILL.md.
What does polymarket-arbitrage-bot do?
It guides the creation and execution of an automated TypeScript bot on Polymarket. The bot monitors 15-minute binary markets to capture arbitrage opportunities across price dips.
Does the bot trade real funds by default?
No, it starts in simulation mode by default. Real orders require setting PRODUCTION=true and supplying valid wallet keys in .env.