Skip to main content
GET
https://api.chainguardai.dev
/
v1
/
scan
/
wallet
/
{address}
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/scan/wallet/0x742d35Cc6634C0532925a3b844Bc454c459dFE2C?chain=ethereum&includeApprovals=true' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'

{
  "success": true,
  "data": {
    "address": "0x742d35Cc6634C0532925a3b844Bc454c459dFE2C",
    "chain": "ethereum",
    "riskScore": 15,
    "riskLevel": "low",
    "labels": [],
    "profile": {
      "age": 847,
      "transactionCount": 1523,
      "firstSeen": "2021-09-15T10:23:00Z",
      "lastSeen": "2024-01-15T08:45:00Z"
    },
    "associations": {
      "knownEntities": ["Uniswap", "OpenSea", "Aave"],
      "flaggedAddresses": [],
      "fundingSources": ["Coinbase"]
    },
    "riskFactors": []
  },
  "meta": {
    "requestId": "req_wallet_normal",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 312
  }
}
Analyze a wallet address for risk indicators including funding sources, associations, and transaction patterns.

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer cg_live_xxxxxxxx

​
Path Parameters

​
address
string
required
Wallet address to analyze (42 characters, starting with 0x).Example: 0x742d35Cc6634C0532925a3b844Bc454c459dFE2C

​
Query Parameters

​
chain
string
default:"ethereum"
Blockchain network.Options: ethereum, bsc, polygon
​
includeTransactions
boolean
default:"false"
Include recent transaction summary
​
includeApprovals
boolean
default:"false"
Include active token approvals

​
Response

​
address
string
Wallet address analyzed
​
chain
string
Blockchain network
​
riskScore
integer
Overall risk score (0-100)
​
riskLevel
string
Risk classification: safe, low, medium, high, critical
​
labels
array
Known labels for this address.Possible values: exchange, defi_protocol, whale, smart_money, mev_bot, hacker, scammer, mixer, bridge, multisig, dao_treasury
​
profile
object
Wallet profile information.
​
associations
object
Wallet associations and connections.
​
riskFactors
array
Contributing risk factors.
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/scan/wallet/0x742d35Cc6634C0532925a3b844Bc454c459dFE2C?chain=ethereum&includeApprovals=true' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'

{
  "success": true,
  "data": {
    "address": "0x742d35Cc6634C0532925a3b844Bc454c459dFE2C",
    "chain": "ethereum",
    "riskScore": 15,
    "riskLevel": "low",
    "labels": [],
    "profile": {
      "age": 847,
      "transactionCount": 1523,
      "firstSeen": "2021-09-15T10:23:00Z",
      "lastSeen": "2024-01-15T08:45:00Z"
    },
    "associations": {
      "knownEntities": ["Uniswap", "OpenSea", "Aave"],
      "flaggedAddresses": [],
      "fundingSources": ["Coinbase"]
    },
    "riskFactors": []
  },
  "meta": {
    "requestId": "req_wallet_normal",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 312
  }
}