Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Wallet API

Get wallet reputation by tokens

/v4/data/wallet/reputation/tokens

1500 credits per API call per address

Returns reputation scores for a wallet across one or more specific tokens.

Supported blockchains:

  • Ethereum - ethereum-mainnet
  • Base - base-mainnet

> 📘 Note for Free Users > > 150 credits per API call per address > > As a free user, your data is cached on a 1-day refresh cycle, and wallet queries run through tatumio.eth. This setup helps lower costs so you can easily try out the API. For real-time data, faster syncs, and the full capability of our platform, we recommend upgrading to a paid plan.

get/v4/data/wallet/reputation/tokens

Query parameters

chain'ethereum-mainnet' | 'base-mainnet' required
Example:ethereum-mainnet
walletAddressstring required
Example:0x80d8bac9a6901698b3749fe336bbd1385c1f98f2

Wallet address to be analysed.

tokenAddressesstring required
Example:0xdef1c0ded9bec7f1a1670819833240f027b25eff,0xdef1c0ded9bec7f1a1670819833240f027b25eff

The list of tokens, comma separated. (Either tokenAddresses or tokenSymbols should be present)

tokenSymbolsstring
Example:USDC,DAI

The list of symbols, comma separated. (Either tokenAddresses or tokenSymbols should be present)

blockNumbernumber
Example:16499510
timestampnumber

Date-time UTC timestamp in format YYYY-MM-DDTHH:mm:ssZ (ignored if blockNumber is present)

Response

OK

Example response

{
  "data": [
    {
      "walletAddress": "0x80d8bac9a6901698b3749fe336bbd1385c1f98f2",
      "chain": "ethereum-mainnet",
      "blockNumber": 16499510,
      "timestamp": 1678715303000,
      "tokens": [
        {
          "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
          "tokenSymbol": "USDC",
          "score": 42.1
        }
      ]
    }
  ]
}