---
title: "Every coordinated buy cluster on a Robinhood Chain token, launch and later (PRO+)"
method: GET
path: "/rhc/tokens/{address}/bundles"
tags: ["Robinhood Chain"]
---

# Every coordinated buy cluster on a Robinhood Chain token, launch and later (PRO+)

`GET /rhc/tokens/{address}/bundles`

## Request

- Base URL: `https://madeonsol.com/api/v1`
- URL: `https://madeonsol.com/api/v1/rhc/tokens/{address}/bundles`
- Auth: HTTP bearer

Every block in the window where at least `min_wallets` distinct effective trading accounts (ERC-4337 senders resolved) bought the token, the launch bundle AND clusters that enter later (2026-10-15). `/rhc/tokens/{address}/bundle` remains the launch-cohort view. Per cluster: block, time, `minutes_after_launch` + `phase`, `wallet_count`, `new_wallets`, `same_tx_groups` (transactions carrying 3+ of them; weaker than on Solana because a 4337 bundler batches unrelated userOps into one tx), ETH volume, `token_volume_raw` (uint256 string), wallets. No size floor on Robinhood Chain. `include_balances=true` adds `held_now` (balanceOf from our node) to the 3 most recent clusters.

## Path parameters

- `address` string, required

## Query parameters

- `window` '1h' | '6h' | '24h'
- `min_wallets` integer
- `limit` integer
- `include_balances` boolean

## Response `200`

OK. An empty clusters array means no slot/block in the window had min_wallets distinct buyers.

- object
  - `chain` 'robinhood'
  - `token_address` string
  - `window` string
  - `min_wallets` integer
  - `launch_at` string, date-time, nullable
  - `summary` object
    - `cluster_count` integer
    - `launch_clusters` integer
    - `later_clusters` integer
    - `latest_cluster_at` string, date-time, nullable
    - `largest_cluster_wallets` integer
    - `baseline` object, nullable: Window baseline (null when no cluster was found): active units, buys in window, buys per active unit. On busy tokens unrelated buyers share slots.
  - `clusters` object[]
    - `block_number` integer
    - `same_tx_groups` integer
    - `eth_volume` number, nullable
    - `token_volume_raw` string, nullable
    - `at` string, date-time
    - `minutes_after_launch` number, nullable
    - `phase` 'launch' | 'later' | 'unknown': launch = within 5 minutes of launch_at.
    - `wallet_count` integer
    - `new_wallets` integer: Buyers with no earlier buy of this token.
    - `wallets` string[]: At most 50.
    - `held_now` object: Only with include_balances=true, on the 3 most recent clusters: same shape as the bundle held_now of this chain; totals only when every wallet was read.
    - `exit` object, nullable: What this cluster's wallets have SOLD of the token since the cluster (bundle-watch sell ledger, migration 503). null = not followed (only clusters bundle-watch announced: >= 3 wallets new to the token; followed 7 days after detection; first 50 wallets).
      - `cluster_id` integer
      - `followed_until` string, date-time
      - `wallets_tracked` integer
      - `wallets_sold` integer
      - `wallets_exited` integer: Sold >= 99 % of their cluster buy.
      - `bought_tokens_raw` string, nullable
      - `sold_tokens_raw` string
      - `sold_pct` number, nullable: Sum over wallets of min(sold, bought in the cluster) / bought in the cluster, 0..1.
      - `realized_eth` number: Known proceeds only (migration 511); see realized_status.
      - `realized_status` 'complete' | 'incomplete', nullable: Migration 511: incomplete when at least one recorded sell has unknown proceeds (Solana price_status proceeds_unattributed, or no quote amount); its tokens count in sold_pct, its proceeds are NOT in realized_eth (never booked as 0). null = not measured (ledger before migration 511).
      - `unknown_proceeds_sells` integer, nullable: Recorded sells with unknown proceeds (see realized_status).
      - `last_sell_at` string, date-time, nullable
  - `held_now_clusters` integer: Only with include_balances=true.
  - `exit_tracking` 'ok' | 'unavailable' | 'error': Whether the exit ledger could be read; the clusters are served either way (exit null when not ok).
  - `exit_note` string
  - `note` string

## Other responses

- `400`: Invalid address or query parameters
- `401`: Missing or invalid API key, or an expired free-tier key. Authentication-stage error: no `X-RateLimit-*` headers, no `_rid`.
- `403`: Tier gate - PRO required.
- `429`: Too many requests. Every 429 carries `Retry-After`. A quota 429 (`rate_limit_exceeded`, with `X-RateLimit-*`), a heavy-query concurrency 429 (`error_kind` `concurrency`/`capacity`), or the per-IP authentication-failure block (30 failed auths/min; plain `error` + `retry_after_seconds`, no `X-RateLimit-*`).
- `500`: Unexpected server error from the route (`Internal server error`, with `_rid`). Safe to retry with backoff. A failed API-key lookup is a 503 `auth_backend_unavailable`, never a 500.
- `503`: bundle_clusters_unavailable (SQL function not applied) or bundle_clusters_temporarily_unavailable (timeout).

---

[API](https://skmtc.dev/madeonsol/apis/madeonsol-robinhood-chain-api.md) · [All operations](https://skmtc.dev/madeonsol/apis/madeonsol-robinhood-chain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/madeonsol/apis/madeonsol-robinhood-chain-api/revisions/9ea9a35ee2bf?raw)