Polymarket Agents

Overview

Polymarket Agents is a developer framework for building AI agents that trade autonomously on Polymarket prediction markets. The framework provides modular components for market data retrieval, order execution, and AI-driven decision-making.

Architecture

The system features modular APIs and connectors:

• Gamma API Client: Fetches and parses market and event metadata from Polymarket Gamma API
• Polymarket API Client: Retrieves market data, manages events, and executes trades on the Polymarket DEX
• Chroma Integration: Vector database for storing and querying news sources and API data
• Data Models: Pydantic-based representations for trades, markets, events, and related entities

Data Sourcing

Agents leverage retrieval-augmented generation (RAG) to inform trading decisions. The framework supports:

• Local and remote RAG implementations
• News provider integration
• Betting service data
• Web search capabilities
• Vector storage via Chroma for efficient retrieval

Command Line Interface

The CLI (cli.py) provides commands for market queries, news retrieval, LLM interactions, and trade execution. Example: get-all-markets retrieves markets sorted by volume with configurable limits.

Deployment

Supports local Python execution or Docker-based deployment. Requires Python 3.9, a funded USDC wallet on Polygon, and API keys for OpenAI and Polymarket services.