Update a wallet
Update a wallet’s mutable presentation fields. Only label is mutable; send an empty string to clear it. Serves both fiat and custodial wallets by their shared wlt_ id, matching getWallet.
Authorizations
Token from POST /auth/token
Path Parameters
Wallet ID (wlt_ prefix; a wlt_fiat_ id is also accepted).
Body
Partial update for a wallet (fiat or custodial) — only label is mutable. Send an empty string to clear an existing label; omit the field to leave it unchanged.
Optional display label. An empty string clears the label.
Response
The request has succeeded.
- Crypto wallet
- Fiat wallet
The walletCrypto variant — one crypto asset on one network, held on the customer's behalf by the custody provider, currently "Coinme Inc.". address is the on-chain deposit address and is omitted until the provider reports one.
Wallet ID (TypeID; wlt_ for both crypto and fiat wallets; a wlt_fiat_ id is also accepted on input).
^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$The customer that owns this record.
Current wire status.
pending, active, frozen, suspended, closed The asset the wallet holds, lowercase: a crypto symbol (e.g. usdc) or a fiat currency (only usd today).
Claim/routing state: whether a live deposit address or virtual account currently receives into this wallet, or has in the past. Always present.
The legal entity holding this wallet's assets, derived from wallet type and asset: walletCrypto → "Coinme Inc."; walletFiat (usd) → "Erebor Bank, N.A.". New providers may be added, so treat the string as free-form rather than a fixed set.
Type discriminator.
walletCrypto Blockchain network the wallet operates on (canonical name, e.g. "polygon").
The partner-supplied label. Absent when none is set.
On-chain deposit address. Omitted when the provider has not reported one yet.