Documentation

ZapAds is a registry and payment rail for HTTP APIs. Providers run zapads-proxy in front of their backends; callers pay satoshis per request using L402 (HTTP 402 Payment Required, BOLT11 invoices, macaroons).

At a glance

  • Ship a service — run the proxy, set a price in sats, get paid per call.
  • Discover services — public JSON at /api/v1/services with X-ZapAds-Version: 1.
  • Pay per use — no subscriptions; agents handle 402 → pay → retry.

Sections

  • Quickstart — ship a service in about 15 minutes.
  • API reference — discovery endpoints (/api/v1/...) from the checked-in OpenAPI document.
  • L402 explained — what the status code, invoice, and macaroon mean.
  • For agents — integration guide mirroring /.well-known/zapads.md.

Principles

  • Pay per use — no subscription required to call a listed API.
  • Machine-readable first — discovery is JSON; agent docs are Markdown at /.well-known/zapads.md.
  • Privacy — this site does not load Google Analytics by default. Plausible is opt-in via env.