Net Worth History

GET/gateway/v1/wallet/net-worth

Returns a time-series of the wallet's total net worth in USD.

Returns ~288 data points at 5-minute intervals covering the last 24 hours. Fixed window — no custom time range supported.

Lookup: by `address` (EVM only — 0x-prefixed hex). Solana addresses are not supported.

Query Parameters

addressstringrequired

Wallet address — must be a raw 0x-prefixed hex address (EVM only). Solana and ENS names are not supported.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Net Worth History

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/wallet/net-worth?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseWalletNetWorthPoint.json",
  "data": [
    {
      "timestamp": 123,
      "usd_value": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}