Wallets
Monitor a Stellar address for incoming payments. Products receive into a wallet.
The wallet object
idstringoptional | Unique identifier. |
namestringoptional | Label. |
addressstringoptional | Stellar public key (G...). |
network"TESTNET" | "PUBLIC"optional | Stellar network. |
status"ACTIVE" | "PAUSED"optional | Monitoring status. |
lastSyncAtstring | nulloptional | Last poll time. |
createdAtstringoptional | ISO 8601 timestamp. |
Watch a wallet
POST
/api/v1/walletsnamestringrequired | Label. |
addressstringrequired | Stellar public key. |
network"TESTNET" | "PUBLIC"required | Network. |
curl https://your-app.com/api/v1/wallets \ -H "Authorization: Bearer $STELLARHOOKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Treasury", "address": "GABC...XYZ", "network": "TESTNET" }'Only payments that arrive after the wallet is added are detected — we start watching from the latest ledger.
List, retrieve, delete
GET
/api/v1/walletsGET
/api/v1/wallets/{id}PATCH
/api/v1/wallets/{id}DELETE
/api/v1/wallets/{id}PATCH updates the name or status; DELETE stops monitoring.