Billing

Read the caller's Lightning wallet

The wallet's public facts. 202 while it is still minting. The first read of an active wallet whose pairing was never handed out answers 201 with pairing (once); later reads answer 200 with has_pairing: true and no secret.

get/agent/v1/lightning-wallet

Request

Base URL: https://api.run402.com
URL: https://api.run402.com/agent/v1/lightning-wallet
Auth: API key in header SIGN-IN-WITH-X

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Response

The wallet.

wallet_idstring required

status'minting' | 'active' | 'revoking' | 'revoked' | 'failed' required

network'regtest' | 'signet' | 'mainnet' required

custody'run402_hub' required

custody_notestring

lightning_addressstring nullable

budget_satsinteger required

starter_satsinteger required

has_pairingboolean required

pairingstring

The NWC pairing URI. Present exactly once; store it in the local profile and never send it to Run402.

pairing_claimed_atstring date-time nullable

failure_reasonstring nullable

created_atstring date-time required

activated_atstring date-time nullable

revoked_atstring date-time nullable

Example response

{
  "wallet_id": "lw_3f9c1e2b4d5a6f7081920a1b2c3d4e5f",
  "next_actions": [
    {
      "method": "POST",
      "path": "/tiers/v1/hobby",
      "auth": "x402"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.