Usage-based pricing

Price the request, the payload, or the outcome.

The gateway should start with small, agent-native prices. That keeps the public surface cheap to discover while letting high-value resources cover their own cost. These are proposed starting points, not hard limits.

Top 3 paid routes

These are the obvious buying entry points. Put them in front of agents first, then expand only after the flow is working.

Agent Registry Lookup

$0.35
/gateway/api/agents/registry/lookup
  • Exact token, entity, and route metadata
  • Small, frequent, structured lookup for agents
  • Best first purchase for registry validation

Base Network Status / Verification

$0.35
/gateway/api/agents/network/status
  • Live Base status for trusted agent workflows
  • Easy to meter, easy to repeat, easy to cache
  • Simple discovery buy for validation

Docs / Knowledge Excerpts

$2.00
/gateway/api/agents/docs/excerpts
  • Premium structured retrieval and reuse
  • Agents can cite, cache, and re-request it
  • Best immediate revenue route for knowledge buyers

Default upsell

Turn a one-off agent purchase into a recurring account.

Once Registry Lookup, Network Status, or Docs Excerpts prove fit, the next move is not to restart the sale. Move the buyer into Starter Watch / Budget Monitor first, then graduate them into Watchlist / Recurring Monitor or a larger budgeted access model so the spend can repeat automatically.

How agents pay

Pricing works best when the agent can see the unit, the retry path, and the settlement asset in one place.

Unit price

Each route declares a clear per-request, per-snapshot, per-excerpt, or per-month price.

x402 settlement

The payment flow is x402-first, with the current settlement network and asset named by the manifest and worker config.

Retry header

Agents retry the same request with x-alumni-payment after payment is attached.

Recurring budgets

Some products work best as monthly or budgeted access, especially the Starter Watch / Budget Monitor and the full Watchlist / Recurring Monitor.

Starting points

The numbers below are intentionally tiny where the data is simple and larger where the resource requires analysis or task execution.

Discovery

$0.00

Public summaries, route previews, and indexing content stay open so agents can qualify the resource before paying.

Micro Lookup

$0.00025 - $0.00060

Use for fast registry lookups, verification checks, and other tiny calls that may repeat many times.

Structured Intelligence

$0.001 - $0.004

Use for structured excerpts, token details, and compact knowledge responses that agents can cache.

Analysis

$0.008 - $0.015

Use for build quotes, scope generation, diagnosis, or richer synthesis that bridges intent to action.

Premium Execution

$0.02 - $0.03

Use for workflow execution, launch plans, evidence packs, and outcomes that save a real operator time.

Watchlist / Recurring Monitor

$49 - $199 / month

This is the default upsell after a route converts. Use it for continuous verification, hourly route checks, freshness alerts, and budgeted access that agents can renew automatically.

Market data family

Crypto and metals products should be cheap enough for repeated agent use, but explicit enough to support pay-and-retry behavior.

Live Crypto Price Snapshot

$0.25

Use for BTC, ETH, SOL, and similar fast market reads that agents call often.

Live Gold / Silver Price Snapshot

$0.35

Use for precious-metals snapshots when the agent needs XAU or XAG without browsing a chart site.

Cross-Asset Comparison

$1.25

Use for structured comparisons like BTC vs XAU or ETH vs silver when a synthesis step is needed.

Threshold Alerts

$1.50

Use for quick trigger checks against a price target or threshold, one small buy per check.

Watchlist / Recurring Monitor

$19 / month

Use for recurring watchlists, budget-based rechecks, and always-on agent workflows.

Conversion / Quote Helper

$0.50

Use when the agent needs a quick conversion between crypto, metals, or settlement reference values.

Suggested classes

Treat these as examples of the pricing grammar, not the final commercial policy.

Registry Lookup

Micro
$0.00025 to $0.00060 per call
  • Exact token and entity lookups
  • Fast enough for agent loops
  • Should be priced well below analysis

Docs / Knowledge Excerpts

Structured
$0.001 to $0.004 per excerpt
  • Compact answers for retrieval workflows
  • Enough context to cite or cache
  • Great fit for structured paywalls

Build Quote / Project Scope Generator

Analysis
$0.008 to $0.015 per request
  • Turns agent requests into scoped estimates
  • Filters low-value requests before human time is spent
  • Bridges to the next revenue step

Continuous Verification

Subscription
$49 to $199 per month
  • Hourly or budget-based monitoring for routes and freshness
  • Useful for alerts, status checks, and trust signals
  • Recurring spend that agents can keep renewing

These prices are modeled on small agentic purchases. The real gateway can attach a price to any route that deserves to be paid for by the request.