wallet.stakes

A wallet's staked SUI: validator, status and rewards so far.

Details

Endpoint: GET /v1/wallet/:wallet/stakes
Credits: 3
Rate class: Light. Counts against your light requests per second.

Returns the StakedSui and FungibleStakedSui objects the wallet owns, largest principal first, 100 per page with a cursor. Each stake has the object id, the validator (address, name, image), the principal in MIST, the activation epoch and a status: pending until its activation epoch starts, then active. Rewards so far are the pool tokens bought at the activation epoch rate valued at the current epoch rate, minus the principal; they are an estimate until you withdraw. Totals come in MIST, SUI and USD with the price time. Stakes in a pool whose validator left the set show validator null and no rewards. The wallet can be an address, name.sui or @name.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.
limit	integer	Stakes per page, default 100. Totals always cover every stake the wallet holds.From 1 to 500.
cursor	string	cursor from the previous page, to get the next one.

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/0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e/stakes" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

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

Response

JSON

{
  "wallet": "0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e",
  "epoch": 1303,
  "fungibleStakes": [],
  "totals": {
    "principalMist": "438543338381005",
    "principal": 438543.338381005,
    "principalUsd": {
      "usd": 373665.99,
      "priceAsOf": "2026-11-06T04:28:46.846Z"
    },
    "rewardsMist": "22508919723902",
    "rewards": 22508.919723902,
    "rewardsUsd": {
      "usd": 19178.99,
      "priceAsOf": "2026-11-06T04:28:46.846Z"
    },
    "stakedValueMist": "461052258104907",
    "stakedValue": 461052.258104907,
    "fungibleValueMist": "0",
    "fungibleValue": 0,
    "totalValueMist": "461052258104907",
    "totalValue": 461052.258104907,
    "totalValueUsd": {
      "usd": 392844.98,
      "priceAsOf": "2026-11-06T04:28:46.846Z"
    }
  },
  "suiPriceUsd": 0.852061711904762,
  "truncated": false,
  "asOf": {
    "checkpoint": 342153776,
    "timestamp": "2026-11-06T04:28:46.069Z",
    "lagMs": 614
  },
  "stakes": [
    {
      "objectId": "0x406c371f298f222dcc1b9f2d03a2b777db591bfd224c1b5ca3a045e32a326f13",
      "validator": {
        "address": "0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e",
        "name": "Mysten-1",
        "imageUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fsui-examples.s3.us-east-1.amazonaws.com%2Flogo-1.svg"
      },
      "poolId": "0x748a0ce980c3804d21267a4d359ac5c64bd40cb6a3e02a527b45f828cf8fd30d",
      "status": "active",
      "activationEpoch": 564,
      "epochsUntilActive": 0,
      "principalMist": "1495158196667",
      "principal": 1495.158196667,
      "rewardsMist": "61934465893",
      "rewards": 61.934465893,
      "valueMist": "1557092662560",
      "value": 1557.09266256
    },
    {
      "objectId": "0x8277cd1571f639430c6c7c45c5b6620e1532a18e023b14a3784adb2cf8ceb8d7",
      "validator": {
        "address": "0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e",
        "name": "Mysten-1",
        "imageUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fsui-examples.s3.us-east-1.amazonaws.com%2Flogo-1.svg"
      },
      "poolId": "0x748a0ce980c3804d21267a4d359ac5c64bd40cb6a3e02a527b45f828cf8fd30d",
      "status": "active",
      "activationEpoch": 37,
      "epochsUntilActive": 0,
      "principalMist": "926767779831",
      "principal": 926.767779831,
      "rewardsMist": "95063380750",
      "rewards": 95.06338075,
      "valueMist": "1021831160581",
      "value": 1021.831160581
    },
    {
      "objectId": "0xb73181be5e20a7e6b6c73068fcf94e881f4b754580cf60da12378c2ebb369675",
      "validator": {
        "address": "0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e",
        "name": "Mysten-1",
        "imageUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fsui-examples.s3.us-east-1.amazonaws.com%2Flogo-1.svg"
      },
      "poolId": "0x748a0ce980c3804d21267a4d359ac5c64bd40cb6a3e02a527b45f828cf8fd30d",
      "status": "active",
      "activationEpoch": 36,
      "epochsUntilActive": 0,
      "principalMist": "920279904346",
      "principal": 920.279904346,
      "rewardsMist": "94568219665",
      "rewards": 94.568219665,
      "valueMist": "1014848124011",
      "value": 1014.848124011
    }
  ],
  "stakeCount": 1293,
  "cursor": "100"
}

Long lists are cut to a few items here.