API Documentation

All API requests are authenticated via Bearer tokens issued through the ChainGuard developer portal. Tokens are scoped per-environment and rotate on a configurable schedule.

curl -X POST https://api.chain-guard.io/v1/screen \
  -H "Authorization: Bearer cg_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x...","network":"ethereum"}'

Submit a wallet address to receive a structured risk assessment including risk score, matched categories, and exposure breakdown across sanctions and illicit-finance datasets.

POST /v1/screen
{
  "address": "0x742d...C2E",
  "network": "ethereum"
}

→ 200 OK
{
  "verification_id": "CG-A3F9-K2B7-M8X1",
  "risk_score": 0,
  "risk_level": "low",
  "categories_checked": [
    "ofac_sanctions",
    "darknet_markets",
    "money_laundering",
    "tumbling_services",
    "chain_hopping"
  ],
  "matches": [],
  "screened_at": "2026-07-28T14:32:00Z"
}

Register webhook endpoints to receive real-time notifications when a monitored wallet's risk profile changes or a new transaction triggers an alert.

POST /v1/webhooks
{
  "url": "https://your-app.com/webhooks/chainguard",
  "events": ["risk.change", "alert.created"],
  "secret": "whsec_••••"
}

Official SDKs for JavaScript, Python, and Go. Integrate screening into onboarding flows, transaction pipelines, or batch compliance jobs with minimal code.

import { ChainGuard } from "@chainguard/sdk";

const cg = new ChainGuard({ apiKey: process.env.CG_KEY });
const result = await cg.screen({
  address: "0x742d...C2E",
  network: "ethereum"
});
console.log(result.risk_level); // "low"