explaingit

codexbt/poly-claw-bot

Analysis updated 2026-05-18

11PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

An automated Python trading suite for Polymarket and sports markets, using an LLM to score trade confidence before executing.

Mindmap

mindmap
  root((repo))
    What it does
      Automated market trading
      LLM signal validation
      Paper trading mode
    Tech stack
      Python
      OpenRouter LLM API
      dotenv config
    Use cases
      Automate Polymarket trades
      Scan sports betting markets
      Test strategies risk free
    Audience
      Traders
      Developers exploring trading bots
      Prediction market users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an automated momentum trading strategy on Polymarket.

USE CASE 2

Scan sports markets for trading opportunities without manual monitoring.

USE CASE 3

Validate trade signals with an LLM confidence score before executing.

USE CASE 4

Test strategies in paper trading mode before risking real funds.

What is it built with?

PythonOpenRouterdotenv

How does it compare?

codexbt/poly-claw-bot2arons/llm-cliadzza/guardium-dns
Stars111111
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires API keys and a private key for live trading, stored in a .env file, paper mode needs no real funds.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Poly Claw Bot is an AI-powered automated trading suite written in Python, designed for use on prediction markets and sports betting markets. The description mentions Polymarket specifically, which is a platform where users trade on the outcome of real-world events. Instead of placing trades manually, this bot monitors markets, applies predefined strategies, and executes trades on your behalf. The suite includes several distinct bots with different approaches. One runs a momentum strategy on Polymarket, scanning for price moves and volume triggers every five minutes. Another focuses on sports markets, scanning for trading opportunities in sports outcomes. A third handles arbitrage, looking for price differences to exploit across positions. Each bot runs as a separate Python script, and they can run in parallel so multiple strategies operate simultaneously. What makes it "AI-powered" is the integration with an LLM (large language model) through an external API. The LLM is used to score the confidence of trade signals before the bot acts on them, adding a validation layer on top of the rule-based strategy logic. Configuration is handled entirely through environment variables stored in a .env file, keeping credentials like private keys and API keys out of the code. The README emphasizes a paper trading mode, which lets you simulate trades without real money, recommended for testing before going live. You would use this if you wanted to automate trading on Polymarket or sports markets, particularly combining momentum strategies with AI-assisted signal validation. It is built with Python 3.10 or above and licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through setting up the .env file to run this bot in paper trading mode.
Prompt 2
Explain how the LLM confidence scoring works before a trade is executed.
Prompt 3
Show me how the momentum bot and the arbitrage bot differ in their strategy logic.
Prompt 4
Help me run multiple bots from this repo in parallel safely.

Frequently asked questions

What is poly-claw-bot?

An automated Python trading suite for Polymarket and sports markets, using an LLM to score trade confidence before executing.

What language is poly-claw-bot written in?

Mainly Python. The stack also includes Python, OpenRouter, dotenv.

What license does poly-claw-bot use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is poly-claw-bot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is poly-claw-bot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.