API Reference

The PolyCopyBot REST API gives you full programmatic control over the platform. All endpoints return JSON, accept JSON request bodies, and authenticate via a Bearer token in the Authorization header.

PolyCopyBot uses Bearer token authentication. Generate your API key from the Dashboard → Settings → API Keys tab. Include it in every request header.

# Pass your API key as a Bearer token in the Authorization header
curl -X GET "https://api.polycopybot.app/v1/wallets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

const API_KEY = 'YOUR_API_KEY';

const res = await fetch('https://api.polycopybot.app/v1/wallets', {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type':  'application/json'
  }
});
const data = await res.json();
console.log(data);

import requests

API_KEY = "YOUR_API_KEY"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type":  "application/json"
}

response = requests.get(
    "https://api.polycopybot.app/v1/wallets",
    headers=headers
)
data = response.json()
print(data)

<?php
$apiKey = 'YOUR_API_KEY';

$ch = curl_init('https://api.polycopybot.app/v1/wallets');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {$apiKey}",
        'Content-Type: application/json'
    ],
    CURLOPT_RETURNTRANSFER => true
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Requests are throttled per API key per plan. Exceeding the limit returns HTTP 429 Too Many Requests with a Retry-After header indicating seconds to wait.

Rate limit headers are returned with every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix timestamp).

PolyCopyBot uses conventional HTTP response codes. Errors include a machine-readable code string and a human-readable message.

Query the PolyCopyBot-tracked wallet database. Filter by score, ROI, win-rate and more. Used internally by the dashboard leaderboard.

Start, stop and configure your copy-trading bot programmatically. Bot endpoints require an active subscription.

Inspect and manage orders placed by your bot. Orders represent individual copy trades executed on Polymarket.

Aggregate view of your copy-trading account: balances, PnL, performance over time.

Retrieve active plan details, limits and expiry for the authenticated API key's account.

Stream real-time events from your bot and the wallet tracker. The WebSocket endpoint is available on Pro and Enterprise plans.

Subscribe to channels

const ws = new WebSocket('wss://ws.polycopybot.app/v1?token=YOUR_API_KEY');

ws.onopen = () => {
  // Subscribe to bot events and live wallet feed
  ws.send(JSON.stringify({
    type:     'subscribe',
    channels: ['bot.events', 'wallet.trades']
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log(msg.type, msg.data);
};

import asyncio, websockets, json

async def main():
    url = "wss://ws.polycopybot.app/v1?token=YOUR_API_KEY"
    async with websockets.connect(url) as ws:
        await ws.send(json.dumps({
            "type": "subscribe",
            "channels": ["bot.events", "wallet.trades"]
        }))
        async for msg in ws:
            print(json.loads(msg))

asyncio.run(main())

Available Channels

Official client libraries to get started faster. Community SDKs welcome — open a PR on GitHub.

Quick install

npm install @polycopybot/sdk

pip install polycopybot

composer require polycopybot/sdk

API version history and release notes. Breaking changes are announced 30 days in advance.