Assets

getAssetsByOwner

Everything an address holds: NFTs (including those in its kiosks), SuiNS names and optionally coins.

Details

Endpoint: POST getAssetsByOwner (JSON-RPC)
Credits: 5
Rate class: Heavy. Counts against your heavy requests per second.

Lists the NFTs and SuiNS names an address owns, including items sitting in the kiosks it controls through a KioskOwnerCap. Set options.showFungible to add its coins on the first page (summed per coin type, most valuable first, up to 100) and options.showNativeBalance to add the SUI balance with its USD value and price time. Set options.showZeroBalance to keep coins with a zero balance. Ownership is read from the NFT index, so the newest second of transfers may lag. Pages hold up to 100 items; use cursor to continue.

Parameters

Name	Type	Description
ownerAddressrequired	string	Owner: a 0x address or a SuiNS name ending in .sui.
limit	integer	Items per page, 1 to 100 (each item carries its full traits).Default 50. From 1 to 100.
cursor	string	Cursor from the previous response. Preferred over page.
page	integer	Page number, 1 to 10. tide maps it to a cursor. Use cursor for anything deeper.From 1 to 10.
sortBy	string or object	An object { sortBy, sortDirection }. sortBy: created, updated, recent_action, none (default order), or tide's price, rarity, listed, floor. sortDirection: asc or desc.
options	object	Optional flags.
options.showFungible	boolean	Add the owner's coins as Coin assets on the first page (page 1 or no cursor).
options.showNativeBalance	boolean	Add nativeBalance: SUI balance in MIST, as an amount, and its USD value with priceAsOf.
options.showCollectionMetadata	boolean	Add collection_metadata (name, image, slug) to grouping.
options.showZeroBalance	boolean	Keep coins whose balance is zero (only with showFungible).

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl -X POST "https://api.tide.ad/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAssetsByOwner",
  "params": {
    "ownerAddress": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
    "limit": 5,
    "options": {
      "showFungible": true,
      "showNativeBalance": true
    }
  }
}'

TypeScript

const res = await fetch("https://api.tide.ad/", {
  method: "POST",
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAssetsByOwner",
    "params": {
      "ownerAddress": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
      "limit": 5,
      "options": {
        "showFungible": true,
        "showNativeBalance": true
      }
    }
  }),
});
const data = await res.json();

Response

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "total": 21,
    "limit": 5,
    "cursor": "eyJpZCI6IjB4MDc1OTk1NjI1YjliYjUxMTM2ZTFkOTIzNzBlYmFiYzY5MWI4ODY5ZTFlMzg3MzIwNGNmYmYyZDhiZTA4NWZhOSIsImkiOjV9",
    "items": [
      {
        "interface": "Coin",
        "id": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
        "content": {
          "metadata": {
            "name": "Sui",
            "symbol": "SUI",
            "description": "",
            "attributes": []
          },
          "links": {
            "image": "https://archive.cetus.zone/assets/image/sui/sui.png",
            "external_url": null
          },
          "files": [
            {
              "uri": "https://archive.cetus.zone/assets/image/sui/sui.png",
              "cdn_uri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Farchive.cetus.zone%2Fassets%2Fimage%2Fsui%2Fsui.png",
              "mime": "image/png"
            }
          ]
        },
        "grouping": [],
        "royalty": null,
        "creators": [],
        "ownership": {
          "owner": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
          "ownership_model": "single",
          "kiosk": null,
          "frozen": false,
          "delegated": false
        },
        "supply": null,
        "mutable": false,
        "burnt": false,
        "token_info": {
          "symbol": "SUI",
          "decimals": 9,
          "supply": 10000000000,
          "supply_raw": "10000000000000000000",
          "verified": true,
          "balance": 104.224874648,
          "balance_raw": "104224874648",
          "price_info": {
            "price_per_token": 0.8959507571539784,
            "total_price": 93.380355,
            "currency": "USDC",
            "as_of": "2026-11-04T07:24:38.910Z"
          }
        },
        "sui": {
          "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "version": null,
          "digest": null,
          "previousTransaction": null,
          "display": null,
          "metadataId": "0xf256d3fb6a50eaa748d94335b34f2982fbc3b63ceec78cafaa29ebc9ebaf2bbc"
        }
      },
      {
        "interface": "Coin",
        "id": "0x356a26eb9e012a68958082340d4c4116e7f55615cf27affcff209cf0ae544f59::wal::WAL",
        "content": {
          "metadata": {
            "name": "WAL Token",
            "symbol": "WAL",
            "description": "The native token for the Walrus Protocol.",
            "attributes": []
          },
          "links": {
            "image": "https://www.walrus.xyz/wal-icon.svg",
            "external_url": null
          },
          "files": [
            {
              "uri": "https://www.walrus.xyz/wal-icon.svg",
              "cdn_uri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fwww.walrus.xyz%2Fwal-icon.svg",
              "mime": "image/svg+xml"
            }
          ]
        },
        "grouping": [],
        "royalty": null,
        "creators": [],
        "ownership": {
          "owner": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
          "ownership_model": "single",
          "kiosk": null,
          "frozen": false,
          "delegated": false
        },
        "supply": null,
        "mutable": false,
        "burnt": false,
        "token_info": {
          "symbol": "WAL",
          "decimals": 9,
          "supply": 4999854524.67259,
          "supply_raw": "4999854524672590610",
          "verified": true,
          "balance": 148.113180803,
          "balance_raw": "148113180803",
          "price_info": {
            "price_per_token": 0.02914621853454256,
            "total_price": 4.316939,
            "currency": "USDC",
            "as_of": "2026-11-04T07:24:38.949Z"
          }
        },
        "sui": {
          "type": "0x356a26eb9e012a68958082340d4c4116e7f55615cf27affcff209cf0ae544f59::wal::WAL",
          "version": null,
          "digest": null,
          "previousTransaction": null,
          "display": null,
          "metadataId": "0xb6a0c0bacb1c87c3be4dff20c22ef1012125b5724b5b0ff424f852a2651b23fa"
        }
      },
      {
        "interface": "Coin",
        "id": "0x347c4acaa1cd40db9c0311c9bcf6c6354d4d45b14e838a264121e2b0d2fff9ff::nyaaa::NYAAA",
        "content": {
          "metadata": {
            "name": ":3",
            "symbol": "NYAAA",
            "description": "just a lil guy :3",
            "attributes": []
          },
          "links": {
            "image": null,
            "external_url": null
          },
          "files": []
        },
        "grouping": [],
        "royalty": null,
        "creators": [],
        "ownership": {
          "owner": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
          "ownership_model": "single",
          "kiosk": null,
          "frozen": false,
          "delegated": false
        },
        "supply": null,
        "mutable": false,
        "burnt": false,
        "token_info": {
          "symbol": "NYAAA",
          "decimals": 6,
          "supply": 1000000000,
          "supply_raw": "1000000000000000",
          "verified": true,
          "balance": 3389.562983,
          "balance_raw": "3389562983",
          "price_info": {
            "price_per_token": 0.000018414137806874893,
            "total_price": 0.062416,
            "currency": "USDC",
            "as_of": "2026-11-04T07:24:38.977Z"
          }
        },
        "sui": {
          "type": "0x347c4acaa1cd40db9c0311c9bcf6c6354d4d45b14e838a264121e2b0d2fff9ff::nyaaa::NYAAA",
          "version": null,
          "digest": null,
          "previousTransaction": null,
          "display": null,
          "metadataId": "0x5a9369309b1c84c988d32cbc2b2432d923405dc5636d94c3084d7f6ff4e53bf6"
        }
      }
    ],
    "asOf": {
      "checkpoint": 341482552,
      "timestamp": "2026-11-04T07:24:39.182Z",
      "lagMs": 710
    },
    "nativeBalance": {
      "mist": "104224874648",
      "amount": 104.224874648,
      "price_per_sui": 0.8959507571539784,
      "total_price": 93.380355,
      "priceAsOf": "2026-11-04T07:24:39.822Z"
    }
  }
}

Long lists are cut to a few items here.