Get a single wallet
Returns one wallet with its balances. Balances come from a cache. When one is missing or older than 5 minutes, Gravv queues a refresh and returns without waiting for it.
Gravv tracks balances for USDC on every listed network, USDT on polygon, ethereum, avalanche and solana, and the network's own coin.
Path Parameters
Wallet ID
Responses
| Status | Description |
|---|---|
200 |
The wallet and its balances |
400 |
The request failed. An unknown ID, or another tenant's wallet, returns wallet not found. |
200 response
Balances from the cache, USDC first. A missing asset means it has not been read yet, not that the balance is zero.
Asset symbol
Balance in whole units, as a decimal string
Number of decimal places for this asset
When the balance was last read on-chain. The API leaves it out when it is not known.
True when the balance is older than 5 minutes. Gravv has queued a refresh, so read the wallet again in a few seconds. The API leaves it out when false.
{
"data": {
"id": "2d52eb6d-4fac-44db-a225-d0e6aa13b0e3",
"address": "GDZQAF4A2E5VZMMQVW7XG4FKWZ5KDSUEZF5VQBDQVM53TMU2YLE54NTX",
"network": "stellar",
"name": "my wallet",
"date_created": "2026-10-12T09:14:03Z",
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"wallet_type": "customer",
"assets": [
{
"symbol": "USDC",
"balance": "25.5000000",
"decimals": 7,
"updated_at": "2026-10-12T09:20:00Z"
},
{
"symbol": "XLM",
"balance": "1.5000000",
"decimals": 7,
"updated_at": "2026-10-12T09:20:00Z",
"stale": true
}
]
},
"error": null
}
400 response
{
"data": null,
"error": "wallet not found"
}
Authorization
- ApiKeyAuth