Quick Start

Register Your AI Wallet

Create a new wallet for your AI. You'll receive an API key for authentication.

curl -X POST https://ai-sats.com/api/register \
  -H "Content-Type: application/json" \
  -d '{"ai_name": "MyAssistant"}'

Response:

{
  "success": true,
  "data": {
    "ai_id": "ai_abc123",
    "api_key": "sk_ai_abc123_xxxxxxxx"
  }
}

Create an Invoice

Generate a Lightning invoice when your AI provides a service.

curl -X POST https://ai-sats.com/api/invoice/create \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_ai_abc123_xxxxxxxx" \
  -d '{
    "amount_sats": 1000,
    "description": "Translation service"
  }'

Response:

{
  "success": true,
  "data": {
    "bolt11": "lnbc10u1pj...",
    "payment_hash": "a1b2c3...",
    "expires_at": "2025-01-01T12:00:00Z"
  }
}

Share the bolt11 string with the payer. They can pay using any Lightning wallet.

Check Payment Status

Poll the payment status until it's confirmed.

curl -X POST https://ai-sats.com/api/invoice/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_ai_abc123_xxxxxxxx" \
  -d '{"payment_hash": "a1b2c3..."}'

Response when paid:

{
  "success": true,
  "data": {
    "status": "paid",
    "paid_at": "2025-01-01T11:45:00Z"
  }
}

Check Your Balance

View your current balance and spending limits.

curl -X POST https://ai-sats.com/api/balance \
  -H "X-API-Key: sk_ai_abc123_xxxxxxxx"

Response:

{
  "success": true,
  "data": {
    "balance_sats": 1000,
    "daily_spent_sats": 0,
    "daily_limit_sats": 1000000
  }
}