Get User Wallet Summary by ID

Retrieves wallet summary information for a specific user, including stable currency token balances and native coin balance.

Request

GET /v2/users/users/{user_id}/wallet/summary

Parameters

Name	Type	In	Description
user_id	string	path	Required. The ID of the user to retrieve wallet summary for

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --location '\{\{baseUrl\}\}/v2/users/users/68ed406a81b27dad0cf2a5e2/wallet/summary' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6IjhmMzEwOWExLTYyMmMtNDVhZC1hYjI4LTg0ODE5N2ZiMDYwYSIsImV4cGlyYXRpb24iOjE3NjI5NDg5NTksInN1cGVydmlzb3JFbWFpbCI6InViZXJAYXBleC5jb20iLCJzdXBlcnZpc29ySUQiOiI2NjViMzcyZjNhNzJkN2QwNzkxNTk2YmEiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.OAK93_mbJET99ztAyvSbh2x-NY2wbR42dyaZZlPJyqs'

Response

{
    "stable_currencies": [
        {
            "currency_token": {
                "id": "68fb4de0d622a0564999aeb7",
                "node_id": "665ae536a6392b75cfd40352",
                "type": 1,
                "status": 3,
                "name": "DigitalOceanCoin",
                "symbol": "DGCN",
                "total_supply": 0,
                "description": "Digitalocean coin",
                "decimals": 6,
                "meta": {
                    "logo": {
                        "url": "https://fra1.digitaloceanspaces.com/apex/dev/currency-token/68fb4de0d622a0564999aeb7/logo/c92b945b-c846-442b-9019-888f3b4d39df.png"
                    }
                },
                "contract": {
                    "address": "0xd54549a98607c71cf67a4e0e83d84094971df3b7"
                },
                "is_active": false,
                "created_at": "2025-10-24T09:58:56.792Z",
                "updated_at": "2025-10-26T21:50:10.499Z"
            },
            "amount": 0
        },
        {
            "currency_token": {
                "id": "68fe8c129367fd414b227c7a",
                "node_id": "665ae536a6392b75cfd40352",
                "type": 1,
                "status": 3,
                "name": "IsCoin",
                "symbol": "ISCN",
                "total_supply": 17909.9995,
                "description": "Iscoin",
                "decimals": 6,
                "meta": {
                    "logo": {
                        "url": "https://fra1.digitaloceanspaces.com/apex/dev/currency-token/68fe8c129367fd414b227c7a/logo/426d406f-f5da-47f6-abee-ddad617000c5.png"
                    }
                },
                "contract": {
                    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
                },
                "is_active": false,
                "created_at": "2025-10-26T21:01:06.035Z",
                "updated_at": "2025-10-31T20:22:02.864Z"
            },
            "amount": 988.4805
        },
        {
            "currency_token": {
                "id": "6900a1fd2a4de1c5748e9dcc",
                "node_id": "665ae536a6392b75cfd40352",
                "type": 1,
                "status": 3,
                "name": "USD Coin",
                "symbol": "USDC",
                "total_supply": 0,
                "description": "Stablecoin pegged to USD on Holesky",
                "decimals": 6,
                "meta": {
                    "logo": {
                        "url": "https://s3.tokenizationtr.com/currencies/usdc.svg"
                    }
                },
                "contract": {
                    "address": "0x6810572a2e15fd1508b485b053417e9397e70f49"
                },
                "is_active": false,
                "created_at": "2025-10-28T10:59:09.752Z",
                "updated_at": "2025-10-28T10:59:09.752Z"
            },
            "amount": 0
        },
        {
            "currency_token": {
                "id": "6900a1fd2a4de1c5748e9dcd",
                "node_id": "665ae536a6392b75cfd40352",
                "type": 1,
                "status": 3,
                "name": "Tether USD",
                "symbol": "USDT",
                "total_supply": 0,
                "description": "Stablecoin pegged to USD on Holesky",
                "decimals": 6,
                "meta": {
                    "logo": {
                        "url": "https://s3.tokenizationtr.com/currencies/usdt.svg"
                    }
                },
                "contract": {
                    "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
                },
                "is_active": false,
                "created_at": "2025-10-28T10:59:09.76Z",
                "updated_at": "2025-10-28T10:59:09.76Z"
            },
            "amount": 3.384
        }
    ],
    "balance_native": 0.8006712018779228,
    "balance_native_symbol": "ETH",
    "balance_native_logo": "https://s3.tokenizationtr.com/currencies/eth.svg"
}

Response Fields

Field	Type	Description
stable_currencies	array	List of balances for stable currency tokens
stable_currencies[].currency_token	object	Currency token metadata object
stable_currencies[].currency_token.id	string	Unique identifier for the currency token
stable_currencies[].currency_token.node_id	string	ID of the node that owns this currency token
stable_currencies[].currency_token.type	integer	Currency token type
stable_currencies[].currency_token.status	integer	Currency token status
stable_currencies[].currency_token.name	string	Currency token name
stable_currencies[].currency_token.symbol	string	Currency token symbol
stable_currencies[].currency_token.total_supply	number	Total supply of the currency token
stable_currencies[].currency_token.description	string	Description of the currency token
stable_currencies[].currency_token.decimals	integer	Number of decimal places
stable_currencies[].currency_token.meta	object	Metadata for the currency token
stable_currencies[].currency_token.meta.logo	object	Logo information
stable_currencies[].currency_token.meta.logo.url	string	URL of the logo image
stable_currencies[].currency_token.contract	object	Contract information
stable_currencies[].currency_token.contract.address	string	Contract address on the blockchain
stable_currencies[].currency_token.is_active	boolean	Whether the currency token is active
stable_currencies[].currency_token.created_at	string	ISO 8601 timestamp when the currency token was created
stable_currencies[].currency_token.updated_at	string	ISO 8601 timestamp when the currency token was last updated
stable_currencies[].amount	number	Token balance amount for this currency token
balance_native	number	Native coin balance (e.g., ETH)
balance_native_symbol	string	Native coin symbol
balance_native_logo	string	Native coin logo URL

Status Codes

Status Code	Description
200	Success - Wallet summary retrieved successfully
401	Unauthorized - Invalid or missing authentication token
404	Not Found - User ID does not exist
500	Internal Server Error