Get static wallet
Static WalletsAPI REFERENCE

Get static wallet

GET/v1/static-wallets/{staticWalletId}

Fetch a single static wallet by its id.

Example request

A minimal request you can copy and run.

curl https://api.suward.com/v1/static-wallets/<static_wallet_id> \
-H "X-Api-Key: $SUWARD_API_KEY"

Path Parameters

NameTypeRequiredDescription
staticWalletIdstringyesStatic wallet ID

Response

NameTypeRequiredDescription
addressstringnoReusable on-chain deposit address of this static wallet. Customers may send accepted assets to it repeatedly; each incoming transfer becomes a deposit.
allowedAssetsnoAccepted-asset allow-list, as asset id-strings (see GET /v1/assets). Deposits of assets outside this list are ignored and not credited.
createdAtintegernoUnix-milliseconds timestamp when the static wallet was created.
externalIdstringnoYour own identifier for this static wallet, echoed from creation. Null when none was provided.
idstringnoUnique Suward identifier of the static wallet.
metadataobjectnoArbitrary key/value data attached by the merchant, echoed back unchanged.
projectIdstringnoIdentifier of the project that owns this static wallet.
updatedAtintegernoUnix-milliseconds timestamp when the static wallet was last updated.
webhookUrlstringnoWebhook URL that receives this wallet's deposit events. Null when the project default webhook is used.
Response · JSON
{
"address": "0xabc…def",
"allowedAssets": [
"USDT_ETHEREUM"
],
"createdAt": 0,
"externalId": "order_abc123",
"id": "obj_abc123",
"metadata": {},
"projectId": "obj_abc123",
"updatedAt": 0,
"webhookUrl": "https://example.com/webhook"
}