Routes, Paths, and Pricing

Structure how x402Nova reaches your API by configuring routes (base URLs) and paths (individual endpoints) with per-request pricing.

Route Document

{
  "endpoint": "https://api.partner.com/v1",
  "price": "0.05",
  "network": "base",
  "token": "USDC",
  "receivingWallet": "0xabc123…",
  "apiKey": "Bearer INTERNAL-KEY"
}

endpoint – Base URL; x402Nova appends downstream paths and query strings.
price – USD price, automatically converted to atomic units.
apiKey – String or header map forwarded with each proxied request.
receivingWallet – Where settled funds land (defaults available).

Path Overrides

{
  "name": "Fetch balances",
  "method": "GET",
  "pattern": "/accounts/:id/balance",
  "price": "0.15",
  "token": "USDC"
}

Each path inherits route defaults but can override method, pattern, and pricing for granular control.