Developers

Quick start

Use HTTPS GET to fetch a single address score on a chain. Replace the sample address and chain query param.

curl "https://api.agent-score.xyz
/v1/score/0xYourAddress?chain=base"

Python example

For backends or cron jobs; set sensible timeouts and retries.

import requests

def get_agent_trust(address: str, chain: str = "base") -> float:
    r = requests.get(
        f"https://api.agent-score.xyz
/v1/score/{address}",
        params={"chain": chain},
        timeout=15,
    )
    r.raise_for_status()
    return r.json()["total_score"]

Common API paths

Read-only JSON endpoints (add rate limiting at the edge in production).

• GET /v1/score/{address}?chain=base — score + protocol breakdown
• GET /v1/leaderboard?chain=base&limit=50 — leaderboard
• GET /v1/explorer — recent indexing activity (demo stream)
• GET /v1/snapshots/latest?format=json|csv — full snapshot export

Open data & audit export

Buttons save files locally (blob download), unlike opening the API URL directly in a tab.

Local & ops commands (repo root)

Typical commands; see README / .env.example in your clone for details.

# API (example)
python -m uvicorn backend.api.main:app --host 0.0.0.0 --port 8000

# Frontend
cd frontend && npm ci && npm run build

# Docker (repo root)
docker compose up --build