Quick check
The fastest endpoint: a single 0–100 risk score, a level, and the most important red flags. Use it for a go/no-go answer in roughly two seconds.
POST
/api/v1/quick-check
Auth: account balance or x402. Free via the CLI (3 lifetime checks). See Authentication.
Request
| Field | Type | Required | Description |
|---|---|---|---|
| project_address | string | Required | Contract/mint address. EVM 0x… (40 hex) or Solana base58. |
| chain | string | Required | A supported chain. blockchain accepted as an alias. |
| symbol | string | Optional | Token symbol; used to assist resolution when provided. |
curl -X POST https://csds.blockchainrangers.com/api/v1/quick-check \
-H "Content-Type: application/json" \
-d '{
"project_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"chain": "ethereum"
}'
$body = @{ project_address = "0x6982508145454ce325ddbe47a25d4ec3d2311933"; chain = "ethereum" } | ConvertTo-Json
Invoke-RestMethod "https://csds.blockchainrangers.com/api/v1/quick-check" `
-Method Post -Body $body -ContentType "application/json"
import httpx
r = httpx.post(
"https://csds.blockchainrangers.com/api/v1/quick-check",
json={"project_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933", "chain": "ethereum"},
)
data = r.json()
print(data["risk_score"], data["risk_level"])
const r = await fetch("https://csds.blockchainrangers.com/api/v1/quick-check", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
project_address: "0x6982508145454ce325ddbe47a25d4ec3d2311933",
chain: "ethereum",
}),
});
const data = await r.json();
console.log(data.risk_score, data.risk_level);
csds check 0x6982508145454ce325ddbe47a25d4ec3d2311933 \
--chain ethereum --format json
Response
| Field | Type | Description |
|---|---|---|
| risk_score | integer | Overall risk, 0–100 (higher = riskier). |
| risk_level | string | LOW · MEDIUM · HIGH · CRITICAL. |
| recommendation | string | SAFE · CAUTION · AVOID. |
| confidence | number | Analysis confidence, 0.0–1.0. |
| top_flags | string[] | Up to five most important red flags. |
{
"risk_score": 72,
"risk_level": "HIGH",
"recommendation": "AVOID",
"confidence": 0.89,
"top_flags": [
"Unverified smart contract",
"Top 10 wallets hold 88% of supply",
"Liquidity is not locked"
],
"token": { "name": "Example", "symbol": "EXMPL", "chain": "ethereum" }
}
Need the full breakdown behind the score? Use the standard report.
Errors
Returns 400 for a malformed address/chain, 402 when unfunded, and 429 when rate-limited. See the error reference.