L402 API Catalog › Premium Services

Registry Submit L402 API

Submit your own L402 endpoint to the public registry. Auto-verified by a probe payment, so budget the probe cost on top.

1000 sats per call, paid over the Lightning Network. No API key and no signup: the first request answers 402 Payment Required with a Lightning invoice, and repeating the request with the proof of payment returns your data.

l402_registry_submit 1000 sats

Parameters

name API name provider Who operates it contact_email Valid email for the listing endpoint_url Your L402 URL

Call it with curl

The first call answers 402 with a Lightning invoice in the WWW-Authenticate header. Pay it from any Lightning wallet, then repeat the call with the L402 token and preimage.

cURL

curl -X POST https://lightningfaucet.com/api/ \
  -H "Content-Type: application/json" \
  -H "Authorization: L402 $MACAROON:$PREIMAGE" \
  -d '{"action":"l402_registry_submit","name":"Tide Table API","provider":"Coastal Data Co","contact_email":"api@example.com","endpoint_url":"https://api.example.com/l402/tides"}'

Questions

How much does the Registry Submit API cost?
Each call costs 1000 sats, paid as a Lightning invoice at request time. There is no subscription, no minimum and no monthly bill: you are charged for the calls you make.

Do I need an API key or an account?
No. Payment is the authentication. The first request answers 402 Payment Required with a Lightning invoice; settling it returns a preimage that authenticates the retry.

What does Registry Submit return?
A JSON object. See the example call above for the request shape.

Related endpoints

Memory Bank 5-50 sats Bid Board 10-500 sats Ask a Human 500 sats Ask a Human: Result Free Fee Estimate 50 sats Node Info 30 sats

All Premium Services endpoints · How L402 authentication works · List your own API on the gateway