Skip to main content
GET
https://api.chainguardai.dev
/
v1
/
risk
/
report
/
{entity}
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/risk/report/0xdAC17F958D2ee523a2206206994597C13D831ec7?chain=ethereum' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'
{
  "success": true,
  "data": {
    "entity": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "entityType": "contract",
    "summary": {
      "riskScore": 15,
      "riskLevel": "low",
      "verdict": "safe",
      "generatedAt": "2024-01-15T14:32:00Z"
    },
    "riskBreakdown": {
      "ownership": {
        "score": 20,
        "weight": 25,
        "factors": [
          {
            "name": "Ownership not renounced",
            "impact": 10,
            "description": "Owner can modify contract parameters"
          },
          {
            "name": "Multisig owner",
            "impact": -5,
            "description": "Owner is a multisig (reduces risk)"
          }
        ]
      },
      "code": {
        "score": 5,
        "weight": 30,
        "factors": [
          {
            "name": "Verified source",
            "impact": -10,
            "description": "Source code is verified on Etherscan"
          },
          {
            "name": "Audited",
            "impact": -15,
            "description": "Contract audited by multiple firms"
          }
        ]
      },
      "liquidity": {
        "score": 5,
        "weight": 25,
        "factors": [
          {
            "name": "High liquidity",
            "impact": -10,
            "description": "Liquidity > $1B"
          }
        ]
      },
      "associations": {
        "score": 10,
        "weight": 20,
        "factors": [
          {
            "name": "Interacts with known exchanges",
            "impact": -5,
            "description": "Used by major centralized exchanges"
          }
        ]
      }
    },
    "history": [
      { "date": "2024-01-01", "score": 15 },
      { "date": "2023-12-01", "score": 15 },
      { "date": "2023-11-01", "score": 18 },
      { "date": "2023-10-01", "score": 18 }
    ],
    "recommendations": [
      "This is a well-established stablecoin contract (USDT)",
      "Owner retains control - be aware of centralization",
      "Monitor for any ownership changes"
    ]
  },
  "meta": {
    "requestId": "req_report_usdt",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 1247
  }
}
Full risk analysis report with detailed breakdown of all risk factors, historical data, and recommendations.

Authorization

Authorization
string
required
Bearer token. Format: Bearer cg_live_xxxxxxxx

Path Parameters

entity
string
required
Wallet address, contract address, or URL to analyze.

Query Parameters

chain
string
default:"ethereum"
Blockchain network.Options: ethereum, bsc, polygon
format
string
default:"json"
Response format.Options: json, pdf

Response

entity
string
Analyzed entity
entityType
string
Entity type: wallet, contract, url
summary
object
Report summary.
riskBreakdown
object
Detailed score breakdown by category.
history
array
Historical risk score changes
recommendations
array
Actionable security recommendations
curl --request GET \
  --url 'https://api.chainguardai.dev/v1/risk/report/0xdAC17F958D2ee523a2206206994597C13D831ec7?chain=ethereum' \
  --header 'Authorization: Bearer cg_live_xxxxxxxxxxxxxxxx'
{
  "success": true,
  "data": {
    "entity": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "entityType": "contract",
    "summary": {
      "riskScore": 15,
      "riskLevel": "low",
      "verdict": "safe",
      "generatedAt": "2024-01-15T14:32:00Z"
    },
    "riskBreakdown": {
      "ownership": {
        "score": 20,
        "weight": 25,
        "factors": [
          {
            "name": "Ownership not renounced",
            "impact": 10,
            "description": "Owner can modify contract parameters"
          },
          {
            "name": "Multisig owner",
            "impact": -5,
            "description": "Owner is a multisig (reduces risk)"
          }
        ]
      },
      "code": {
        "score": 5,
        "weight": 30,
        "factors": [
          {
            "name": "Verified source",
            "impact": -10,
            "description": "Source code is verified on Etherscan"
          },
          {
            "name": "Audited",
            "impact": -15,
            "description": "Contract audited by multiple firms"
          }
        ]
      },
      "liquidity": {
        "score": 5,
        "weight": 25,
        "factors": [
          {
            "name": "High liquidity",
            "impact": -10,
            "description": "Liquidity > $1B"
          }
        ]
      },
      "associations": {
        "score": 10,
        "weight": 20,
        "factors": [
          {
            "name": "Interacts with known exchanges",
            "impact": -5,
            "description": "Used by major centralized exchanges"
          }
        ]
      }
    },
    "history": [
      { "date": "2024-01-01", "score": 15 },
      { "date": "2023-12-01", "score": 15 },
      { "date": "2023-11-01", "score": 18 },
      { "date": "2023-10-01", "score": 18 }
    ],
    "recommendations": [
      "This is a well-established stablecoin contract (USDT)",
      "Owner retains control - be aware of centralization",
      "Monitor for any ownership changes"
    ]
  },
  "meta": {
    "requestId": "req_report_usdt",
    "timestamp": "2024-01-15T14:32:00.847Z",
    "processingTime": 1247
  }
}