Wallet Intelligence

Wallet endpoints answer three questions: who is this address, how good (or bad) are they, and who are they connected to. Data draws on 39.5M+ labeled wallets and on-chain analytics across 13+ chains.

All endpoints below are live on https://rugmunch.io/api/v1 (snapshot verified 2026-08-24).

Labels — who owns this address

curl "https://rugmunch.io/api/v1/rugmaps/wallet-labels?chain=ethereum&addresses=0x28C6c06298d514Db089934071355E5743bf21d60"

Real response (exchange attribution, entity grouping):

{
  "labels": {
    "0x28c6c06298d514db089934071355e5743bf21d60": {
      "label": "Binance 14",
      "entity": "..."
    }
  }
}

Related label endpoints:

Endpoint	What it returns
`GET /api/v1/rugmaps/wallet-labels`	Labels for a batch of addresses
`GET /api/v1/x402-databus/wallet-labels`	Paid-tier labels with richer attribution
`GET /api/v1/databus/arkham/labels`	Label catalog (paid)
`POST /api/v1/rugmaps/auto-label`	Cluster-based auto-labeling

Risk & scoring

# Security analysis for a wallet (risk factors, exposure)
curl https://rugmunch.io/api/v1/security/wallet/0xYourAddress

# Composite score, per chain
curl https://rugmunch.io/api/v1/scoring/wallet/ethereum/0xYourAddress

# Portfolio snapshot + history (paid)
curl https://rugmunch.io/api/v1/security/portfolio/0xYourAddress
curl https://rugmunch.io/api/v1/security/portfolio/history/0xYourAddress

PnL, balances, tokens

# Realized/unrealized PnL (tries multiple upstream sources automatically)
curl https://rugmunch.io/api/v1/databus/wallet/0xYourAddress/pnl

# Token holdings
curl https://rugmunch.io/api/v1/databus/wallet/0xYourAddress/tokens

# Paid-tier equivalents with richer output:
curl "https://rugmunch.io/api/v1/x402-databus/wallet-pnl?address=0xYourAddress&chain=ethereum"
curl "https://rugmunch.io/api/v1/x402-databus/wallet-balance?address=0xYourAddress&chain=ethereum"
curl "https://rugmunch.io/api/v1/x402-databus/wallet-tokens?address=0xYourAddress&chain=ethereum"
curl "https://rugmunch.io/api/v1/x402-databus/wallet-profile?address=0xYourAddress&chain=ethereum"

note

When an upstream source has no data, endpoints return HTTP 200 with {"data": null, "reason": "no_data", "sources_tried": [...]} — check reason rather than assuming success means data.

Clusters & funding paths — who are they connected to

Wallet clustering groups addresses likely controlled by the same entity, then traces where their money came from:

Endpoint	Purpose
`POST /api/v1/wallet-clusters/detect`	Detect clusters around a seed address
`POST /api/v1/wallet-clusters/scan`	Full cluster scan
`POST /api/v1/wallet-clusters/contract-scan`	Clusters interacting with a contract
`GET /api/v1/wallet-clusters/funding-path`	Trace funding source of a cluster
`GET /api/v1/wallet-clusters/ai-forensic-breakdown`	AI narrative of cluster behavior
`GET /api/v1/wallet-clusters/health`	Service health

curl -X POST https://rugmunch.io/api/v1/wallet-clusters/detect \
  -H "Content-Type: application/json" \
  -d '{"address": "0xSuspectAddress", "chain": "ethereum"}'

From an AI agent

MCP tools for wallet work (see MCP Setup):

get_wallet_analysis — combined wallet risk + behavior summary
resolve_entity — resolve an address to its known entity
eth_labels_query / eth_labels_stats — raw label store queries

Pricing

Label lookups and basic risk checks are trial-eligible (free calls per tool). Cluster forensics, Arkham/Nansen-grade attribution, and portfolio history are paid x402 tools — see x402 Payments for live pricing per call.

Labels — who owns this address​

Risk & scoring​

PnL, balances, tokens​

Clusters & funding paths — who are they connected to​

From an AI agent​

Pricing​