Detection, identities, holdings and wallet finder

Quick lookups that don't run a scan. Every route on this page is free.

9 routes. Every path below is served under https://api.scanner.net, and every request carries the key header, so those two are not repeated per route. Shared errors and limits are in Requests and errors. Some routes here have a per-IP limit.

Detect address

GET /detect/{address}

Says what an address is, on Solana or Robinhood Chain. The chain is worked out from the address.

curl "https://api.scanner.net/detect/WALLET_ADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: the detection, with no wrapper: chain, family (svm or evm), address, isToken, isContract, isWallet and exists. Solana adds owner and executable. balance (smallest unit) appears when the answer wasn't cached.

Detect addresses in bulk

POST /detect

The same detection for up to 100 addresses.

curl -X POST "https://api.scanner.net/detect" \
  -H "x-api-key: $SCANNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"addresses":["WALLET_ADDRESS","0xADDRESS"]}'

Response: { "detections": { "<address>": { ... } } }, keyed by each address exactly as sent. Addresses that don't exist or couldn't be detected are left out.

Identities

POST /identities/batch

Names and labels for many addresses: KOL names and handles, and entity labels such as exchanges and protocols. Limited to 60 requests per minute per IP.

curl -X POST "https://api.scanner.net/identities/batch" \
  -H "x-api-key: $SCANNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"addresses":["WALLET_ADDRESS"],"chain":"sol"}'

Response: { "success": true, "identities": { "<address>": { "kol", "entity" } } }.

• kol: { name, twitter_handle, profile_picture_url }, Solana only.
• entity: { name, type, category, tags }.
• On Solana, addresses with no name are left out. On Robinhood Chain every address is present, as {} when unnamed.

Solana holdings

GET /holdings/{address}

A Solana wallet's SOL and token balances with USD values.

curl "https://api.scanner.net/holdings/WALLET_ADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "data": { ... } }. data has address, solBalance, solUsdPrice, solUsdValue, tokens, totalUsdValue, fetchedAt, truncated, and stale: true when a slightly older copy was served because the live read timed out. Each token has mint, symbol, name, logoUri, balance, decimals, usdPrice, usdValue and liquidityUsd. Results are cached for 30 seconds.

Solana liquid balance

GET /holdings/{address}/liquid-balance

A Solana wallet's holdings, counting only tokens with enough liquidity to sell.

curl "https://api.scanner.net/holdings/WALLET_ADDRESS/liquid-balance?minLiquidityUsd=10000" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: the same shape as Solana holdings, with minLiquidityUsd set. Cached for an hour per address and threshold.

Solana wallet trades

GET /holdings/{address}/trades

Profit and loss per token for a Solana wallet: up to 20 tokens, highest realized profit first.

curl "https://api.scanner.net/holdings/WALLET_ADDRESS/trades" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "data": [...] }. Each entry has mint, symbol, name, realized, unrealized, totalInvested, totalSold, buyTransactions, sellTransactions, holding, currentValue and lastTradeTime. Cached for 5 minutes.

EVM holdings

GET /holdings/evm/{address}

An EVM wallet's balances across chains, including Robinhood Chain. Limited to 20 requests per minute per IP.

curl "https://api.scanner.net/holdings/evm/0xADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "data": { ... } }. data has address, totalUsd, complete (false when a chain couldn't be read), fetchedAt and chains. Each chain has chain (a CAIP-2 id), chainName, totalUsd, unpricedCount and tokens. Each token has tokenAddress (null for the native coin), symbol, name, decimals, amount (a decimal string), priceUsd and valueUsd.

Wallet finder

GET /wallet-finder/search
GET /rh/wallet-finder/search

Finds full addresses that match a truncated one, such as 5ZkP...cikb copied from a screenshot. The first path searches Solana, the second Robinhood Chain. See Wallet finder for how matching works. Limited to 30 requests per minute per IP on each chain.

The known parts must be long enough:

curl "https://api.scanner.net/wallet-finder/search?q=5ZkP...cikb" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "data": { "pattern", "matches", "truncated" } }. pattern is exact, prefix, suffix, affix or middle. matches holds up to 20 { address, firstSeen, lastSeen }, most recently seen first; the times are when Scanner's index saw the address. truncated is true when there were more matches. A full address returns itself.