Update the wallet
Rename your wallet.
Only the name changes here. Everything else comes from the wallet's keys, and creating, restoring or deleting a wallet takes a person signed in to the dashboard, where any recovery phrase stays in their browser.
Body
namestringFrom 2 to 40 characters, shown in the dashboard.
Errors
- 400
invalid_requestA field is missing, unknown or out of range.fieldnames it. - 404
not_foundYour business has no wallet yet.
Any request can also fail on its key or its body. See errors.
Request
curl -X PATCH "https://wallet.402pay.co/api/v1/wallet" \ -H "Authorization: Bearer $PAY402_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Treasury" }'Response200 OK
{ "data": { "id": "wal_1fIGZOrILmsCO0jw", "kind": "wallet", "name": "Treasury", "source": "created", "total_value_usd": "96692.79", "pending_value_usd": "0.00", "balances": [ { "asset": "USDT", "network": "tron", "amount": "22995.72", "pending_amount": "0.00", "price_usd": "1.00", "value_usd": "22995.72", "pending_value_usd": "0.00" }, { "asset": "BTC", "network": "bitcoin", "amount": "0.17992045", "pending_amount": "0.00000000", "price_usd": "98400.00", "value_usd": "17704.17", "pending_value_usd": "0.00" }, { "asset": "LTC", "network": "litecoin", "amount": "139.41348214", "pending_amount": "0.00000000", "price_usd": "112.00", "value_usd": "15614.31", "pending_value_usd": "0.00" }, { "asset": "TRX", "network": "tron", "amount": "41250.50", "pending_amount": "0.00", "price_usd": "0.32", "value_usd": "13200.16", "pending_value_usd": "0.00" }, { "asset": "SOL", "network": "solana", "amount": "47.4820", "pending_amount": "0.0000", "price_usd": "184.00", "value_usd": "8736.69", "pending_value_usd": "0.00" }, { "asset": "USDC", "network": "solana", "amount": "7099.29", "pending_amount": "0.00", "price_usd": "1.00", "value_usd": "7099.29", "pending_value_usd": "0.00" }, { "asset": "USDC", "network": "ethereum", "amount": "6177.58", "pending_amount": "0.00", "price_usd": "1.00", "value_usd": "6177.58", "pending_value_usd": "0.00" }, { "asset": "ETH", "network": "ethereum", "amount": "0.836580", "pending_amount": "0.000000", "price_usd": "3620.00", "value_usd": "3028.42", "pending_value_usd": "0.00" }, { "asset": "USDC", "network": "base", "amount": "1250.40", "pending_amount": "0.00", "price_usd": "1.00", "value_usd": "1250.40", "pending_value_usd": "0.00" }, { "asset": "USDT", "network": "ethereum", "amount": "886.05", "pending_amount": "0.00", "price_usd": "1.00", "value_usd": "886.05", "pending_value_usd": "0.00" } ], "main_addresses": { "ethereum": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86", "base": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86", "solana": "2YJtPr25BcbApPPAXHyAu9USMS3z8KSepTbBx9N3YMgp", "tron": "TFtTqBsPS39pnxMaHVzKHYuCurEgof2wDG", "bitcoin": "bc1qp932jy8gqh9zn62ef2azjnh5gpvk0hv40jfmpx", "litecoin": "ltc1qgznwwx88tuy5fe2pm97mjyfa2tq6ug6udflajg" }, "address_counts": { "evm": 118, "tron": 37, "bitcoin": 24, "litecoin": 19, "solana": 46 }, "pending_change": null, "created_at": "2026-05-09T21:22:00.813Z" }}