Developers

PredCopy for AI agents and scripts

REST API with Bearer auth. MCP server for Claude Desktop and Cursor. llms.txt and markdown docs. Give your agent the keys to PredCopy and let it discover Polymarket whales and copy them on your behalf.

PredCopy is agent-callable end-to-end. Generate an API key from the dashboard, point an MCP-compatible client at it, and your agent can list top whales, inspect their positions, and start copy-trading them with a single prompt. All write actions accept the same Bearer token the dashboard uses.

REST

/api endpoints

Every endpoint the dashboard uses, callable with Authorization: Bearer pc_….

MCP

Remote MCP server

Hosted at /api/mcp. 30-second setup →

LLM docs

llms.txt & docs.md

llms.txt nav, docs.md full guide.

Quick start (REST)

Generate a personal API key at /dashboard/settings (one click, shown once, sha256-hashed in our DB). Then:

bash

# 1. Add a wallet to your watchlist
curl -X POST https://predcopy.com/api/wallets \
  -H "Authorization: Bearer pc_xxx" \
  -H "Content-Type: application/json" \
  -d '{"address":"0xfedc381bf3fb5d20433bb4a0216b15dbbc5c6398","label":"Politics whale"}'

# 2. Start copying in paper mode at 5% bet size, max $20 per trade
curl -X POST https://predcopy.com/api/copy \
  -H "Authorization: Bearer pc_xxx" \
  -H "Content-Type: application/json" \
  -d '{"walletId":"<id from step 1>","action":"start","settings":{"isPaper":true,"betPct":0.05,"maxBetUsd":20}}'

# 3. Read your open positions
curl https://predcopy.com/api/pnl/positions \
  -H "Authorization: Bearer pc_xxx"

Quick start (MCP)

Plug PredCopy into Claude Desktop, Cursor, or any MCP-compatible client. The server is hosted at https://predcopy.com/api/mcp. No install, no npm. Add the URL plus your API key:

json

{
  "mcpServers": {
    "predcopy": {
      "url": "https://predcopy.com/api/mcp",
      "headers": {
        "Authorization": "Bearer pc_xxx"
      }
    }
  }
}

Full setup instructions at predcopy.com/mcp.

Endpoint reference

Method	Path	Purpose
GET	/api/wallets	List the user's watched wallets
POST	/api/wallets	Add a wallet to the watchlist
DELETE	/api/wallets?id=…	Remove a watched wallet
POST	/api/copy	Start or stop copying a wallet
POST	/api/baskets	Create a basket (group of wallets)
GET	/api/baskets	List baskets with their member wallets
POST	/api/baskets/[id]/copy	Apply shared copy settings to a basket
GET	/api/pnl	Per-wallet closed-trade P&L attribution
GET	/api/pnl/positions	Open positions with unrealized P&L
GET	/api/wallet-activity?address=	Last-24h activity + market-maker flag (public, no auth)
GET	/api/engine-health	Engine liveness (public, no auth)
POST	/api/account/api-key	Generate or rotate the user's API key
POST	/api/mcp	Model Context Protocol endpoint (JSON-RPC 2.0). Add to Claude Desktop / Cursor.

Reading from PredCopy without auth

The public site is the read API. Every page renders structured data alongside the HTML. Agents can scrape /leaderboard, /best-traders/[category], /trader/[address], and /market/[slug] with no key. The /api/wallet-activity endpoint is public too and returns a JSON market-maker classification per address.

Questions? Email [email protected] or open support from the dashboard.