Deep dive
The most thorough analysis: everything in a standard report, plus comparison against known historical scams, contract code analysis, and the option to enable ongoing monitoring.
POST
/api/v1/deep-dive
Auth: account balance or x402. See Authentication.
Request
| Field | Type | Required | Description |
|---|---|---|---|
| project_address | string | Required | Contract/mint address. |
| chain | string | Required | A supported chain. |
| enable_monitoring | boolean | Optional | Request ongoing monitoring. Beta |
| monitoring_duration_days | integer | Optional | 7–90. Default 30. |
| webhook_url | string | Optional | Where alerts would be delivered. Beta |
curl -X POST https://csds.blockchainrangers.com/api/v1/deep-dive \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"project_address": "0x…",
"chain": "ethereum",
"enable_monitoring": true,
"monitoring_duration_days": 30
}'$headers = @{ Authorization = "Bearer YOUR_API_KEY" }
$body = @{ project_address = "0x…"; chain = "ethereum"; enable_monitoring = $true; monitoring_duration_days = 30 } | ConvertTo-Json
Invoke-RestMethod "https://csds.blockchainrangers.com/api/v1/deep-dive" `
-Method Post -Headers $headers -Body $body -ContentType "application/json"import httpx
r = httpx.post(
"https://csds.blockchainrangers.com/api/v1/deep-dive",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"project_address": "0x…", "chain": "ethereum", "enable_monitoring": True},
)
report = r.json()csds check 0x… --chain ethereum --deep --format jsonResponse
Includes all standard-report fields, plus:
| Section | Description |
|---|---|
| historical_comparison | Similar known scams, similarity scores, and matched patterns. |
| code_analysis | Contract complexity, upgrade mechanism, centralization risks. |
| monitoring | Echo of the monitoring config (see Beta note below). |
{
"risk_score": 81,
"risk_level": "CRITICAL",
"historical_comparison": {
"similar_scams": [ { "name": "…", "similarity_score": 0.91, "outcome": "rug_pull" } ],
"pattern_matches": ["hidden_mint", "unlocked_liquidity"]
},
"code_analysis": { "contract_complexity": "high", "upgrade_mechanism": "proxy" },
"monitoring": { "enabled": true, "monitoring_until": "2026-07-02T00:00:00Z" }
}Monitoring & webhooks are in Beta. The response echoes your monitoring config, but alert delivery is not yet active. See Webhooks & monitoring for the planned payload and status.
Reported scam tokens
If the token has been reported by the community and confirmed as a scam by our review team, the request is hard-blocked: no analysis runs, and a flat $0.10 lookup fee is charged (not the full price). The response is
200 with "blocked": true — check that flag first, before reading the risk fields (they are absent). Same behavior on Standard report, the web app, and the CLI.{
"blocked": true,
"code": "reported_scam",
"risk_score": 100,
"risk_level": "CRITICAL",
"recommendation": "AVOID",
"message": "This token has been reported by the community and confirmed as a scam by our review team.",
"charged_cents": 10,
"charged_display": "$0.10"
}