Skip to main content
GET
/
api
/
v1
/
portfolio
/
trades
List copy trade history (alias)
curl --request GET \
  --url https://carboncopy.inc/api/v1/portfolio/trades \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "items": [
      {
        "id": "k17abc123def456",
        "traderWallet": "0xAbCd1234...",
        "marketId": "0x1234abcd...",
        "side": "YES",
        "amount": 50,
        "status": "open",
        "createdAt": 1741550000000,
        "marketQuestion": "Will BTC exceed $100k by end of 2025?",
        "price": 0.62,
        "pnl": 12.5
      }
    ],
    "nextCursor": "<string>",
    "hasMore": true
  },
  "meta": {
    "requestId": "cf7301af-0c1e-4354-85a8-9153db69ae6d",
    "timestamp": 1741600000000
  }
}

Authorizations

Authorization
string
header
required

API key in the format cc_<64 hex characters>. Obtain from the Dashboard under Settings → API Keys.

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string
since
integer

Unix ms — filter trades on or after this time.

until
integer

Unix ms — filter trades before this time.

Response

Paginated copy trade history.

data
object
meta
object