API Reference

AI Agent Wallet API

Enable AI agents to make Lightning payments, manage balances, and interact with L402-protected APIs autonomously.

Quick Reference

Base URL: https://lightningfaucet.com/api/agents

Auth: Authorization: Bearer {api_key} or X-API-Key: {api_key}

Format: POST JSON with {"action": "...", ...params}

Available Actions

Public: ping, register

Operator (lf_*): get_balance, create_deposit, withdraw, transactions, agent_transactions, create_agent, list_agents, fund_agent, withdraw_from_agent, update_agent, regenerate_agent_key

Agent (agent_*): balance, l402_pay, pay_invoice, create_invoice, check_invoice, transactions, rate_limit

Example: L402 Payment

curl -X POST https://lightningfaucet.com/api/agents \
  -H "Authorization: Bearer agent_xxx" \
  -H "Content-Type: application/json" \
  -d '{"action": "l402_pay", "url": "https://api.example.com/data", "max_payment_sats": 100}'

OpenAPI Spec: https://lightningfaucet.com/ai-agents/docs/openapi.json