CRIUS

Wallet analytics API

Robinhood Chain wallet analytics and PnL API

Crius computes wallet PnL on Robinhood Chain: realized and unrealized profit, ROI, win rate and holdings for any wallet, and the top traders of any token ranked by PnL. It also shows a wallet's full trade history, who funded it, and for token creators, every token they launched.

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

Real requests, real responses

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.

Top traders of CHARGE by PnL Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/traders?sort=pnl&limit=2" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": [
    {
      "rank": 1,
      "address": "0x9e38fedc40987c19396cc20ea59eb2b1b7928881",
      "pnl_usd": 1302.88,
      "realized_pnl_usd": 1302.88,
      "unrealized_pnl_usd": 0,
      "roi_pct": 531.573,
      "buys": 1,
      "sells": 7,
      "bought_usd": 245.099,
      "sold_usd": 1547.98,
      "holding_time_s": 118676,
      "tags": []
    },
    {
      "rank": 2,
      "address": "0x7c79ad74d36dea424d08a5d326271bf03da81f6a",
      "pnl_usd": 994.45,
      "realized_pnl_usd": 994.45,
      "unrealized_pnl_usd": 0,
      "roi_pct": 270.767,
      "buys": 2,
      "sells": 4,
      "bought_usd": 367.271,
      "sold_usd": 1291.44,
      "holding_time_s": 125872,
      "tags": []
    }
  ],
  "meta": {
    "block": 96714199,
    "block_ts": 1792839655000,
    "finalized_block": 96703786,
    "lag_ms": 98,
    "safe_block": 96707359
  }
}

PnL is computed from the wallet's own trades with a complete cost basis (cost_basis: complete in the full response), and gas is reported separately.

A wallet's profile Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?window=all" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": {
    "address": "0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca",
    "pnl": {
      "avg_hold_time_s": null,
      "best_trade": null,
      "gas_scope": "all transactions sent by the wallet in the window",
      "gas_spent_usd": 0.181845,
      "realized_usd": 0,
      "tokens_traded": 0,
      "tokens_with_known_cost": 0,
      "total_usd": 0,
      "trades": 0,
      "unrealized_usd": 0,
      "volume_usd": 0,
      "win_rate_pct": null,
      "window": "all",
      "worst_trade": null
    },
    "profile": {
      "first_seen_ts": 1792283372000,
      "funded_by": {
        "address": "0xd782268f600403843484b70710daee6846fc0db8",
        "amount_eth": 0.008148386337868891,
        "block": 87601233,
        "label": "bridge:Relay solver",
        "ts": 1791903516300
      },
      "tags": [
        "dev"
      ],
      "tx_count": 9,
      "wallet_age_days": 6.43846
    }
  }
}

funded_by shows where the wallet's first ETH came from, labeled when it's known infrastructure (here a Relay bridge solver).

What you get

Built for Robinhood Chain, not bolted on

  • PnL that holds up

    Realized and unrealized PnL per token and in total, from the wallet's own trades, with ROI, win rate and gas spent.

  • Top traders and smart money

    Rank a token's traders by PnL, realized PnL, volume, buys or ROI over 1h, 24h, 7d or all time, with tags like sniper, bot, whale and dev.

  • Real trader attribution

    Trades routed through aggregators, solvers or bundlers count for the wallet that actually traded.

  • Funding trail

    Who funded a wallet, who it funded, and wallets sharing a funder.

  • Developer track records

    Every token a creator deployed or launched, with peak market cap and outcome.

  • Live wallet stream

    wallet:

    pushes a wallet's trades and transfers as they happen.

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}/wallet/{address} Holdings, realized/unrealized PnL, win rate, tags, funder Starter+ 5
GET /v1/{chain}/wallet/{address}/trades Every trade the wallet made Starter+ 5
GET /v1/{chain}/token/{address}/traders Top traders of a token by PnL, realized PnL, volume, buys or ROI Free+ 5
GET /v1/{chain}/dev/{address} A creator's launched tokens and how they did Free+ 5
GET /v1/{chain}/wallet/{address}/connections Funding and transfer links to other wallets Starter+ 10

Use cases

  • Portfolio and PnL trackers
  • Copy-trading and smart-money feeds
  • Leaderboards
  • Due diligence on creators
  • Tax and accounting exports

Plans and limits

Top traders: Free plan, 5 credits. Wallet profile and wallet trades: Starter plan, 5 credits. Connections: Starter plan, 10 credits. Developer profile: Free plan, 5 credits.

See pricing Plans, limits & credits

Questions about the Wallet analytics API

How is wallet PnL calculated?

From the wallet's own trades: realized PnL on what it sold against its cost basis, unrealized PnL on what it still holds at the current price. ROI, win rate and gas spent are reported alongside.

Does PnL count trades made through aggregators?

Yes. Trades are attributed to the wallet whose balance changed, so swaps through routers, Relay solvers or ERC-4337 bundlers still count for the real trader.

Can I find the most profitable traders of a token?

Yes: /traders sorted by pnl, realized_pnl, volume, buys or roi over 1h, 24h, 7d or all time, with wallet tags.

Can I see who funded a wallet?

Yes. The wallet profile includes funded_by, and /connections lists funding and transfer links, including wallets that share a funder.

Related APIs

Guides and articles

Documentation

Wallets & devs reference →Holders & traders 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