CRIUS

Bundle map API

Robinhood Chain bundle map and sniper detection API

Crius detects snipers, bundled buys and funding clusters for any Robinhood Chain token and tells you how much of the supply they still hold. Its bubble-map endpoint returns top holders as nodes and the funding, transfer and same-block links between them as edges, ready for a graph library.

Get a free API key API reference
  • History from block 0
  • REST + WebSocket
  • Free plan: 1M credits / month
  • Robinhood Chain · chain ID 4663

Try it

A real request and its response

Captured from the live API, trimmed for length. Replace $CRIUS_API_KEY with your key; calls without that header work keyless at 2 requests a second.

Snipers and bundles for CHARGE Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/bundles" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": {
    "bundle_supply_pct": 0,
    "bundle_supply_pct_now": 0,
    "bundled": false,
    "bundles": [],
    "clusters": [],
    "dev": {
      "address": "0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca",
      "bought_in_launch_tx": false,
      "first_buy_pct": 0,
      "funded_by": {
        "address": "0xd782268f600403843484b70710daee6846fc0db8",
        "amount_eth": 0.008148386337868891
      },
      "holding_pct": 0
    },
    "early_buyers_analyzed": 4,
    "snipers": {
      "count": 1,
      "still_holding_pct": 0,
      "supply_pct": 6.09195,
      "wallets": [
        {
          "address": "0xc54d3914f91f984d61b63d491f38934c4e706b79",
          "tags": [
            "sniper"
          ]
        }
      ],
      "window_blocks": 10
    },
    "trader_funding": {
      "bridge": 2,
      "other_wallets": 1,
      "unlabeled_hub": 1
    }
  },
  "meta": {
    "block": 96714203,
    "scope": "first 300 blocks of trading"
  }
}

One sniper bought within the first 10 blocks (6.1% of supply) and has sold everything since; the creator didn't buy in the launch transaction. window_blocks changes the sniper window.

What you get

Built for Robinhood Chain, not bolted on

  • Snipers

    Wallets that bought within the first blocks after trading opened (default 10), their share of supply then and now.

  • Bundles

    One transaction buying for several recipients, a launch transaction that also buys, same-block buyers sharing a funder, or wallets forwarding to a common wallet.

  • Funding clusters

    Groups of buyers funded by the same source, with bridge and exchange funders labeled.

  • Bubble maps

    Up to 500 top holders with funding, transfer, common-funder and same-block edges; pass block for the map at a past point.

  • Dev behaviour

    Whether the creator bought in the launch transaction, how much they hold, and who funded them.

  • Connected wallets

    Expand any node with /wallet/{address}/connections.

Endpoints

The calls behind it

Base URL https://api.crius.sh, chain segment robinhood (or 4663). Every response is {data, meta} with the block it reflects.

EndpointReturnsPlanCredits
GET /v1/{chain}/token/{address}/bundles Snipers, bundles, clusters and the supply they hold Starter+ 10
GET /v1/{chain}/token/{address}/bubblemap Top holders (up to 500) as nodes, links as edges; historical with block Starter+ 10
GET /v1/{chain}/wallet/{address}/connections A wallet's funding and transfer links Starter+ 10

Use cases

  • Rug and insider risk scoring
  • Bubble maps in terminals
  • Launch fairness checks
  • Investigations and reports
  • Launchpad moderation

Plans and limits

Bundles, bubble maps and connections need the Starter plan or higher (10 credits each).

See pricing Plans, limits & credits

Questions about the Bundle & sniper detection API

What counts as a bundle?

One transaction buying for several recipients, a launch transaction that also buys, two or more wallets buying in the same block that share a funder, or wallets forwarding tokens to a common wallet.

Can I render a bubble map with it?

Yes. /bubblemap returns nodes (top holders, up to 500) and typed edges, the shape force-directed graph libraries expect. Pass block for a historical map.

How are snipers defined?

Wallets that bought within window_blocks blocks after trading opened (10 by default). The response shows their supply share at the time and what they still hold.

Which plan do I need?

Starter or higher; each bundles, bubblemap or connections call costs 10 credits.

Related APIs

Guides and articles

Documentation

Bundles & bubble maps reference → All Robinhood Chain APIs → Compare providers →

Start with the free plan

1,000,000 credits a month, no card. Your key in under a minute.

Get a free API key Try the playground