Sign in

v1

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-107095124.5 KB
Wallet data endpoints

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.

get/user/{address}/wallets

Path parameters

addressstring required

The address to retrieve wallet information. Supported addresses include EVM, Solana and Bitcoin.

Query parameters

verboseboolean
forceRefreshnumber

Include a timestamp to indicate that caching should be avoided when rendering the response

walletFieldsstring

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.

Headers

Authorizationstring required

The JWT access token that authorizes the request

Response

Wallet data

firstTxstring

The date of the first transaction in the wallet

lastTxstring

The date of the most recent transaction in the wallet

symbolstring

The symbol associated with the blockchain

addressstring

Blockchain address for the wallet

typestring

Type of balance

namestring

Human readable name associated with the token

logoUrlstring

A URL to a logo associated with the token

balancestring

A formatted string representing the wallet balance

totalValueUsdnumber

Formatted aggregated market value of the wallet

totalValueUsdAmdnumber

Aggregated market value of the wallet

walletTypestring

Indicates the type of wallet associated with this address

Example response

[
  {
    "firstTx": "2023-05-08T20:04:47.000Z",
    "lastTx": "2023-09-06T13:28:47.000Z",
    "symbol": "MATIC",
    "type": "native",
    "name": "Polygon",
    "logoUrl": "http://host.io/path/to/logo",
    "tokens": [
      {
        "symbol": "MATIC",
        "type": "erc20",
        "name": "Polygon",
        "logoUrl": "http://host.io/path/to/logo",
        "balanceAmt": 10,
        "value": {
          "marketUsd": "$2534.12",
          "marketPctChange24Hr": -1.74,
          "history": [
            {
              "timestamp": "2024-02-14T13:00:00.000Z",
              "value": 123
            }
          ],
          "walletUsd": "$100",
          "walletUsdAmt": 100
        }
      }
    ],
    "nfts": [
      {
        "category": "art",
        "collectionImageUrl": "https://path/to/collection/image",
        "description": "Collection description",
        "floorPrice": [
          {
            "marketPlaceName": "OpenSea",
            "marketPctChange24Hr": -1.74,
            "history": [
              {
                "timestamp": "2024-02-14T13:00:00.000Z",
                "value": 123
              }
            ],
            "valueUsd": "$25.00",
            "valueUsdAmt": 25
          }
        ],
        "latestAcquiredDate": "native",
        "name": "Unstoppable Domains",
        "nftIds": [
          "0x1234/1"
        ],
        "ownedCount": 10,
        "totalOwners": 10,
        "totalSupply": 200,
        "totalValueUsd": "$50.00",
        "totalValueUsdAmt": 50
      }
    ],
    "txns": {
      "data": [
        {
          "value": 10,
          "gas": 1,
          "method": "Transfer",
          "link": "https://path/to/scanner",
          "success": true,
          "type": "native",
          "imageUrl": "https://path/to/image",
          "symbol": "ETH",
          "description": "Transfer of 10 ETH to address 0x123",
          "from": {
            "address": "address1",
            "label": "label1",
            "link": "https://path/to/scanner"
          },
          "to": {
            "address": "address1",
            "label": "label1",
            "link": "https://path/to/scanner"
          }
        }
      ]
    },
    "totalValueUsd": 200,
    "totalValueUsdAmd": 200,
    "walletType": "external",
    "value": {
      "marketUsd": "$2534.12",
      "walletUsd": "$100",
      "walletUsdAmt": 100
    }
  }
]