Skip to main content

​
Overview

List endpoints return results in pages. Each response includes:
FieldTypeDescription
pagearrayThe records for this page
continueCursorstring | nullPass this as cursor in the next request. null when there are no more pages.
isDonebooleantrue when this is the last page

​
Query parameters

ParameterTypeDefaultDescription
limitinteger50Records per page (1–100)
cursorstring—Cursor from previous response
sinceinteger—Unix timestamp (ms) — include records at or after this time
untilinteger—Unix timestamp (ms) — include records before this time

​
Basic example

First page: 
curl "https://carboncopy.news/api/v1/portfolio/history?limit=50" \
  -H "Authorization: Bearer $CC_API_KEY"

{
  "page": [ ... ],
  "continueCursor": "eyJpZCI6Imsx...",
  "isDone": false
}
Next page — pass continueCursor as cursor: 
curl "https://carboncopy.news/api/v1/portfolio/history?limit=50&cursor=eyJpZCI6Imsx..." \
  -H "Authorization: Bearer $CC_API_KEY"

{
  "page": [ ... ],
  "continueCursor": null,
  "isDone": true
}
When isDone is true (or continueCursor is null), you’ve consumed all pages.

​
Iterating all pages

​
Python

import requests

def fetch_all(endpoint, api_key, **params):
    headers = {"Authorization": f"Bearer {api_key}"}
    cursor = None
    results = []

    while True:
        query = {**params, "limit": 100}
        if cursor:
            query["cursor"] = cursor

        response = requests.get(endpoint, headers=headers, params=query)
        response.raise_for_status()
        data = response.json()

        results.extend(data["page"])

        if data["isDone"] or not data.get("continueCursor"):
            break

        cursor = data["continueCursor"]

    return results

# Example
trades = fetch_all(
    "https://carboncopy.news/api/v1/portfolio/history",
    api_key="cc_your_key_here",
    since=1741000000000,
)
print(f"Fetched {len(trades)} trades")

​
TypeScript

interface PaginatedResponse<T> {
  page: T[];
  continueCursor: string | null;
  isDone: boolean;
}

async function fetchAll<T>(
  endpoint: string,
  apiKey: string,
  params: Record<string, string | number> = {}
): Promise<T[]> {
  const results: T[] = [];
  let cursor: string | null = null;

  do {
    const url = new URL(endpoint);
    url.searchParams.set("limit", "100");
    for (const [k, v] of Object.entries(params)) {
      url.searchParams.set(k, String(v));
    }
    if (cursor) url.searchParams.set("cursor", cursor);

    const res = await fetch(url.toString(), {
      headers: { Authorization: `Bearer ${apiKey}` },
    });

    if (!res.ok) throw new Error(`HTTP ${res.status}`);

    const data: PaginatedResponse<T> = await res.json();
    results.push(...data.page);
    cursor = data.continueCursor;
  } while (cursor !== null);

  return results;
}

// Example
const trades = await fetchAll(
  "https://carboncopy.news/api/v1/portfolio/history",
  "cc_your_key_here",
  { since: 1741000000000 }
);

​
Time-range filtering

Use since and until to fetch a specific window without iterating your entire history: 
# All trades in the last 7 days
NOW=$(date +%s%3N)
SEVEN_DAYS_AGO=$((NOW - 7 * 24 * 60 * 60 * 1000))

curl "https://carboncopy.news/api/v1/portfolio/history?since=${SEVEN_DAYS_AGO}&limit=100" \
  -H "Authorization: Bearer $CC_API_KEY"
For production polling, store the continueCursor from your last run and resume from there rather than re-fetching everything.

​
Notes on cursors

  • Cursors are opaque — don’t parse or modify them.
  • Cursors are stable — new records arriving during pagination won’t cause you to skip or re-see existing records.
  • Cursors may expire after a period of inactivity. If you receive a 400 bad_request error on a cursor, start a fresh request from the beginning.