Build a pre-trade token risk gate.

curl -sS -X POST https://api.vswarm.io/v2/verdict \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VS_API_KEY" \
  -d '{"address":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","chain":"solana","level":"fast","include":[]}'

{
  "schema_version": "1.1",
  "request": {
    "address": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
    "chain": "solana",
    "level": "fast",
    "include": []
  },
  "verdict": {
    "action": "caution",
    "score": 82,
    "grade": "A",
    "risk_level": "low",
    "confidence": 1,
    "summary": "Jupiter (JUP) is a well-established major Solana ecosystem token with strong financials, a long operating history, and safe authority settings."
  },
  "signals": [
    {
      "id": "honeypot_simulation",
      "category": "security",
      "severity": "critical",
      "pass": true,
      "value": "ok",
      "detail": "Sell simulation passed."
    },
    {
      "id": "mint_authority",
      "category": "security",
      "severity": "critical",
      "pass": true,
      "value": "revoked",
      "detail": "Mint authority revoked — cannot inflate supply."
    },
    {
      "id": "freeze_authority",
      "category": "security",
      "severity": "high",
      "pass": true,
      "value": "revoked",
      "detail": "Freeze authority revoked — holders cannot be frozen."
    },
    {
      "id": "top10_holder_concentration",
      "category": "distribution",
      "severity": "high",
      "pass": false,
      "value": 66.2,
      "detail": "Top-10 wallets hold 66.2% of supply."
    },
    {
      "id": "contract_verified",
      "category": "transparency",
      "severity": "medium",
      "pass": true,
      "value": "verified",
      "detail": "Contract source code is publicly verified."
    },
    {
      "id": "liquidity_vs_mcap",
      "category": "liquidity",
      "severity": "high",
      "pass": false,
      "value": 0.0033,
      "detail": "Very low liquidity ratio: 0.33% of market cap."
    }
  ],
  "agents": [
    {
      "name": "FreeTierAI",
      "score": 8.2,
      "sentiment": "bullish",
      "key_findings": [
        "Token age is 919 days, indicating a long-standing and established project.",
        "Market cap stands at $607.5M with $2.0M in liquidity, reflecting mature market operations.",
        "Mint and freeze authorities have both been revoked, eliminating centralized supply manipulation risks.",
        "Missing holder metrics are typical data provider anomalies for high-volume native assets and do not negate foundational safety."
      ],
      "reasoning": null
    }
  ],
  "data_freshness": {
    "onchain_age_seconds": 2911,
    "market_age_seconds": 3,
    "social_age_seconds": 3,
    "basis": "observed"
  },
  "token": {
    "name": "Jupiter",
    "symbol": "JUP",
    "price_usd": 0.1829,
    "liquidity_usd": 2021849.5,
    "mcap_usd": 607509009,
    "fdv_usd": 1280767814,
    "volume_24h_usd": 316009.15,
    "holder_count": 827230,
    "age_days": 919,
    "top10_holder_pct": 66.22
  },
  "data_quality": {
    "required_missing": [
      "Holder data"
    ],
    "optional_missing": [],
    "warnings": [
      "Required data missing: Holder data unavailable during initial scan. Treat as missing data, not a negative signal.",
      "Holder count reported as 0 with mcap $607.5M — likely API limitation, not indicative of actual holder base",
      "Top 10 holder concentration unavailable — data source did not return holder distribution. Do not penalize for missing data."
    ],
    "degraded_agents": []
  },
  "liquidity_exposure_cap_usd": 10000,
  "data_confidence": 1,
  "insufficient_data": false,
  "lifecycle": null,
  "timing": null,
  "observation_id": "9cd71c81-86a4-4380-9eb0-d7e482948e98",
  "cached": false,
  "generated_at": "2026-08-07T16:55:18.090125Z",
  "latency_ms": 3099,
  "billing": {
    "rail": "free",
    "amount_usdc": "0",
    "tx": null,
    "degraded": false,
    "retry_voucher": null
  }
}

decision = response["verdict"]["action"]

if decision == "clear":
    continue_only_if_local_policy_passes()
elif decision == "caution":
    require_review()
else:
    block_execution()