Staking

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": 1301,
  "fungibleStakes": [],
  "totals": {
    "principalMist": "438222615630705",
    "principal": 438222.615630705,
    "principalUsd": {
      "usd": 394800.61,
      "priceAsOf": "2026-11-04T12:21:35.606Z"
    },
    "rewardsMist": "22475953088837",
    "rewards": 22475.953088837,
    "rewardsUsd": {
      "usd": 20248.89,
      "priceAsOf": "2026-11-04T12:21:35.606Z"
    },
    "stakedValueMist": "460698568719542",
    "stakedValue": 460698.568719542,
    "fungibleValueMist": "0",
    "fungibleValue": 0,
    "totalValueMist": "460698568719542",
    "totalValue": 460698.568719542,
    "totalValueUsd": {
      "usd": 415049.5,
      "priceAsOf": "2026-11-04T12:21:35.606Z"
    }
  },
  "suiPriceUsd": 0.9009133611005244,
  "truncated": false,
  "asOf": {
    "checkpoint": 341555644,
    "timestamp": "2026-11-04T12:21:34.679Z",
    "lagMs": 687
  },
  "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": "61823070928",
      "rewards": 61.823070928,
      "valueMist": "1556981267595",
      "value": 1556.981267595
    },
    {
      "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": "94990278584",
      "rewards": 94.990278584,
      "valueMist": "1021758058415",
      "value": 1021.758058415
    },
    {
      "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": "94495617068",
      "rewards": 94.495617068,
      "valueMist": "1014775521414",
      "value": 1014.775521414
    }
  ],
  "stakeCount": 1291,
  "cursor": "100"
}

Long lists are cut to a few items here.