One call. Every x402 endpoint.

Don't pick endpoints yourself. Prefer strategy: "auto" — it follows live route share on /leaderboard, blended with value and settle. One POST, done.

// Gateway — market auto (route-share × value × settle)
const res = await fetch("https://clearedindex.com/api/cleared/gateway", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    category: "identity",
    strategy: "auto", // recommended — follows live /leaderboard share
    maxPrice: 0.50,
    minScore: 70, // recommended — filters fragile endpoints
  }),
});
const { route } = await res.json();
// route.payTo — pay directly via x402
// route.avgLatencyMs / route.sigma / route.canaryStatus — live signals when sampled
if (route) {
  const payment = await pay(route.payTo, route.totalCost);
}

Portable beforePay + CI gate. Abort when payToMismatch or Check fails. Full kit: clearedindex.com/drop-in.

// Abort if Check fails or payTo mismatches
const { pass, score, payToMismatch } = await fetch(
  "https://clearedindex.com/api/cleared/check?origin=" + origin + "&probe=false"
).then((r) => r.json());
if (!pass || payToMismatch) throw new Error("Cleared abort");

// CI — .github/actions/cleared-gate
// - uses: ./.github/actions/cleared-gate
//   with: { origin: "https://api.example.com", min-score: "70" }

Check + Certified Hash

If you already know the endpoint, verify it and get a certified hash. The hash is your receipt — use it for arbitration if anything goes wrong.

// Check — verify before you pay
const res = await fetch(
  "https://clearedindex.com/api/cleared/check?origin=https://api.example.com&certify=certified"
);
const { pass, score, certifiedHash } = await res.json();
if (pass) proceed();
// certifiedHash is your receipt if anything goes wrong

TypeScript — Direct Index Access

// cleared.ts — drop into any agent
const CLEARED_GATEWAY = "https://clearedindex.com/api/cleared/gateway";

export async function routeCleared(category: string, opts?: {
  strategy?: string;
  maxPrice?: number;
  minScore?: number;
}) {
  const res = await fetch(CLEARED_GATEWAY, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      category,
      strategy: opts?.strategy ?? "auto",
      maxPrice: opts?.maxPrice,
      minScore: opts?.minScore ?? 70,
    }),
  });
  const data = await res.json();
  return data.routed ? data.route : null;
}

Python

# Gateway integration — Python
import httpx

def gateway_route(category: str, strategy: str = "auto", max_price: float = None):
    body = {"category": category, "strategy": strategy, "minScore": 70}
    if max_price:
        body["maxPrice"] = max_price
    res = httpx.post("https://clearedindex.com/api/cleared/gateway", json=body)
    data = res.json()
    if data.get("routed"):
        return data["route"]
    return None

# Check + certify
def cleared_check(origin: str, certify: str = "basic"):
    res = httpx.get(f"https://clearedindex.com/api/cleared/check?origin={origin}&certify={certify}")
    return res.json()

cURL — Full API Surface

# Gateway — auto (market route-share; minScore 70 recommended)
curl -X POST https://clearedindex.com/api/cleared/gateway \
  -H "Content-Type: application/json" \
  -d '{"category": "identity", "strategy": "auto", "minScore": 70}'

# Check with certified hash
curl "https://clearedindex.com/api/cleared/check?origin=https://api.example.com&certify=certified"

# Watchlist — subscribe to score changes
curl -X POST https://clearedindex.com/api/cleared/watchlist \
  -H "x-cleared-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin": "https://api.example.com", "webhookUrl": "https://your-app.com/webhook"}'

# Route-share market (powers strategy=auto)
curl "https://clearedindex.com/api/cleared/leaderboard?period=7d&category=identity"

# Sigma score
curl "https://clearedindex.com/api/cleared/sigma?origin=https://api.example.com"

System Prompt Snippet

Drop this into your agent's system prompt. It tells the agent to route through Gateway, certify with hashes, and file disputes when things go wrong.

# Add to your agent's system prompt:
Before paying any x402 endpoint, route through Cleared Gateway:
  POST https://clearedindex.com/api/cleared/gateway
  {"category": "...", "strategy": "auto"}

Or via MCP: call tool route_gateway on @n747ai/clearedindex-mcp-server
  (prefer strategy=auto — follows live route share on /leaderboard)

The Gateway returns the best verified endpoint. Pay it directly via x402.
If you already know the endpoint, verify it first:
  GET https://clearedindex.com/api/cleared/check?origin=<URL>&certify=certified

Save the certifiedHash — it's your receipt if anything goes wrong.
File disputes at: POST https://clearedindex.com/api/cleared/arbitration

Badges

![Cleared](https://clearedindex.com/api/cleared/badge?slug=YOUR-SLUG)

![Powered by Cleared Gateway](https://clearedindex.com/api/cleared/gateway/badge)

Full API Surface