API reference
Everything in the directory is a plain JSON API — no key, read-only — so an agent can check a service, or a wallet, before it pays.
Base URL https://api.verantis.ai. All responses are JSON and include a data_generated_at timestamp for provenance. No authentication, no rate-limit key — it's a public read layer. Informational only; not financial advice.
Search the verified directory. All parameters optional.
| Param | Example | Meaning |
|---|---|---|
q | weather | Free-text over domain, name, description. |
verified | true | Only services that returned a valid live 402 challenge. |
max_price | 0.05 | Max live price, USD per call. |
chain | base | Settlement network (e.g. base, solana). |
protocol | x402 | Rail: x402 or mpp. |
limit | 20 | Result cap (default 20). |
curl "https://api.verantis.ai/v1/services?q=gas&verified=true&limit=5"
The full record for one domain — classification, live price, pay-to wallet, score breakdown, on-chain reputation, and uptime history. Extra endpoints for the same domain appear under other_records.
curl "https://api.verantis.ai/v1/services/vibesprings.net"
The pre-payment check: pass a recipient wallet and get its earned reputation before you send funds. Returns whether it's known, its tier, human-readable reasons, on-chain retention, and which services it fronts.
curl "https://api.verantis.ai/v1/check?pay_to=0x38C0..44C8"
{
"pay_to": "0x38c0…44c8",
"known": true,
"reputation": "established",
"reasons": ["217 distinct buyers in the last 90d, 83% repeat"],
"onchain": { "distinct_buyers": 217, "repeat_buyer_rate": 0.834,
"top_buyer_share": 0.257, "verdict": "distributed" },
"services_fronted": 1
}
Services grouped by the operator behind them — listings count, how many are verified, chains used, best reputation, and a neutral concentrated flag for operators fronting many listings.
curl "https://api.verantis.ai/v1/operators"
Index-level totals: endpoints, services, operators, verified count, price drift, and the rails covered.
curl "https://api.verantis.ai/v1/stats"
Verantis also ships a Model Context Protocol server — a thin client of this API — so any MCP-capable agent can query the directory as a tool. It exposes find_paid_service, get_service, and directory_stats. Point it at the API with the VERANTIS_API_BASE environment variable.
Fields describe what our probes and on-chain reads observed at a point in time and can change between checks. The API is read-only and informational — not financial, investment, or legal advice. See the methodology for how each field is measured.