Skip to main content
GET
https://api.chainguardai.dev
/
v1
/
risk
/
score
/
{entity}
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/risk/score/0x742d35Cc6634C0532925a3b844Bc454c459dFE2C?chain=ethereum' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'

{
  "success": true,
  "data": {
    "entity": "0x742d35Cc6634C0532925a3b844Bc454c459dFE2C",
    "entityType": "wallet",
    "riskScore": 12,
    "riskLevel": "low",
    "confidence": 0.95,
    "lastUpdated": "2024-01-15T14:32:00Z",
    "factors": []
  },
  "meta": {
    "requestId": "req_score_low",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 45
  }
}
Quick risk score lookup for any entity. For detailed reports, use the Risk Report endpoint.

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer cg_live_xxxxxxxx

​
Path Parameters

​
entity
string
required
The entity to score. Can be:
  • Wallet address: 0x742d35Cc6634C0532925a3b844Bc454c459dFE2C
  • Contract address: 0xdAC17F958D2ee523a2206206994597C13D831ec7
  • URL: https://suspicious-site.com
  • Transaction hash: 0xa1b2c3d4e5f6...

​
Query Parameters

​
chain
string
default:"ethereum"
Blockchain network (for address entities only).Options: ethereum, bsc, polygon
​
type
string
Entity type hint. Auto-detected if not provided.Options: address, url, transaction

​
Response

​
entity
string
The entity that was scored
​
entityType
string
Detected entity type: wallet, contract, url, transaction
​
riskScore
integer
Risk score from 0-100
​
riskLevel
string
Human-readable risk level: safe, low, medium, high, critical
​
confidence
number
Score confidence (0.0-1.0)
​
lastUpdated
string
When the score was last calculated (ISO 8601)
​
factors
array
Top contributing factors to the score
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/risk/score/0x742d35Cc6634C0532925a3b844Bc454c459dFE2C?chain=ethereum' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'

{
  "success": true,
  "data": {
    "entity": "0x742d35Cc6634C0532925a3b844Bc454c459dFE2C",
    "entityType": "wallet",
    "riskScore": 12,
    "riskLevel": "low",
    "confidence": 0.95,
    "lastUpdated": "2024-01-15T14:32:00Z",
    "factors": []
  },
  "meta": {
    "requestId": "req_score_low",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 45
  }
}