# satring

> Curated paid API directory for AI agents. L402 + x402 + MPP.

Satring is a curated directory of paid API services: APIs that accept payments via Lightning (L402), USDC on Base (x402), or Stripe/Tempo (MPP).
AI agents use satring to find and connect to paid APIs autonomously via MCP.
Humans use it to discover, rate, and submit services.

- [Stats](https://satring.com/): Live directory metrics, protocol breakdown, category coverage
- [Browse directory](https://satring.com/directory): Search and filter services by category, status, protocol, rating
- [Submit a service](https://satring.com/submit): List your paid API (L402, MPP, or x402 payment required)
- [API docs](https://satring.com/docs): OpenAPI/Swagger interactive documentation
- [JSON API](https://satring.com/api/v1/services): Programmatic access to the catalog

## API

### Free tier (5 summaries/day per IP)
Free endpoints return thin summaries: name, protocol, price, rating, categories.
Summaries do NOT include service URLs, descriptions, or payment config.

- [List services](https://satring.com/api/v1/services): GET — paginated summaries, filterable by category, status, protocol
- [Search](https://satring.com/api/v1/search?q=example): GET — search summaries across names
- [Service detail](https://satring.com/api/v1/services/{slug}): GET — service summary
- [Ratings](https://satring.com/api/v1/services/{slug}/ratings): GET — paginated reviews (no quota)

### Paid endpoints (full metadata with URLs)
Pay via L402 (Lightning), MPP (Lightning), or x402 (USDC on Base) to access full service data.

- [Bulk export](https://satring.com/api/v1/services/bulk): GET — all services with full metadata including URLs
- [Submit service](https://satring.com/api/v1/services): POST — create a new listing
- [Submit rating](https://satring.com/api/v1/services/{slug}/ratings): POST — rate a service
- [Analytics](https://satring.com/api/v1/analytics): GET — aggregate directory stats
- [Reputation](https://satring.com/api/v1/services/{slug}/reputation): GET — detailed service reputation report

### Owner endpoints (requires X-Edit-Token header)
Service owners can view aggregated traffic for their domain's listings.

- [Owner traffic](https://satring.com/api/v1/owner/{domain}/traffic): GET — free, aggregated hits across all domain services
- [Owner audience](https://satring.com/api/v1/owner/{domain}/audience): GET — paid, detailed audience analytics
- [Owner dashboard](https://satring.com/owner/{domain}?token=YOUR_TOKEN): Web UI dashboard

## Categories

- [ai/ml](https://satring.com/directory?category=ai-ml): Machine learning and AI inference APIs
- [data](https://satring.com/directory?category=data): Data feeds, aggregation, and analytics
- [finance](https://satring.com/directory?category=finance): Financial data, trading, and payment APIs
- [identity](https://satring.com/directory?category=identity): KYC, authentication, and verification
- [media](https://satring.com/directory?category=media): Image, video, and audio processing
- [search](https://satring.com/directory?category=search): Web search, indexing, and discovery
- [social](https://satring.com/directory?category=social): Social networks, communications, and notification APIs
- [storage](https://satring.com/directory?category=storage): File storage and content delivery
- [tools](https://satring.com/directory?category=tools): Developer tools, utilities, and infrastructure

## How to Pay

All paid endpoints return HTTP 402 with payment challenges in headers.
Three payment methods are supported (pick any one):

### L402 (Lightning)
1. Hit a paid endpoint; receive 402 with `WWW-Authenticate: L402 macaroon="...", invoice="..."`
2. Pay the BOLT11 Lightning invoice to get the preimage
3. Retry the request with `Authorization: L402 <macaroon>:<preimage>`
- Discovery: https://satring.com/.well-known/l402

### MPP (Machine Payments Protocol)
1. Hit a paid endpoint; receive 402 with `WWW-Authenticate: Payment ...`
2. Parse the challenge, pay the BOLT11 invoice to get the preimage
3. Build a credential JSON with paymentHash and preimage, base64url-encode it
4. Retry with `Authorization: Payment <base64url-credential>`
- Discovery: https://satring.com/.well-known/mpp

### x402 (USDC on Base)
1. Hit a paid endpoint; receive 402 with `PAYMENT-REQUIRED` header (base64 JSON)
2. Decode to get payTo address, amount, and network (Base mainnet)
3. Send USDC, then retry with `PAYMENT-SIGNATURE` header
- Discovery: https://satring.com/.well-known/x402