Wallet

wallet.balanceAt

A wallet's balance of one coin at a past time or checkpoint.

Details

Endpoint: GET /v1/wallet/:wallet/balance-at
Credits: 10
Rate class: Heavy. Counts against your heavy requests per second.

Returns the exact balance of one coin at the end of a given checkpoint, found by adding up every balance change of the wallet and coin up to that point. Pass the coin as coinType (alias mint) and exactly one of time (unix seconds), datetime or checkpoint (alias slot). balance is in whole coins and balanceRaw in the smallest unit. asOf names the last transaction that changed the balance at or before the point, or is null when the balance was zero. History covers all of Sui since genesis. The wallet can be an address, name.sui or @name.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.
coinType	string	Coin type such as 0x2::sui::SUI. Alias: mint.
mint	string	Alias of coinType.
time	integer	Point in time as unix seconds. Give exactly one of time, datetime or checkpoint.
datetime	string	Point in time as an ISO 8601 date, UTC when no zone is given, for example 2025-01-10 19:20:00.
checkpoint	integer	Checkpoint sequence number. Alias: slot.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balance-at?coinType=0x2::sui::SUI&datetime=2026-11-01%2000:00:00" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balance-at?coinType=0x2::sui::SUI&datetime=2026-11-01%2000:00:00", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "wallet": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
  "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
  "mint": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
  "symbol": "SUI",
  "decimals": 9,
  "balance": 53.893607257,
  "balanceRaw": "53893607257",
  "at": {
    "checkpoint": 340305463,
    "timestamp": "2026-11-01T00:00:00.000Z"
  },
  "asOf": {
    "checkpoint": 340302996,
    "digest": "DpZavyRAFR935hqHJao9PX2PSAEJbhe5tgz75h2vuc3e",
    "timestamp": "2026-10-31T23:49:59.182Z"
  }
}