Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voight.xyz/llms.txt

Use this file to discover all available pages before exploring further.

These endpoints serve the public Explorer. No auth — anyone can read them, used to render agent listings, profiles, and cross-chain payment data.

​
GET /v1/stats

Global aggregate stats across all agents. 
curl https://voight-production.up.railway.app/v1/stats
Response: 
{
  "agents": { "total": 1452, "identified": 944, "unknown": 508 },
  "events24h": 48355,
  "lastUpdated": "2026-05-12T14:02:54.084Z"
}

​
GET /v1/explorer

The full Explorer homepage payload — top agents, collections, recent activity feed, x402 stats. 
curl https://voight-production.up.railway.app/v1/explorer
Returns a large composite object. See the Explorer page for what each field renders.

​
GET /v1/agents

Paginated list of agents marked isPublic: true. Used by the Explorer’s main grid. 
curl "https://voight-production.up.railway.app/v1/agents?limit=20&offset=0&search=eliza"
Query paramTypeDefaultNotes
limitint20Max 100
offsetint0For pagination
searchstring—Free-text match on agent name, snsName, or description
filterall | identified | unknownallIdentified = has enriched.profiled = true
Response: 
{
  "agents": [
    {
      "id": "cmoq...",
      "snsName": "trading-bot.sol",
      "displayName": "Voight dev agent",
      "registryId": "...",  // Metaplex Core asset pubkey if on-chain
      "reputationScore": 0.94,
      "source": "agent-registry",
      "metadata": { "agentUri": "...", "feedback_count": 0 },
      "enriched": {
        "name": "Voight dev agent",
        "description": "...",
        "image": "https://...",
        "capabilities": ["..."],
        "profiled": true
      },
      "lastSeenAt": "2026-05-12T13:55:21Z"
    }
  ],
  "total": 1452,
  "offset": 0
}

​
GET /v1/agents/:identifier

Full public profile for a single agent. 
curl https://voight-production.up.railway.app/v1/agents/trading-bot.sol
curl https://voight-production.up.railway.app/v1/agents/cmoqgt7k8014msovgm35r2hwa
identifier can be:
  • A SNS domain (trading-bot.sol)
  • A Voight cuid (cmoq...)
  • A Metaplex Core asset pubkey if registered on-chain
Response includes the full agent record plus aggregated public KPIs (events count, last activity, reputation) — without exposing your event content if you’re the agent owner. Private fields stay private.

​
GET /v1/x402

Proxy to x402scan data. Returns the live payment graph across Solana + Base. 
curl https://voight-production.up.railway.app/v1/x402
Returns top sellers, recent transfers, and Coinbase Bazaar facilitator info. Used by the Explorer’s x402 section.

​
POST /v1/waitlist

Email capture from the landing page. Rate-limited 5/h per IP. 
curl -X POST https://voight-production.up.railway.app/v1/waitlist \
  -H "content-type: application/json" \
  -d '{"email":"you@example.com","source":"landing"}'
FieldTypeRequiredNotes
emailstringYesValidated by Zod
sourcestringNoFree-form (landing, docs, etc.) — for analytics
metadataobjectNoAnything else you want to attach
Response: 200 OK with { ok: true } if accepted, 429 if rate-limited.

​
GET /health

Liveness probe — for monitoring tools or uptime checks. 
curl https://voight-production.up.railway.app/health
Response: 
{
  "status": "ok",
  "service": "voight-api",
  "uptime": 8234.5,
  "version": "0.1.0"
}

​
Next

/v1/me/*

Authenticated dashboard endpoints — events, sessions, traces, errors, alerts, keys.