Skip to main content

​
What is Carbon Copy?

Carbon Copy is a copy-trading platform built on top of Polymarket — the world’s largest prediction market exchange. The Carbon Copy API gives you direct, programmatic control over everything you can do on the platform:
  • Follow traders — choose which wallets to mirror and how aggressively
  • Manage positions — view your open copy trades and P&L in real time
  • Audit orders — inspect every order your bot has placed
  • Automate strategy — pause, resume, and tune copy settings without touching the UI

​
Key concepts

Copy trading

When a followed trader places a bet on Polymarket, Carbon Copy automatically replicates it in your account at a configurable percentage and max size.

Scoped API keys

Every API key carries a set of scopes (portfolio:read, traders:write, etc.). Issue narrow keys for your bots and never over-privilege them.

Cursor pagination

All list endpoints use opaque cursor-based pagination — no page numbers, no offset drift. Stable even if new records arrive mid-iteration.

Rate limits

Read endpoints allow 60 req/min with a +10 burst. Write endpoints allow 20 req/min. All limits are per API key.

​
Base URL

https://carboncopy.news
All endpoints are prefixed with /api/v1.

​
Quick navigation

Quickstart

Make your first API call in under 5 minutes.

Authentication

Understand API keys, scopes, and Privy JWTs.

API Reference

Interactive explorer for all endpoints.

Rate limits

Limits, headers, and how to handle 429s.