---
title: "Retrieves wallet summary"
method: GET
path: "/user/{address}/wallets"
tags: ["Wallet data endpoints"]
---

# Retrieves wallet summary

`GET /user/{address}/wallets`

Retrieves a detailed summary of wallet data for a given address. Supported addresses include EVM, Solana and Bitcoin. Authentication with an API key is required.

## Path parameters

- `address` string, required

## Query parameters

- `verbose` boolean
- `forceRefresh` number
- `walletFields` string

## Headers

- `Authorization` string, required

## Response `200`

Wallet data

- SerializedWalletBalance[]
  - `firstTx` string — The date of the first transaction in the wallet
  - `lastTx` string — The date of the most recent transaction in the wallet
  - `symbol` string — The symbol associated with the blockchain
  - `address` string — Blockchain address for the wallet
  - `type` string — Type of balance
  - `name` string — Human readable name associated with the token
  - `logoUrl` string — A URL to a logo associated with the token
  - `balance` string — A formatted string representing the wallet balance
  - `tokens` SerializedWalletToken[]
    - `symbol` string — The symbol associated with the blockchain
    - `address` string — Blockchain address associated with the wallet (for native value) or smart contract (for token values)
    - `type` string — Type of token
    - `name` string — Human readable name associated with the token
    - `logoUrl` string — A URL to a logo associated with the token
    - `balance` string — A formatted string representing the wallet balance
    - `balanceAmt` number — A number representing the wallet balance
    - `value` object
      - `marketUsd` string — Formatted market value of the token in USD
      - `marketUsdAmt` number — Market value of the token in USD
      - `marketPctChange24Hr` number — Percent change over the past 24 hours
      - `history` SerializedPriceHistory[]
        - `timestamp` string — Time associated with the floor price history value
        - `value` number — Value in native currency
      - `walletUsd` string — Formatted market value of the wallet in USD
      - `walletUsdAmt` number — Market value of the wallet in USD
  - `nfts` SerializedWalletNftCollection[]
    - `category` string — Type of collection
    - `collectionId` string — The ID of the collection, usually a contract address
    - `collectionImageUrl` string — The NFT collection image URL (if available)
    - `contractAddresses` string[]
    - `description` string — Description of the collection
    - `floorPrice` SerializedFloorPrice[]
      - `marketPlaceName` string — Marketplace name
      - `marketPctChange24Hr` number — Percent change over the past 24 hours
      - `history` SerializedPriceHistory[]
        - `timestamp` string — Time associated with the floor price history value
        - `value` number — Value in native currency
      - `value` number — Value in native currency
      - `valueUsd` string — Formatted floor UDS price of the NFT collection
      - `valueUsdAmt` number — Floor USD price of the NFT collection
    - `latestAcquiredDate` string — Date of most recent collection NFT acquired by this owner
    - `name` string — Collection name
    - `nftIds` string[]
    - `ownedCount` number — Number of NFTs in the collection held by owner
    - `totalOwners` number — Total number of unique owner addresses for this collection
    - `totalSupply` number — Total number of NFTs in the collection
    - `totalValueUsd` string — Formatted USD floor price value of the collection NFTs held by this owner
    - `totalValueUsdAmt` number — Floor USD price value of the collection NFTs held by this owner
  - `txns` SerializedTxns
    - `data` SerializedTx[]
      - `hash` string — Transaction hash for the transaction
      - `block` string — Block ID
      - `value` number — Native value of the transaction
      - `gas` number — Gas consumed by the transaction
      - `method` string — Human readable label for the transaction (if available)
      - `link` string — Link to blockchain scanner
      - `success` boolean — Indicates transaction result was successful
      - `type` string — Type of transaction record (native or NFT)
      - `imageUrl` string — Preview URL associated with this transaction (if available)
      - `symbol` string — Ticker symbol or other identifier associated with the transaction
      - `description` string — Human readable description of the transaction
      - `from` object
        - `address` string — source address for transaction
        - `label` string — human readable label for address (if available)
        - `link` string — Link to blockchain scanner
      - `to` object
        - `address` string — source address for transaction
        - `label` string — human readable label for address (if available)
        - `link` string — Link to blockchain scanner
    - `cursor` string — Pointer to next page of paginated data
  - `totalValueUsd` number — Formatted aggregated market value of the wallet
  - `totalValueUsdAmd` number — Aggregated market value of the wallet
  - `walletType` string — Indicates the type of wallet associated with this address
  - `value` object
    - `marketUsd` string — Formatted market value of the token in USD
    - `walletUsd` string — Formatted market value of the wallet in USD
    - `walletUsdAmt` number — Market value of the wallet in USD

## Other responses

- `400` — Invalid address
- `404` — Address not found

---

[API](https://skmtc.net/unstoppabledomains/apis/profile-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/profile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/profile-api/versions/10f8400cb1c1/schema)