UUID Generator L402 API

Generate UUID v7 (time-ordered). Perfect for distributed ID generation.

5 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_uuid 5 sats

Parameters

count 1-10

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_uuid","count":5}'

What comes back

A successful call returns JSON, with the delivered content merged over the standard L402 receipt fields. Example values, not live data.

JSON

{
    "success": true,
    "http_code": 200,
    "service": "uuid",
    "timestamp": "2026-09-11T15:04:05+00:00",
    "paid_sats": 25,
    "uuids": [
        "019f2c41-8a3b-7c1d-9e04-5f6a7b8c9d0e",
        "019f2c41-8a3c-7f22-b510-6a7b8c9d0e1f",
        "019f2c41-8a3d-7a45-8c21-7b8c9d0e1f2a",
        "019f2c41-8a3e-7b68-9d32-8c9d0e1f2a3b",
        "019f2c41-8a3f-7c8b-ae43-9d0e1f2a3b4c"
    ],
    "count": 5,
    "version": 7
}

Call it from an AI agent

With lightning-wallet-mcp the payment is handled for you. From the CLI:

Terminal

lw pay-api "https://lightningfaucet.com/api/l402/uuid?count=5"

In Claude Code, Cursor or any MCP host, ask the agent to call pay_l402_api with that URL. The fee is 1% of the price, rounded down, so calls under 100 sats carry no platform fee.

Questions

How much does the UUID Generator API cost?
Each call costs 5 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 UUID Generator return?
A JSON object carrying uuids, count and version. See the example response above for the exact shape.

Related endpoints

Random Sats 50 sats Precise Time 10 sats Request Echo 5 sats Entropy 5-10 sats Ask a Human 500 sats Ask a Human: Result Free

All Utility APIs endpoints · How L402 authentication works · List your own API on the gateway