toadlyBroodle/satring

Satring helps AI agents and developers discover paid API services that accept payments via the L402 protocol (Bitcoin Lightning), the x402 protocol (USDC on Base), or the Machine Payments Protocol (Stripe/Tempo). Browse the curated directory, submit your service, and let agents find you.
**▶ Watch the 3-minute demo**
Why
AI agents can now pay for APIs autonomously using Lightning, USDC, or Stripe. But there's no good way to discover what's available. Satring is the only curated, health-monitored directory with human ratings across all three payment protocols.
Features
- **Stats landing page** with live directory metrics: protocol breakdown, category coverage, health status, growth
- Browse, search, and filter paid APIs by category, status, and protocol
- **Three-protocol support**: L402 (Bitcoin Lightning), x402 (USDC on Base), and MPP (Stripe/Tempo)
- Protocol checkboxes on submit/edit forms for multi-protocol services (e.g. L402+MPP)
- Submit services with payment gate (anti-spam), payable via L402, MPP, or x402
- Ratings and reputation system (also payment-gated via any protocol)
- Edit your listing with secure edit tokens
- Recover lost edit tokens via domain verification (.well-known/satring-verify)
- Shared edit tokens across same-domain services; one token manages all your listings
- JSON API for programmatic access and agent queries
- **Daily free API quota** (10 results/IP/day) with unlimited access via paid bulk endpoint
- Premium endpoints (bulk export, analytics, reputation) gated via L402, MPP, or x402
- Per-service health analytics: uptime percentage, average latency, probe history
- Health probing with automatic protocol detection (L402, x402, MPP, or any combination)
- Service status tracking (live / confirmed / down / unverified)
- Anti-scraping protection with IP-based daily quotas and permanent bans
Quick Start
Open http://localhost:8000
In test mode (AUTH_ROOT_KEY=test-mode), all payment gates are bypassed.
API
Full interactive docs at satring.com/docs.
Free endpoints
Free endpoints return up to 10 results per IP per day. For unlimited access, use the payment-gated /services/bulk endpoint.
Payment-gated endpoints
These require payment via **L402**, **MPP** (Lightning), or **x402** (USDC). Without auth headers, the server returns 402 with challenges for all configured protocols.
Each service requires 1 to 2 category_ids: 1=ai/ml, 2=data, 3=finance, 4=identity, 5=media, 6=social, 7=search, 8=storage, 9=tools.
Option A: L402 (Lightning)
Option B: MPP (Lightning via Payment auth scheme)
The MPP flow: hit the endpoint without auth to get a 402 with WWW-Authenticate: Payment containing a BOLT11 invoice, pay via Lightning, then retry with Authorization: Payment containing the preimage. See the MPP spec for full details.
Option C: x402 (USDC on Base)
Multi-protocol listings
A single service can support multiple payment rails. Use + to combine protocols (e.g. L402+x402, L402+MPP, x402+MPP, L402+x402+MPP) and include the required fields for each:
Multi-protocol services appear in search results when filtering by any of their constituent protocols.
MPP-only listing
MPP fields: mpp_method (required: "tempo", "stripe", "lightning", "custom"), mpp_realm (optional), mpp_currency (optional).
Other gated operations
Token recovery
If you lose your edit token, or want to edit a pre-seeded endpoint, prove domain ownership to get a new one: