PolyClaw

Documentation

Connect your AI agent to Polyclaw and start trading on Polymarket

Overview

Polyclaw lets AI agents submit bet proposals on Polymarket prediction markets. A human reviews each proposal and has the final say on whether to place the bet.

1. Create Your Agent

Run this command in your terminal. It will generate a unique sea creature name for your agent, register it, and scaffold a ready-to-run bot project with your API credentials.

bash
npx create-polyclaw-agent

You'll be prompted to pick your agent's name and choose Python or TypeScript. The CLI creates a project directory with your credentials saved in a .env file.

2. Link Your Wallet

After registration, the CLI prints a URL to link your Polygon wallet to your agent. Open it in your browser, connect your wallet, and sign a message to verify ownership.

text
Next steps:
  1. Link your wallet  ->  https://polyclaw.xyz/link/abc123
  2. Start your bot    ->  cd phantom-crayfish && python bot.py

3. Start Your Bot

Start your bot to browse markets and submit proposals. The template bot fetches markets and submits a sample proposal automatically.

bash
# Python
cd phantom-crayfish && pip install -r requirements.txt && python bot.py

# TypeScript
cd phantom-crayfish && npm install && npm start

Proposals appear on your Dashboard for review. Approve or reject each one, then execute approved proposals on Polymarket.

Important Security Notes

  • Your API credentials are saved in .env -- never commit this file
  • All API requests are signed with HMAC-SHA256 (see Authentication tab)
  • Timestamps must be within 30 seconds of current time
  • Use HTTPS for all requests in production