Resource catalog

One catalog for pages, data, APIs, and tools.

This page is the machine-friendly index for the gateway. It describes what each route returns, how it should be priced, and what kind of buyer is likely to use it.

The default paid entry points are Registry Lookup, Network Status / Verification, and Docs / Knowledge Excerpts. Everything else expands the catalog once the core payment loop is working.

Phase 1: default paid entry points

These are the first three routes agents should try by default: a registry lookup for exact metadata, a Base verification check for live state, and a premium docs excerpt for compact answers.

Agent Registry Lookup

Default
/gateway/api/agents/registry/lookup
  • Exact token, entity, and route metadata for agents
  • Highly structured and cheap enough for frequent reads
  • Best first purchase for registry validation loops

Base Network Status / Verification

Default
/gateway/api/agents/network/status
  • Live Base state check for trusted agent workflows
  • Easy to meter, easy to trust, easy to repeat
  • Great verification endpoint for freshness and uptime

Docs / Knowledge Excerpts

Default
/gateway/api/agents/docs/excerpts
  • Premium structured retrieval from docs and knowledge bases
  • Compact, machine-usable answers for agents
  • Good for caching, citations, and reuse

Build Quote / Project Scope Generator

Live
/gateway/api/agents/scope/quote
  • Turns requests into scoped estimates
  • Directly monetizable lead filter
  • Bridges agent intent to human revenue

Premium Workflow Execution

Live
/gateway/api/agents/workflows/execute
  • Summaries, checklists, plans, and checks
  • Higher-margin than simple data
  • Strong agent use case and upsell

How agents pay

The paid flow should be visible on the catalog page so crawlers can connect the route, the price, and the retry mechanism in one pass.

Discover the route

Read the catalog entry and manifest to see the exact endpoint, product name, and price.

Request a quote

Call the endpoint once without payment to receive the x402 quote and settlement details named by the manifest.

Pay

Settle in the quoted settlement asset, then keep the payment proof or reference for the next request.

Retry with proof

Retry the same request with x-alumni-payment and receive the protected payload.

Phase 2: catalog-ready products

These are specialized resources we should surface next so the catalog feels deep instead of narrow.

Contract Metadata

Ready
/gateway/api/agents/contracts/metadata
  • Smart contract identity and reference fields
  • Good basis for registry expansion
  • Useful for audits and agent lookup

Token Normalize

Ready
/gateway/api/agents/token/normalize
  • Normalize symbols, aliases, and identifiers
  • Very cheap structured helper
  • Fits agent preprocessing flows

Wallet Balance Verify

Ready
/gateway/api/agents/wallet/balance
  • Lightweight verification for account state
  • Good for eligibility or threshold checks
  • Easy micro-priced lookup

Wallet Holder Snapshot

Ready
/gateway/api/agents/wallet/holders
  • Who holds what, at a point in time
  • Useful for trust and distribution analysis
  • Best as a small batch product

Transaction Explain

Ready
/gateway/api/agents/tx/explain
  • Human-readable and machine-readable tx summary
  • Great for agents that need context
  • Pairs well with wallet activity

Phase 3: monetization depth

These are the first specialized products that should feel paid because they reduce labor or remove ambiguity.

Deployment Verify

Ready
/gateway/api/agents/deployments/verify
  • Confirm whether a deployment is real and current
  • Good trust primitive for agent workflows
  • Easy to meter by check

Route Health Check

Ready
/gateway/api/agents/routes/health
  • Endpoint status, latency, and availability
  • Useful for monitoring and retries
  • Good low-cost verification product

Gas Estimate

Ready
/gateway/api/agents/chain/gas
  • Native chain cost estimates for actions
  • Useful when agents need to plan settlement
  • Can be priced tiny and often

Address Risk Basic

Ready
/gateway/api/agents/address/risk
  • Minimal risk scoring for an address or wallet
  • Useful for screening and guardrails
  • Should be cheap and explicit

ABI Summary

Ready
/gateway/api/agents/abi/summary
  • Compact contract interface summary
  • Helps agents reason about capability quickly
  • Perfect structured-reference product

Phase 4: scale products

These are higher-value products that combine retrieval, reasoning, and packaged outcomes into a stronger purchase.

Docs Answer

Ready
/gateway/api/agents/docs/answer
  • Answer a question from the docs with citations
  • Higher-value than excerpt retrieval
  • Useful for support and agent tooling

Launch Readiness

Ready
/gateway/api/agents/launch/readiness
  • Check whether a project is ready to go live
  • Great packaged outcome product
  • Useful before human launch spend

Integration Plan

Ready
/gateway/api/agents/integration/plan
  • Turn a request into implementation steps
  • Bridge architecture to execution
  • Good monetizable synthesis product

Incident Triage

Ready
/gateway/api/agents/incidents/triage
  • Summarize an issue and propose the next action
  • High-value when someone is already in pain
  • Strong premium execution candidate

Evidence Pack

Ready
/gateway/api/agents/evidence/pack
  • Assemble proof, references, and supporting context
  • Helpful for trust, audit, or customer-facing reviews
  • Strong final-stage product

Phase 5: crypto and metals data

These routes give agents something they already need every day: current market prices, comparisons, triggers, and recurring watchlists.

Live Crypto Price Snapshot

Live
/gateway/api/markets/crypto/snapshot
  • BTC, ETH, SOL, and more
  • Quick, structured, and repeatable
  • Best micro-priced market feed

Live Gold / Silver Price Snapshot

Live
/gateway/api/markets/metals/snapshot
  • Gold and silver spot-style pricing
  • Useful for metals-focused agents
  • Easy comparison input

Cross-Asset Comparison

Live
/gateway/api/markets/cross-asset/comparison
  • Compare crypto and metals in one response
  • Useful for portfolio and quote logic
  • Good synthesis product

Threshold Alerts

Live
/gateway/api/markets/threshold/alerts
  • Check whether a target price is crossed
  • Good trigger primitive for agents
  • Works as a tiny paid check

Starter Watch / Budget Monitor

Subscription
/gateway/api/markets/watchlist/starter
  • Low-cost recurring monitoring and budget renewals
  • Best first repeat customer path
  • Small enough to buy, easy enough to renew

Watchlist / Recurring Monitor

Subscription
/gateway/api/markets/watchlist/monitor
  • Recurring monitoring and budget-based checks
  • Best for always-on agent workflows
  • Recurring revenue product

Volatility / Movement Summary

Live
/gateway/api/markets/volatility/summary
  • Compact movement view with directional signals
  • Useful for faster agent decisions
  • Easy to price and cache

Conversion / Quote Helper

Live
/gateway/api/markets/conversion/quote
  • Convert between crypto and metals
  • Useful for settlement planning
  • Small, frequent, valuable helper

Response rules

Keep the responses short, explicit, and structured so a client can act on them without human interpretation. The demo page should show this contract in motion.

Discovery-first

Public pages can describe the resource, but paid routes should answer with the price, the accepted asset, and the next request the client should make.

Machine-friendly

Prefer predictable field names, consistent status codes, and compact payloads that can be cached or replayed by an agent client.