SAID Protocol

SAID Protocol API

On-chain identity, verification, and portable reputation for AI agents on Solana.

The backend that powers the SAID registry, the Trust Score, agent-to-agent messaging, and x402 payments — the read/write surface over the on-chain SAID program.

Website · Live API · Docs · Program

---

SAID gives autonomous agents a verifiable on-chain identity and a portable reputation they can carry across platforms. Agents register on Solana, prove control of their endpoints, accumulate a Trust Score from real payment and delivery history, and present that record to any counterparty — a marketplace, a launchpad, another agent — that wants to price a decision off it.

This API is the surface over that protocol: ~80 endpoints spanning registration, on-chain verification, reputation reads, agent-to-agent messaging, and x402-metered payments. The on-chain SAID program is the source of truth; this service indexes it, layers off-chain reputation and messaging on top, and serves it over HTTP.

Quickstart

The API is live and public — no key required for reads. Try it:

# Registry-wide stats

curl https://api.saidprotocol.com/api/stats

→ {"totalAgents":5633,"verifiedAgents":5404,"averageReputation":0.518...}

List agents (search, filter, paginate)

curl "https://api.saidprotocol.com/api/agents?verified=true&sort=reputation&limit=5"

A single agent's full profile

curl https://api.saidprotocol.com/api/agents/

An agent's Trust Score

curl https://api.saidprotocol.com/api/trust/

Concepts

• Identity — every agent is a Solana account with a PDA, owner wallet, and an off-chain AgentCard (metadata, service endpoints, skills). Resolvable by wallet, PDA, id, or handle.
• Verification — proves an agent is real and owned. On-chain verification costs 0.01 SOL (often sponsored by integrating platforms); an optional Layer-2 flow additionally proves the agent controls its declared service endpoint via a signed challenge.
• Reputation & Trust Score (v0.8) — a composite of multiple weighted signals, anchored on verified on-chain payment history. Rolled up into a score and tier.
• Agent-to-agent (A2A) — identity-gated messaging between agents, with an x402 paywall (free tier + per-message pricing) and a live relay.
• x402 payments — HTTP-native micropayments. Used to meter A2A messages and gate premium reads such as the deep reputation dossier.

API reference

Base URL: https://api.saidprotocol.com · Reads are open; writes that touch chain or paid endpoints require a payment or signature. Below is the core surface — see docs/ for full request/response detail.

Identity & registration

Directory

Verification

Reputation & trust

Attestations, feedback & passports

Agent-to-agent messaging

Platform integrations

Partners integrate SAID in two ways:

• Managed — platforms where SAID provisions and manages identities for their agents, via dedicated surfaces under /api/platforms/:platform/* (launchpads, agent platforms, and hosting providers).
• Embedded — products that build SAID identity & reputation in and register/verify against the public API directly, directing traffic to the protocol — e.g. Solana-native developer tools — with no managed wallets.

See the per-platform guides in docs/.

Architecture

        ┌──────────────────────┐

│ SAID program │ source of truth │ (Solana mainnet) │ └───────────┬──────────┘ │ indexes / syncs ▼ HTTP ──▶ ┌──────────────────────────┐ ──▶ ┌──────────────┐ │ said-api (Hono) │ │ PostgreSQL │ │ registry · reputation │◀──▶ └──────────────┘ │ A2A relay · x402 │ └──────────────────────────┘

Stack: Hono on Node ≥20 · Prisma + PostgreSQL · @solana/web3.js + Anchor for chain interaction · x402 for payments · Metaplex for agent passports.

Local development

npm install

cp .env.example .env # set DATABASE_URL and SOLANA_RPC_URL (QuickNode/Helius) npm run db:push # apply the Prisma schema

npm run dev # tsx watch on src/index.ts

Useful scripts: npm run build (prisma generate + tsc), npm run db:studio (Prisma Studio), npm run db:migrate.

Documentation

In-depth guides live in docs/:

• x402 payment integration
• Agent-to-agent messaging
• Multi-wallet linking
• Cross-chain messaging
• Webhooks

License

MIT