v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Wallet API

Get wallet reputation

/v4/data/wallet/reputation

5000 credits per API call per address

Returns reputation scores for one or more wallets using on-chain behavioral analysis across their token portfolio.

Supported blockchains:

Ethereum - ethereum-mainnet
Base - base-mainnet

> 📘 Note for Free Users > > 500 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

Query parameters

chain'ethereum-mainnet' | 'base-mainnet' required

Example:ethereum-mainnet

The blockchain to work with.

addressesstring required

Example:0xdef1c0ded9bec7f1a1670819833240f027b25eff,0xdef1c0ded9bec7f1a1670819833240f027b25eff

The list of wallets, comma separated.

blockNumbernumber

Example:16499510

timestampnumber

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

Response

Example response

{
  "data": [
    {
      "address": "0x80d8bac9a6901698b3749fe336bbd1385c1f98f2",
      "score": 87.5,
      "chain": "ethereum-mainnet",
      "blockNumber": 16499510,
      "timestamp": 1678715303000,
      "details": {
        "nftScore": 50,
        "tokenScore": 37.5
      }
    }
  ]
}