Wallet

wallet.positions

A wallet's DeFi positions: liquidity, lending, staking and vaults.

Details

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

Returns the open DeFi positions of a wallet with the protocol, the kind (liquidity, lending, staked, vault, borrow), the coins in and out, USD value and APY when known. Values are marked at current prices. totals adds up value and borrowed USD.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.

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

TypeScript

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

Response

JSON

{
  "address": "0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd",
  "rows": [
    {
      "id": "scallop:lending",
      "protocol": {
        "id": "scallop",
        "name": "Scallop",
        "category": "Lending",
        "url": "https://scallop.io",
        "logoUrl": "/protocols/scallop.webp"
      },
      "kind": "lending",
      "kindWord": "Lending",
      "label": "USDC / SUI",
      "legs": [
        {
          "coin": {
            "type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
            "symbol": "USDC",
            "name": "USDC",
            "decimals": 6,
            "iconUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fcircle.com%2Fusdc-icon&t=0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
            "verified": true,
            "logo": {
              "logoOk": true,
              "logoTransparent": false,
              "logoDark": false,
              "logoLight": false,
              "logoFull": false,
              "logoRound": true,
              "logoBg": "#121212"
            }
          },
          "amount": 166.976732,
          "valueUsd": 167.0435226928
        },
        {
          "coin": {
            "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "symbol": "SUI",
            "name": "Sui",
            "decimals": 9,
            "iconUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Farchive.cetus.zone%2Fassets%2Fimage%2Fsui%2Fsui.png&t=0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "verified": true,
            "logo": {
              "logoOk": true,
              "logoTransparent": false,
              "logoDark": false,
              "logoLight": true,
              "logoFull": false,
              "logoRound": true,
              "logoBg": "#ffffff"
            }
          },
          "amount": 9.887099083,
          "valueUsd": 8.64478508322105
        }
      ],
      "borrows": [],
      "valueUsd": 175.68830777602105,
      "borrowedUsd": 0,
      "change24hPct": 0.0072462604963057144,
      "apy": null,
      "manageUrl": "https://app.scallop.io"
    }
  ],
  "totals": {
    "totalUsd": 175.69,
    "borrowedUsd": 0,
    "byKind": {
      "lp": 0,
      "lending": 175.68830777602105,
      "staked": 0,
      "vault": 0
    },
    "netUsd": 175.69
  },
  "asOf": {
    "checkpoint": 341440239,
    "timestamp": "2026-11-04T04:33:07.894Z",
    "lagMs": 722
  }
}