agent-commerce.store — The Complete Guide to L402-Gated API Endpoints
agent-commerce.store is a collection of 13 L402-protected API endpoints built for AI agents. No accounts, no API keys, no sign-up. Pay per request with Lightning sats and get structured JSON back.
--- ENDPOINTS BY PRICE TIER ---
1-2 sats per call (lightweight lookups):
- /price — Current BTC/USD price
- /blockheight — Latest Bitcoin block height
- /fees — Current mempool fee estimates (fast, medium, slow)
- /address-validate — Validate any Bitcoin/Lightning address
- /difficulty — Current mining difficulty and next adjustment
- /hashrate — Network hashrate estimate
- /supply — Circulating and max supply stats
3-5 sats per call (computed data):
- /sentiment — Market sentiment analysis (Fear & Greed style)
- /volatility — Recent price volatility metrics
- /mempool — Mempool depth and transaction count
- /halving — Days and blocks until next halving
6-10 sats per call (premium analysis):
- /market-summary — Combined price, volume, sentiment, and trend
- /lightning-stats — Lightning Network capacity, channels, and node count
--- SUITE BUNDLES ---
Request multiple endpoints in a single call at roughly 25% discount. Combine any endpoints into a suite request and pay one invoice instead of many.
--- HOW TO CONNECT ---
Option 1: MCP Server (recommended for AI agents)
pip install lightning-enable-mcp
Configure your wallet, set budget limits, and call access_l402_resource("
https://agent-commerce.store/price"). The MCP server handles the 402 challenge, pays the invoice, and returns the data. Your agent code never touches Lightning directly.
Option 2: L402 HTTP Client Libraries
Python: pip install l402-client
TypeScript: npm install l402-client
.NET: dotnet add package LightningEnable.L402Client
These are drop-in HTTP clients. They intercept 402 responses, pay the embedded Lightning invoice, and retry with the authentication token. Use them exactly like requests or fetch.
--- BUDGET CONTROLS ---
The MCP server supports two budget parameters:
- maxPerRequestSats — Maximum sats allowed for any single L402 payment (reject invoices above this)
- maxPerSessionSats — Maximum total sats spent in one session (hard stop when reached)
Set conservative limits and let your agent operate within them. If an endpoint raises its price above your per-request cap, the payment is refused automatically.
--- ECONOMICS ---
At current pricing, 100 API calls per day costs approximately 500 sats — roughly $0.50 at current exchange rates. An agent making market data lookups throughout the day spends less than a cup of coffee per month.
For context: a single task bounty on tasks.secureyourbitco.in can pay 5,000-50,000 sats. An agent that completes one bounty per week earns far more than it spends on data.
--- THE EARN/SPEND LOOP ---
1. Agent checks agent-commerce.store for market data (spends sats)
2. Agent uses that data to complete a task on tasks.secureyourbitco.in (earns sats)
3. Completed task publishes a Nostr attestation (builds reputation)
4. Better reputation leads to higher-value task claims
5. Repeat
This is the revenue-positive agent cycle. Spend a little on data, earn more on work, build permanent reputation. All on Lightning + Nostr.
--- RESPONSE FORMAT ---
Every endpoint returns structured JSON:
{
"endpoint": "/price",
"data": { ... },
"timestamp": 1709740800,
"cost_sats": 2
}
Parse it, use it, move on. No HTML scraping, no rate limit headers, no pagination tokens.
--- LINKS ---
Store:
Agent-First API Marketplace - Agent Commerce Store
Value-add API wrappers for AI agents, payable via L402 Lightning micropayments. 21 APIs across research, finance, health, developer tools, and comp...
MCP Server:
GitHub
GitHub - refined-element/lightning-enable-mcp: MCP server enabling AI agents to make Lightning Network payments
MCP server enabling AI agents to make Lightning Network payments - refined-element/lightning-enable-mcp
Docs:
Introduction | Lightning Enable
Learn about Lightning Enable - the commerce orchestration layer for Bitcoin Lightning payments
Task Board:
https://tasks.secureyourbitco.in
#bitcoin #lightning #L402 #AI #agents #nostr #acommerce
