# Retrieves wallet summary

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.

Endpoint: GET /user/{address}/wallets
Version: 1.0.0

## Path parameters:

  - `address` (string, required)
    The address to retrieve wallet information. Supported addresses include EVM, Solana and Bitcoin.

## Query parameters:

  - `verbose` (boolean)

  - `forceRefresh` (number)
    Include a timestamp to indicate that caching should be avoided when rendering the response
    Example: 1707491939

  - `walletFields` (string)
    Comma separated list of wallet data fields to retrieve. Use this field to optimize performance and retrieve only the required data. Defaults, native,nft,token,tx.
    Example: "native,nft,stats,token,tx"

## Header parameters:

  - `Authorization` (string, required)
    The JWT access token that authorizes the request
    Example: "my-jwt-access-token"

## Response 200 fields (application/json):

  - `firstTx` (string)
    The date of the first transaction in the wallet
    Example: "2023-05-08T20:04:47.000Z"

  - `lastTx` (string)
    The date of the most recent transaction in the wallet
    Example: "2023-09-06T13:28:47.000Z"

  - `symbol` (string)
    The symbol associated with the blockchain
    Example: "MATIC"

  - `address` (string)
    Blockchain address for the wallet
    Example: 1.1706481464129065e+48

  - `type` (string)
    Type of balance
    Example: "native"

  - `name` (string)
    Human readable name associated with the token
    Example: "Polygon"

  - `logoUrl` (string)
    A URL to a logo associated with the token
    Example: "http://host.io/path/to/logo"

  - `balance` (string)
    A formatted string representing the wallet balance
    Example: 10

  - `tokens` (array)

  - `tokens.address` (string)
    Blockchain address associated with the wallet (for native value) or smart contract (for token values)
    Example: 1.1706481464129065e+48

  - `tokens.type` (string)
    Type of token
    Example: "erc20"

  - `tokens.balanceAmt` (number)
    A number representing the wallet balance
    Example: 10

  - `tokens.value` (object)

  - `tokens.value.marketUsd` (string)
    Formatted market value of the token in USD
    Example: "$2534.12"

  - `tokens.value.marketUsdAmt` (number)
    Market value of the token in USD
    Example: "$2534.12"

  - `tokens.value.marketPctChange24Hr` (number)
    Percent change over the past 24 hours
    Example: -1.74

  - `tokens.value.history` (array)

  - `tokens.value.history.timestamp` (string)
    Time associated with the floor price history value
    Example: "2024-02-14T13:00:00.000Z"

  - `tokens.value.history.value` (number)
    Value in native currency
    Example: 123

  - `tokens.value.walletUsd` (string)
    Formatted market value of the wallet in USD
    Example: "$100"

  - `tokens.value.walletUsdAmt` (number)
    Market value of the wallet in USD
    Example: 100

  - `nfts` (array)

  - `nfts.category` (string)
    Type of collection
    Example: "art"

  - `nfts.collectionId` (string)
    The ID of the collection, usually a contract address
    Example: 4660

  - `nfts.collectionImageUrl` (string)
    The NFT collection image URL (if available)
    Example: "https://path/to/collection/image"

  - `nfts.contractAddresses` (array)
    Example: [4660]

  - `nfts.description` (string)
    Description of the collection
    Example: "Collection description"

  - `nfts.floorPrice` (array)

  - `nfts.floorPrice.marketPlaceName` (string)
    Marketplace name
    Example: "OpenSea"

  - `nfts.floorPrice.valueUsd` (string)
    Formatted floor UDS price of the NFT collection
    Example: "$25.00"

  - `nfts.floorPrice.valueUsdAmt` (number)
    Floor USD price of the NFT collection
    Example: 25

  - `nfts.latestAcquiredDate` (string)
    Date of most recent collection NFT acquired by this owner
    Example: "native"

  - `nfts.name` (string)
    Collection name
    Example: "Unstoppable Domains"

  - `nfts.nftIds` (array)
    Example: ["0x1234/1"]

  - `nfts.ownedCount` (number)
    Number of NFTs in the collection held by owner
    Example: 10

  - `nfts.totalOwners` (number)
    Total number of unique owner addresses for this collection
    Example: 10

  - `nfts.totalSupply` (number)
    Total number of NFTs in the collection
    Example: 200

  - `nfts.totalValueUsd` (string)
    Formatted USD floor price value of the collection NFTs held by this owner
    Example: "$50.00"

  - `nfts.totalValueUsdAmt` (number)
    Floor USD price value of the collection NFTs held by this owner
    Example: 50

  - `txns` (object)

  - `txns.data` (array)

  - `txns.data.hash` (string)
    Transaction hash for the transaction
    Example: 123

  - `txns.data.block` (string)
    Block ID
    Example: 123

  - `txns.data.value` (number)
    Native value of the transaction
    Example: 10

  - `txns.data.gas` (number)
    Gas consumed by the transaction
    Example: 1

  - `txns.data.method` (string)
    Human readable label for the transaction (if available)
    Example: "Transfer"

  - `txns.data.link` (string)
    Link to blockchain scanner
    Example: "https://path/to/scanner"

  - `txns.data.success` (boolean)
    Indicates transaction result was successful
    Example: true

  - `txns.data.type` (string)
    Type of transaction record (native or NFT)
    Example: "native"

  - `txns.data.imageUrl` (string)
    Preview URL associated with this transaction (if available)
    Example: "https://path/to/image"

  - `txns.data.symbol` (string)
    Ticker symbol or other identifier associated with the transaction
    Example: "ETH"

  - `txns.data.description` (string)
    Human readable description of the transaction
    Example: "Transfer of 10 ETH to address 0x123"

  - `txns.data.from` (object)

  - `txns.data.from.address` (string)
    source address for transaction
    Example: "address1"

  - `txns.data.from.label` (string)
    human readable label for address (if available)
    Example: "label1"

  - `txns.data.to` (object)

  - `txns.cursor` (string)
    Pointer to next page of paginated data
    Example: 123

  - `totalValueUsd` (number)
    Formatted aggregated market value of the wallet
    Example: 200

  - `totalValueUsdAmd` (number)
    Aggregated market value of the wallet
    Example: 200

  - `walletType` (string)
    Indicates the type of wallet associated with this address
    Example: "external"


## Response 400 fields

## Response 404 fields