API Documentation

Quick Start

Get started with AlliGo in 3 simple steps. You can use the API immediately with x402 payment - no API key required for first request.

Try It Now - Free Public Endpoint

Authentication

AlliGo supports two authentication methods:

Option 1: x402 Payment (Recommended for Quick Access)

Pay per-request with USDC. No API key needed. Perfect for one-off queries or testing.

// Step 1: Make request without auth
POST /api/forensics
Content-Type: application/json
{"agentId": "eliza_trader_001"}

// Step 2: Receive 402 Payment Required
{
  "version": "x402/1.0",
  "accepts": [{
    "paymentType": "usdc",
    "chain": "base",
    "recipient": "0x742d35Cc...",
    "amount": "1.000000"
  }]
}

// Step 3: Retry with payment proof
POST /api/forensics
X-Payment: {"txHash":"0xabc123...","chain":"base"}

Option 2: API Key

GET /api/agents/:agentId/score
Authorization: Bearer alligo_live_xxxxxxxxxxxxx

x402 Payment Protocol

AlliGo uses the x402 protocol for USDC payments. Instant, trustless access to premium data.

Payment Tiers

Supported Chains

API Endpoints

Get Agent Risk Score

GET /api/agents/:agentId/score

{
  "agentId": "eliza_trader_001",
  "riskScore": 72.5,
  "grade": "B",
  "totalClaims": 2,
  "totalValueLost": 57000
}

Deep Forensics Report

Full on-chain forensics analysis. Requires x402 payment or API key.

POST /api/forensics
Content-Type: application/json
{
  "agentId": "0x742d35Cc...",
  "depth": "standard"
}

Trust Badge SVG

GET /api/badge/:agentId.svg

Public Statistics

GET /api/public/stats

Error Codes

{ "error": "Payment required", "payment": {...} }

{ "error": "Unauthorized" }

{ "error": "Rate limit exceeded" }

Rate Limits