REST API for corporate BTC, ETH & SOL treasuries

Total holdings, current USD value, cost basis, unrealized profit/loss, and entity count across the tracked universe (companies, ETFs, and governments combined). The token block carries the asset details: ticker, the unit it is displayed in, its maximum supply (for Bitcoin), and the live spot price used for the USD value.

{
  "data": {
    "token": {
      "id": "bitcoin",
      "symbol": "BTC",
      "display_unit": "BTC",
      "supply_cap": 21000000,
      "price_usd": 83512.44
    },
    "entity_count": 248,
    "total_holdings": 3830257,
    "total_usd_value": 319920000000,
    "total_cost_basis": 241020000000,
    "unrealized_pnl": 78900000000,
    "avg_cost_basis_usd": 62925,
    "total_purchases": 7086,
    "most_recent_purchase": "2026-04-13"
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…", "token": "bitcoin" }
}

Full list of tracked entities (public companies, private companies, ETFs, and governments) with holdings, cost basis, treasury rank, and verification metadata. Sorted by holdings descending — rank is the absolute leaderboard position. Each row carries how its figure was verified (source_tier + a click-through source_citation_url, data_confidence, and the coverage_class plus a plain-English reason) so you can sort or filter the leaderboard by trust without a second call. Use entity_type to pull a single segment (e.g. just ETFs or just governments).

{
  "data": [
    {
      "id": "uuid",
      "ticker": "MSTR",
      "name": "Strategy",
      "slug": "microstrategy",
      "country": "US",
      "flag_emoji": "🇺🇸",
      "logo_domain": "strategy.com",
      "logo_initial": "S",
      "entity_type": "public_company",
      "sec_cik": "0001050446",
      "website": "https://strategy.com",
      "rank": 1,
      "btc_holdings": 818869,
      "avg_price_usd": 75577,
      "total_cost_usd": 59013000000,
      "last_purchase": "2026-04-13",
      "source_tier": "primary",
      "source_citation_url": "https://www.sec.gov/cgi-bin/browse-edgar?...",
      "data_confidence": "high",
      "coverage_class": "verified_events_sec",
      "coverage_class_reason": "Every position change is backed by an SEC filing."
    }
  ],
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…", "total": 248, "limit": 100, "offset": 0, "token": "bitcoin", "entity_type": "all" }
}

Everything we hold on one entity: holdings + cost basis (token-native amount, amount_usd, avg cost, total cost), analyst metrics (mNAV, sats/share, % of market cap, debt-to-coin, enterprise value — see /market for the spot price they use), full verification metadata (source_tier + source_citation_url, the data_confidence block with its computed tier / matching sources / any operator override, and coverage_class with a plain-English reason), and up to the last 100 discrete treasury events. Each event carries its primary-source citation (filing_url + sec_accession), the SEC filing date, and an AI one-line summary. Replace {slug} in the path with the slug from /treasuries. Pass ?token= (Pro+) to read a non-primary asset for the same entity.

{
  "data": {
    "ticker": "MSTR",
    "name": "Strategy",
    "sec_cik": "0001050446",
    "website": "https://strategy.com",
    "btc_holdings": 818869,
    "avg_price_usd": 75577,
    "total_cost_usd": 59013000000,
    "token": { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin" },
    "amount": 818869,
    "amount_usd": 68390000000,
    "source_tier": "primary",
    "source_citation_url": "https://www.sec.gov/cgi-bin/browse-edgar?...",
    "coverage_class": "verified_events_sec",
    "coverage_class_reason": "Every position change is backed by an SEC filing.",
    "metrics": {
      "mnav": 1.42, "satsPerShare": 1820, "btcPctOfMcap": 70.4,
      "debtToBtcRatio": 0.12, "enterpriseValueUsd": 102400000000, "btcValueUsd": 68390000000
    },
    "data_quality": { "tier": "verified", "verified_rows": 98, "total_rows": 100 },
    "data_confidence": {
      "tier": "high", "computed_tier": "high",
      "sources": ["bitbo", "coingecko", "bitcointreasuries"],
      "updated_at": "2026-04-19T06:00:00Z", "operator_override": null
    },
    "purchases": [
      {
        "id": "uuid", "token": "bitcoin", "amount": 13927, "btc_amount": 13927,
        "usd_amount": 1001000000, "price_per_unit": 71870, "price_per_btc": 71870,
        "purchase_date": "2026-04-13", "filing_date": "2026-04-14",
        "total_holdings_after": 818869, "source": "sec_edgar",
        "filing_url": "https://www.sec.gov/Archives/edgar/...",
        "sec_accession": "0000950170-26-000123",
        "summary": "Strategy disclosed a purchase of 13,927 BTC for about $1.0B."
      }
    ]
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…", "token": "bitcoin" }
}

Global feed of recent treasury events across every tracked entity. Includes both buys (positive amount) and sells (negative amount, e.g. ETF daily outflows). Each row is a discrete, citable disclosure and ships with its primary source: filing_url + sec_accession (resolve at sec.gov), the SEC filing_date, and an AI one-line summary. Note: governments report their holdings as official headline figures, not as individual dated transactions, so filtering this feed to a government returns an empty list — that is by design, not a gap. The current government position is on /treasuries/{slug}.

{
  "data": [
    {
      "id": "abc-123",
      "token_id": "bitcoin",
      "amount": 13927,
      "btc_amount": 13927,
      "usd_amount": 1001000000,
      "price_per_btc": 71870,
      "purchase_date": "2026-04-13",
      "filing_date": "2026-04-14",
      "total_holdings_after": 818869,
      "source": "sec_edgar",
      "sec_accession": "0000950170-26-000123",
      "filing_url": "https://sec.gov/...",
      "summary": "Strategy disclosed a purchase of 13,927 BTC for about $1.0B.",
      "company": {
        "ticker": "MSTR",
        "name": "Strategy",
        "slug": "microstrategy",
        "country": "US",
        "flag_emoji": "🇺🇸",
        "logo_domain": "strategy.com",
        "logo_initial": "S"
      }
    }
  ],
  "meta": { "total": 3450, "limit": 50, "offset": 0, "token": "bitcoin", "entity_type": "all" }
}

Latest prices for the tracked tokens, plus global market cap, 24h volume, BTC/ETH dominance, and the Fear & Greed index (value plus its text label, e.g. "Greed").

{
  "data": {
    "tokens": [
      { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "price_usd": 83512.44, "price_change_24h": -1.23, "market_cap": 1650000000000, "volume_24h": 42000000000, "market_cap_rank": 1 }
    ],
    "stats": {
      "total_market_cap": 3200000000000,
      "total_volume_24h": 180000000000,
      "btc_dominance": 58.2,
      "eth_dominance": 11.4,
      "active_coins": 12,
      "fear_greed_value": 62,
      "fear_greed_label": "Greed"
    }
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

List of tokens that have tracked treasury holdings. Pro+ unlocks non-bitcoin tokens.

{
  "data": [
    {
      "id": "bitcoin",
      "symbol": "BTC",
      "name": "Bitcoin",
      "display_unit": "BTC",
      "supply_cap": 21000000,
      "requires_pro_plus": false,
      "unlocked_for_key": true,
      "stats": { "entity_count": 248, "total_amount": 3830257, "total_cost_usd": 241020000000, "avg_cost_basis_usd": 62925, "most_recent_purchase": "2026-04-13" }
    },
    {
      "id": "ethereum",
      "symbol": "ETH",
      "name": "Ethereum",
      "requires_pro_plus": true,
      "unlocked_for_key": false,
      "stats": { "entity_count": 41, "total_amount": 4900000, "total_cost_usd": 14200000000, "avg_cost_basis_usd": 2898, "most_recent_purchase": "2026-04-11" }
    }
  ],
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

CSV or JSON bulk export of discrete treasury events (one row per disclosed buy/sell, with its per-(entity, token) data-confidence tier). Pro+ includes non-BTC tokens. Governments have no per-event rows here (their holdings are headline figures — use /treasuries).

# format=csv returns a raw download (no { data, meta } wrapper):
company,ticker,country,token_id,amount,usd_amount,price_per_unit,purchase_date,total_holdings_after,source,data_confidence_tier,data_confidence_sources
Strategy,MSTR,US,bitcoin,13927,1001000000,71870,2026-04-13,818869,sec_edgar,verified,sec_edgar
BlackRock iShares Bitcoin Trust,IBIT,US,bitcoin,5859,...

# format=json returns the same rows as a JSON array (raw, also unwrapped).

Live limits for the calling API key — how many requests you can make each minute and each month, how many you have left in each window, and when each window resets. Reset times are Unix timestamps (seconds).

{
  "data": {
    "plan": "pro_plus",
    "rate_limit": { "requests_per_minute": 300, "remaining": 297, "resets_at": 1745078460 },
    "quota": { "requests_per_month": 10000, "remaining": 9588, "resets_at": 1746057600 }
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

Reverse-chronological feed of treasury news and events: detected purchases and sales, newly disclosed adopters, capital raises, and executive changes. Pro+ also unlocks premium signals — live newswire coverage, ETF milestones, and large on-chain movements. Paginated by cursor: follow next_cursor while has_more is true.

{
  "data": {
    "items": [
      {
        "id": "uuid",
        "slug": "strategy-buys-13927-btc-2026-04-13",
        "token_id": "bitcoin",
        "company_id": "uuid",
        "signal_type": "purchase",
        "source_type": "sec_filing",
        "source_url": "https://www.sec.gov/Archives/edgar/...",
        "source_ref": "0000950170-26-000123",
        "headline": "Strategy adds 13,927 BTC",
        "summary": "Strategy disclosed a purchase of 13,927 BTC for about $1.0B.",
        "occurred_at": "2026-04-13T00:00:00Z",
        "ingested_at": "2026-04-13T13:42:00Z",
        "confidence": 0.98,
        "payload": {},
        "tier": "free"
      }
    ],
    "next_cursor": "2026-04-13T00:00:00Z",
    "has_more": true
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

One signal by its slug (from the feed). Premium signals are only visible to Pro+ keys; a Pro key requesting one gets a 404. Replace {slug} in the path.

{
  "data": {
    "id": "uuid",
    "slug": "strategy-buys-13927-btc-2026-04-13",
    "token_id": "bitcoin",
    "company_id": "uuid",
    "signal_type": "purchase",
    "source_type": "sec_filing",
    "source_url": "https://www.sec.gov/Archives/edgar/...",
    "source_ref": "0000950170-26-000123",
    "headline": "Strategy adds 13,927 BTC",
    "summary": "Strategy disclosed a purchase of 13,927 BTC for about $1.0B.",
    "occurred_at": "2026-04-13T00:00:00Z",
    "ingested_at": "2026-04-13T13:42:00Z",
    "confidence": 0.98,
    "payload": {},
    "tier": "free",
    "canonical_signal_id": null
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

Bulk download of the signals feed as CSV or newline-delimited JSON (JSONL). Same content rules as /signals — Pro+ keys also get the premium signals. Returns a raw file download, not the { data, meta } wrapper. Caps at 10,000 rows per call; narrow with since/until for larger pulls.

# format=csv (raw download, no { data, meta } wrapper):
id,slug,token_id,company_id,signal_type,source_type,source_url,source_ref,headline,summary,occurred_at,ingested_at,confidence,tier
uuid,strategy-buys-13927-btc-2026-04-13,bitcoin,uuid,purchase,sec_filing,https://www.sec.gov/...,0000950170-26-000123,"Strategy adds 13,927 BTC","Strategy disclosed a purchase…",2026-04-13T00:00:00Z,2026-04-13T13:42:00Z,0.98,free

# format=jsonl returns one JSON object per line (also a raw download).

Subscribe an HTTPS endpoint to one or more event types. The response includes the signing secret exactly once — store it now; later requests only return a masked preview. You can have up to 10 subscriptions per account. Subscribing to a premium signal event (newswire, ETF milestone, or on-chain movement) requires Pro+ or higher.

{
  "data": {
    "subscription": {
      "id": "uuid",
      "url": "https://your-app.example/corpstacking-webhook",
      "events": ["purchase.detected", "holding.updated"],
      "description": "prod pipeline",
      "active": true,
      "created_at": "2026-04-19T14:00:00Z",
      "secret": "whsec_cs_…",
      "secret_notice": "Store this secret now — it will not be shown again."
    }
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

List the subscriptions on your account. The signing secret is shown only as a masked preview here — the full value is returned just once, when you create the subscription.

{
  "data": {
    "subscriptions": [
      {
        "id": "uuid",
        "url": "https://your-app.example/corpstacking-webhook",
        "events": ["purchase.detected"],
        "secret": "whsec_cs_********",
        "description": "prod pipeline",
        "active": true,
        "paused_reason": null,
        "paused_at": null,
        "consecutive_failures": 0,
        "last_delivered_at": "2026-04-19T13:55:00Z",
        "created_at": "2026-04-19T14:00:00Z"
      }
    ]
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

Remove a subscription and its delivery history. Replace {id} with the subscription id from the list endpoint.

{
  "data": { "deleted": true, "id": "uuid" },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…" }
}

The delivery log for one subscription — every attempt, its status, the response code we got back, and any error. Useful for diagnosing a subscription that has stopped receiving events. Filter by status to see only failed deliveries.

{
  "data": {
    "events": [
      {
        "id": "uuid",
        "event_type": "purchase.detected",
        "event_id": "9f0c…e2a1",
        "status": "delivered",
        "attempts": 1,
        "last_attempt_at": "2026-04-19T14:00:01Z",
        "next_retry_at": null,
        "last_status_code": 200,
        "last_error": null,
        "created_at": "2026-04-19T14:00:00Z",
        "delivered_at": "2026-04-19T14:00:01Z"
      }
    ]
  },
  "meta": { "timestamp": "2026-04-19T14:00:00.000Z", "request_id": "…", "count": 1 }
}