User's data
Authenticated user scope (JWT): aggregator/proxy endpoint returning address, balances, IBANs, signers, transactions, KYC status and address book.
Related endpoints (authenticated user)
These routes return additional user-scoped data. All require Authorization: Bearer <access_token>.
| Data | Endpoint | Documentation |
|---|---|---|
| Wallet addresses (per signer, all chains, Safe modules) | GET /v1.2/users/me/address | Addresses |
| Monitored tokens (per chain) | GET /v1.2/users/me/tokens | Tokens |
| Token balances | GET /v1.2/users/me/balances | Balances |
| IBANs linked to the user's safes | GET /v1.2/users/me/ibans | IBANs |
| Available lending pools | GET /v1.2/users/me/lending | Lending |
| DeFi positions (AAVE, Morpho, Hyperliquid) | GET /v1.2/users/me/pools | Pools |
| Signers (passkeys / EOA) | GET /v1.2/users/me/signers | Signers |
| Transaction history | GET /v1.2/users/me/transactions | Transactions |
| Unified address book | GET /v1.2/users/me/addressbook | Address Book |
GET and POST /v1.2/users/me
GET /v1.2/users/me
Aggregator endpoint. It proxies the authenticated user sub-routes and returns a compact response: section payloads are directly exposed at top-level keys.
Proxied sections (7):
GET /v1.2/users/me/addressGET /v1.2/users/me/balancesGET /v1.2/users/me/ibansGET /v1.2/users/me/signersGET /v1.2/users/me/transactionsGET /v1.2/users/kyc/statusGET /v1.2/users/me/addressbook
Not included in the aggregator (call separately for performance):
GET /v1.2/users/me/lending— DeFi lending positionsGET /v1.2/users/me/pools— DeFi positions across AAVE, Morpho, HyperliquidGET /v1.2/safes/vaults— DeFi vault/pool catalog
When one or more sections fail, an optional errors object is added:
errors.<section> = { status, message }- Failed sections are omitted from top-level section keys
Example (aggregated 200):
Example (partial failure):
POST /v1.2/users/me
Stores arbitrary flat key/value data for the authenticated user. Identity is taken from the JWT — any user identifier in the body is ignored.
| Key prefix | Behaviour |
|---|---|
private.* | Stored; not returned on GET /v1.2/users/me |
| Other keys | Public for the user; returned inside userdata on GET |
audit.* | Reserved — stripped from client payloads; the API manages audit metadata (e.g. IP / user-agent history) |
Request body:
Response: { "success": true }
Authorization
AuthorizationRequiredBearer <token>In: header
Default Response
Authorization
AuthorizationRequiredBearer <token>In: header
Request Body
application/jsonRequireddataRequiredobjectFlat key/value map. Keys prefixed with private. are stored but never returned by GET.
Default Response