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 $0.10100 / hour

Auth: account balance or x402. Free via the CLI (3 lifetime checks). See Authentication.

Request

FieldTypeRequiredDescription
project_addressstringRequiredContract/mint address. EVM 0x… (40 hex) or Solana base58.
chainstringRequiredA supported chain. blockchain accepted as an alias.
symbolstringOptionalToken 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

FieldTypeDescription
risk_scoreintegerOverall risk, 0–100 (higher = riskier).
risk_levelstringLOW · MEDIUM · HIGH · CRITICAL.
recommendationstringSAFE · CAUTION · AVOID.
confidencenumberAnalysis confidence, 0.0–1.0.
top_flagsstring[]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.

Related

Standard report Full dimensional breakdown. Batch Many quick checks at once.