v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Wallet API

Get wallet reputation portfolio

/v4/data/wallet/reputation/portfolio

10000 credits per API call per address

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

Returns composite reputation scores along with per-token scores for all tokens held in each wallet.

Supported blockchains:

Ethereum - ethereum-mainnet
Base - base-mainnet

get/v4/data/wallet/reputation/portfolio

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",
      "chain": "ethereum-mainnet",
      "blockNumber": 16499510,
      "timestamp": 1678715303000,
      "portfolio": [
        {
          "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
          "score": 42.1
        }
      ]
    }
  ]
}