Coins

coins.holders

Top holders of a coin, ranked by balance, with the USD value of each.

Details

Endpoint: GET /v1/coins/:type/holders
Credits: 5
Rate class: Heavy. Counts against your heavy requests per second.

Returns holders largest first: rank, owner (address, SuiNS name, label when known), balance as amount and amountRaw, pctSupply, value { usd, priceAsOf }, and kind (wallet, pool, lending and so on). Balances include staked, LP and lending positions; wallet parts are read from chain. The first 100 holders are served from a cached list so any limit works there; later pages hold 100 each. For holders at a past time use coins.holdersAt.

Parameters

Name	Type	Description
typerequired	string	Move coin type, URL-encoded in the path, for example 0x2::sui::SUI or 0xdeeb7a46...::deep::DEEP.
limit	integer	Rows per page within the first 100 holders.Default 50. From 1 to 100.
cursor	string	Cursor from the previous response.

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/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/holders?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/holders?limit=10", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "coinType": "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
  "holderCount": 93909,
  "top10Pct": 67.31493848785564,
  "items": [
    {
      "rank": 1,
      "owner": {
        "address": "0x9548232f9cebbc1eec56cfb25b99f61e17924b4908248c260c8d70100c59c70d",
        "name": null,
        "label": null
      },
      "balance": {
        "amountRaw": "4475814296835954",
        "amount": 4475814296.835954,
        "decimals": 6
      },
      "pctSupply": 44.9178,
      "value": {
        "usd": 71238728.339504,
        "priceAsOf": "2026-11-04T07:30:02.013Z"
      },
      "kind": "wallet",
      "parts": {
        "wallet": 4475814296.835954
      }
    },
    {
      "rank": 2,
      "owner": {
        "address": "0x8cf2285fb2ae4a5dd23a0fd28dbd129917fcd59b04f6272ff2b5eb358349e5f2",
        "name": null,
        "label": null
      },
      "balance": {
        "amountRaw": "978881135000000",
        "amount": 978881135,
        "decimals": 6
      },
      "pctSupply": 9.8237,
      "value": {
        "usd": 15580236.941963,
        "priceAsOf": "2026-11-04T07:30:02.013Z"
      },
      "kind": "wallet",
      "parts": {
        "wallet": 978881135
      }
    },
    {
      "rank": 3,
      "owner": {
        "address": "0x41a6054a444068b51922e3efbf739d1f17f16b5800e4e03015dd6195418a89be",
        "name": null,
        "label": null
      },
      "balance": {
        "amountRaw": "560257577010300",
        "amount": 560257577.0103,
        "decimals": 6
      },
      "pctSupply": 5.6226,
      "value": {
        "usd": 8917268.385554,
        "priceAsOf": "2026-11-04T07:30:02.013Z"
      },
      "kind": "wallet",
      "parts": {
        "wallet": 560257577.0103
      }
    }
  ],
  "cursor": "eyJvIjoxMH0",
  "asOf": {
    "checkpoint": 341483852,
    "timestamp": "2026-11-04T07:30:01.151Z",
    "lagMs": 780
  }
}

Long lists are cut to a few items here.