Agent skill · software engineering · aradotso
polymarket-arbitrage-bot
TypeScript bot implementing dump-and-hedge arbitrage strategy on Polymarket 15-minute Up/Down prediction markets with CLOB order execution and simulation mode.
Why this skill is useful
Adds a TypeScript bot with executable scripts for automating a complex arbitrage strategy on Polymarket that the AI cannot generate on its own.
What it needs
Requires git, npm installed locally. Requires polymarket account access. About 9k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Polymarket Arbitrage Bot Skill by ara.so — Daily 2026 Skills collection. TypeScript bot automating the dump-and-hedge strategy on Polymarket's 15-minute Up/Down markets (BTC, ETH, SOL, XRP). Detects sharp price drops, buys the dipped side, then hedges the opposite outcome when combined cost falls below a profit threshold. Installation Key Commands Command Description --------- ------------- npm start Run compiled bot (simulation by default) npm run sim Explicitly run in simulation (no real orders) npm run prod Run with real trades (PRODUCTION=true) npm run dev Run TypeScript directly via ts-node npm run build Compile TypeScript to dist/ Always test with npm run sim before enabling production mode. Project Structure Environment Configuration Create .env from .env.example: Core Types (models.ts) Strategy Flow Code Examples Loading and using config (config.ts pattern) Fetching market via Gamma API (api.ts pattern) Fetching orderbook from CLOB (api.ts pattern) Dump detection logic (dumpHedgeTrader.ts pattern) Placing an order via CLOB (api.ts pattern) Monitor loop (monitor.ts pattern) History logging (logger.ts pattern) Main entry pattern (main.ts) Common Patterns Multi-asset configuration Tuning for volatile markets Switching simulation → production Using EOA wallet (no proxy) Using GnosisSafe proxy (default Polymarket setup) Profit Mechanics Troubleshooting Problem Cause Fix --------- ------- ----- No markets found Wrong slug/timing Check GAMMAAPIURL connectivity; confirm asset name is lowercase Orders fail in production Bad credentials Verify PRIVATEKEY, PROXYWALLETADDRESS, SIGNATURETYPE Redemption fails Insufficient POL gas Fund wallet with POL/MATIC on Polygon mainnet No dumps detected Threshold too high Lower DUMPHEDGEMOVETHRESHOLD (e.g. 0.10) or extend window Strategy never hedges Sum target too tight Raise DUMPHEDGESUMTARGET (e.g. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/polymarket-arbitrage-bot