Wallet

Wallet connection status

GET/api/v2/wallet/status

Whether a wallet is connected, what it granted, and what limit it reported. Never includes the credential.

Dashboard-only (merchant JWT).
With no connection ever made, responds { success: true, connected: false } and no connection object.
connected is true only while the connection is active. A broken or disconnected one still returns its connection block, with disconnect_reason, so the merchant can see what happened.

Authentication

Requires a dashboard session JWT in the Authorization: Bearer … header.

GET/api/v2/wallet/status

curl "https://api.trevi.cash/api/v2/wallet/status" --header "Authorization: Bearer $TREVI_JWT"

200Sample response

{
  "success": true,
  "connected": true,
  "connection": {
    "status": "active",
    "wallet_pubkey": "9a1c…",
    "granted_methods": [
      "make_invoice",
      "pay_invoice",
      "get_balance",
      "lookup_invoice"
    ],
    "granted_notifications": [
      "payment_received"
    ],
    "budget_unlimited": false,
    "budget_readable": true,
    "budget_total_sats": 100000,
    "budget_renewal_period": "daily",
    "connected_at": "2026-08-01T09:12:00.000Z"
  }
}

Was this page helpful?

Connect a wallet

Wallet overview