API /

api reference

REST API for querying token risk scores. No authentication required for public endpoints. Rate limited per IP.

BASE URLhttps://conaudits.app

GET/score— Score a pair's rug pull risk

Submit any Uniswap V2, V3, or V4 pair address on Base. Returns risk score, tier, 24h/7d probabilities, risk factors, trust signals, and AI narrative.

Field

Type

Description

pair_addressrequired

string

Uniswap V2/V3/V4 pair or pool address on Base (0x...)

chain

string

Chain identifier. Default: "base"

Request

curl "https://conaudits.app/score?pair_address=0x88a43bbdf9d098eec7bceda4e2494615dfd9bb9c"

Response

{
  "pair_address": "0x88a43bbdf9d098eec7bceda4e2494615dfd9bb9c",
  "risk_score": 0.0021,
  "risk_level": "Very Safe",
  "risk_summary": "This token demonstrates a healthy security profile based on structural analysis...",
  "confidence": "medium",
  "top_reasons": ["[+] High liquidity (> $500K)", "Token has been active for over 6 months"],
  "risk_factors": [
    { "factor": "LP minted only — no burns detected (rug pattern)", "severity": "high", "evidence": {} }
  ],
  "trust_signals": [
    { "signal": "High liquidity (> $500K)", "strength": "strong" }
  ],
  "recommendation": "Token appears relatively safe — still diversify your portfolio.",
  "warning_24h": 0.019,
  "warning_7d": 0.0,
  "technical": {
    "tier": "SAFE",
    "feature_completeness": 0.788,
    "features_snapshot": { "reserveusd": 3228855, "token_age_days": 736 }
  },
  "latency_ms": 3100
}

POST/v1/risk/batch— Score multiple tokens

Analyze up to 50 tokens in a single request. Recommended for agent pipelines that screen new token launches.

Request

curl -X POST https://conplus.app/v1/risk/batch \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "0xabc...",
      "0xdef...",
      "0x123..."
    ],
    "chain": "base"
  }'

Response

{
  "success": true,
  "results": [
    { "address": "0xabc...", "tier": "CRITICAL", "risk_24h": 0.921 },
    { "address": "0xdef...", "tier": "SAFE",     "risk_24h": 0.018 },
    { "address": "0x123...", "tier": "HIGH",     "risk_24h": 0.872 }
  ],
  "analyzed_at": "2026-02-19T10:24:00Z"
}

GET/v1/tokens/{address}— Get cached risk profile

Retrieve the latest cached risk profile for a token. Updates automatically every block. Use this for frequent polling without triggering re-analysis.

curl https://conplus.app/v1/tokens/0x4200000000000000000000000000000000000042

TIERS /

Risk Tiers

CRITICAL

≥ 90%

Near-certain rug. Avoid all interaction.

HIGH

≥ 85%

Strong rug signal. Do not ape.

ALERT

≥ 75%

Elevated risk. Proceed with caution.

WATCH

≥ 60%

Above baseline. Monitor closely.

SAFE

< 60%

Below alert threshold. Standard risk.