CRIUS Docs
API status Get API key
Wallets & devs

Wallet profile

Wallet profile, holdings, PnL

GET https://api.crius.sh/v1/{chain}/wallet/{address}
Starter and above 5 credits per call Updated Oct 28, 2026

Holdings with USD value, realized and unrealized PnL over a window (1d, 7d, 30d, all), win rate and wallet tags. min_value_usd hides dust.

Path parameters

chainstringrequired

Chain slug (robinhood) or chain id (4663).

addressstringrequired

Contract or wallet address, any case (0x…, 20 bytes).

Query parameters

windowstring Default 30d

Stats window. One of 1d, 7d, 30d, all.

min_value_usdnumber

Hide holdings worth less than this many USD.

Guides that use this endpoint

Find a token's top traders and their PnLRank the traders of any Robinhood Chain token by PnL, volume, buys or ROI, with wallet tags, gas and hold time. A real example with the PnL math explained.Get a wallet's holdings and PnL on Robinhood ChainGet a Robinhood Chain wallet's tokens with USD value, ETH balance, realized and unrealized PnL, win rate, gas spent and wallet tags in one call. Real example.Get a wallet's trade historyList every trade a Robinhood Chain wallet made across all tokens, with USD value at trade time, market cap, DEX and gas. Filter by token, side, size, time.Get wallet token balances on Robinhood Chain (balances API)Get every token balance of a Robinhood Chain wallet (USDG, tokenized stocks, ETH) in USD in one call, one token's balances across wallets, and batch prices.Robinhood Chain API for wallets and portfolio appsWhat a Robinhood Chain wallet or portfolio app needs from the Crius API: holdings, USD values, PnL, trade history and warnings about spam tokens.

Errors

Errors come back as { "error": { "code", "message" } } with the matching HTTP status: 400 bad parameter, 401 missing or invalid key, 403 endpoint above your plan, 404 unknown token or address, 429 rate limit or credits used up (with Retry-After). See Errors.

More wallets & devs endpoints

GET/wallet/{address}/tradesWallet tradesStarter · 5 crGET/wallet/{address}/connectionsWallet connectionsStarter · 10 crGET/dev/{address}Developer profileFree · 5 cr

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

Get a free API key See plans
  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card