Wallet

wallet.balances

Every coin a wallet holds now, with USD value, sorted by value.

Details

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

Returns the wallet's live coin balances. Each balance has coinType (also given as mint), symbol, decimals, balance in whole coins, balanceRaw in the smallest unit, pricePerToken, usdValue and priceAsOf. Priced coins come first, sorted by usdValue, then unpriced coins by balance. A page holds up to 100 coins: use page, or cursor from the response. totalUsdValue adds up every priced coin the wallet holds, not only this page. Each balance has priceStatus: priced, unpriced (no market that counts) or pending (its price was still being read when the request's time ran out). When any coin is pending, totalUsdValue is null and pricing is "partial": read again shortly for the full total; a total is never given without them. Partial answers are not cached. showNfts adds a short NFT list. The wallet can be an address, name.sui or @name.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.
page	integer	Page number, starting at 1. Default 1.At least 1.
limit	integer	Coins per page, up to 100. Default 100.From 1 to 100.
cursor	string	Cursor from the previous response (same as page).
showZeroBalance	boolean	Include coins held with a zero balance. Default false.
showNative	boolean	Include SUI. Default true.
showNfts	boolean	Add an nfts list (first 50 items). Default false.

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/balances?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balances?limit=10", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "wallet": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
  "balances": [
    {
      "coinType": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
      "mint": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
      "symbol": "USDC",
      "name": "Native USDC",
      "decimals": 6,
      "balance": 154.875709,
      "balanceRaw": "154875709",
      "pricePerToken": 1.000054,
      "usdValue": 154.88,
      "priceAsOf": "2026-11-04T07:30:13.865Z",
      "priceStatus": "priced",
      "verified": true,
      "logoUri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fres.cetus.zone%2Fcoin-metadata%2Fmainnet%2Ficon%2F0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7_28c8a56e.png"
    },
    {
      "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
      "mint": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
      "symbol": "SUI",
      "name": "SUI Token",
      "decimals": 9,
      "balance": 9.995358811,
      "balanceRaw": "9995358811",
      "pricePerToken": 0.9004006497946312,
      "usdValue": 9,
      "priceAsOf": "2026-11-04T07:30:13.865Z",
      "priceStatus": "priced",
      "verified": true,
      "logoUri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Farchive.cetus.zone%2Fassets%2Fimage%2Fsui%2Fsui.png"
    },
    {
      "coinType": "0x41d587e5336f1c86cad50d38a7136db99333bb9bda91cea4ba69115defeb1402::sui_usde::SUI_USDE",
      "mint": "0x41d587e5336f1c86cad50d38a7136db99333bb9bda91cea4ba69115defeb1402::sui_usde::SUI_USDE",
      "symbol": "suiUSDe",
      "name": "eSui Dollar",
      "decimals": 6,
      "balance": 0.02684,
      "balanceRaw": "26840",
      "pricePerToken": 1.0002656791569087,
      "usdValue": 0.03,
      "priceAsOf": "2026-11-04T07:30:13.865Z",
      "priceStatus": "priced",
      "verified": true,
      "logoUri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fres.cetus.zone%2Fcoin-metadata%2Fmainnet%2Ficon%2F0x41d587e5336f1c86cad50d38a7136db99333bb9bda91cea4ba69115defeb1402_eac54522.svg"
    }
  ],
  "totalUsdValue": 163.96,
  "pricing": "complete",
  "pagination": {
    "page": 1,
    "limit": 10,
    "hasMore": false
  },
  "cursor": null,
  "asOf": {
    "checkpoint": 341483943,
    "timestamp": "2026-11-04T07:30:12.181Z",
    "lagMs": 1615
  }
}

Long lists are cut to a few items here.