searchAssets

Find assets by owner, collection, name, traits or kind.

Details

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

Filters assets. Pass ownerAddress and/or grouping ["collection", type-or-slug]; with neither, only tokenType fungible with a name works (a coin search). name matches the item or coin name. traits is a list of { trait_type, value } and works with grouping (server side); with only an owner it filters inside each page. tokenType: nonFungible (default), fungible (an owner's coins, or a coin search by name), all (with an owner: coins on the first page plus NFTs). interface keeps SuiNFT, KioskItem, SuiNSName or Object. burnt true is not indexed yet.

Parameters

Name	Type	Description
ownerAddress	string	Owner address or .sui name.
grouping	array of string	["collection", "<Move type or slug>"].2 to 2 items.
interface	string	Keep one asset interface.One of "SuiNFT", "KioskItem", "SuiNSName", "Coin", "Object".
tokenType	string	Default nonFungible.One of "fungible", "nonFungible", "all".
name	string	Match on the item name (or coin name or symbol for fungible).
traits	array of object	Trait filters. Values of one trait_type are alternatives; different types combine.
traits[].trait_typerequired	string
traits[].valuerequired	string
burnt	boolean	Only false (the default) is supported.
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.showCollectionMetadata	boolean	Add collection_metadata (name, image, slug) to grouping.

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": "searchAssets",
  "params": {
    "grouping": [
      "collection",
      "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins"
    ],
    "traits": [
      {
        "trait_type": "Skin",
        "value": "Forest"
      }
    ],
    "limit": 5
  }
}'

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": "searchAssets",
    "params": {
      "grouping": [
        "collection",
        "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins"
      ],
      "traits": [
        {
          "trait_type": "Skin",
          "value": "Forest"
        }
      ],
      "limit": 5
    }
  }),
});
const data = await res.json();

Response

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "total": 3951,
    "limit": 5,
    "cursor": "eyJwIjoibCIsImlkIjoiMHg5Y2FlZTU4OTQ3OGI5MTgxYTMxMzgwZjRjM2EyN2Y0N2JhOGJiNDQwMWQ3MDE4MjVjYWUyNTEzYzkwMjY1NTU3IiwiaSI6NX0",
    "items": [
      {
        "interface": "KioskItem",
        "id": "0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
        "content": {
          "metadata": {
            "name": "Popkins #16974",
            "symbol": "",
            "description": "Who knew so much chaos could come in such a small package? Popkins are an expansive collection of 25,000 joyful, mischievous critters inhabiting the Claynosaurz Universe—all gas, no brakes!",
            "attributes": [
              {
                "trait_type": "Species",
                "value": "Snarlfin"
              }
            ]
          },
          "links": {
            "image": "https://storage.claynosaurz.com/popkins/images/0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
            "external_url": "https://popkins.com/explorer/16974"
          },
          "files": [
            {
              "uri": "https://storage.claynosaurz.com/popkins/images/0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
              "cdn_uri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fstorage.claynosaurz.com%2Fpopkins%2Fimages%2F0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
              "mime": "image/*"
            }
          ]
        },
        "grouping": [
          {
            "group_key": "collection",
            "group_value": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins"
          }
        ],
        "royalty": {
          "basis_points": 500,
          "percent": 5,
          "primary_sale_happened": null,
          "locked": true
        },
        "creators": [],
        "ownership": {
          "owner": "0x7859694f3043e7a3ad859fd9e3313567aee8930f49819708a97e8a395dcbfb61",
          "ownership_model": "kiosk",
          "kiosk": {
            "id": "0x1b4577cc7c33a74b6a4eb466d415169405dd50c437765273a38fe9371c0cbc1c",
            "listed": true,
            "price": {
              "amountRaw": "41040000000",
              "amount": 41.04,
              "symbol": "SUI",
              "usd": 35.046226,
              "priceAsOf": "2026-11-06T04:17:49.601Z"
            },
            "venue": "tradeport"
          },
          "frozen": false,
          "delegated": false
        },
        "supply": null,
        "mutable": true,
        "burnt": false,
        "sui": {
          "type": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins",
          "version": "1069065570",
          "digest": "BmXWFcuVTVZ9ojYxdj8S3tY9bhAwFkL69hfgJudbGkPe",
          "previousTransaction": "CoF7V66zaBE47WN7EWqVZ6inJLiPGRpkYggRsfK1MEPL",
          "display": {
            "attributes": {
              "contents": [
                {
                  "key": "Species",
                  "value": "Snarlfin"
                }
              ]
            },
            "avatar_thumb_url": "https://storage.claynosaurz.com/popkins/avatars-thumb/0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
            "avatar_url": "https://storage.claynosaurz.com/popkins/avatars/0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
            "creator": "Claynosaurz",
            "description": "Who knew so much chaos could come in such a small package? Popkins are an expansive collection of 25,000 joyful, mischievous critters inhabiting the Claynosaurz Universe—all gas, no brakes!",
            "image_url": "https://storage.claynosaurz.com/popkins/images/0xb6a164fba5b13a20b378af566295bed6190edab42d4207f224380763eba74296",
            "link": "https://popkins.com/explorer/https://popkins.com/explorer/16974",
            "name": "Popkins #16974",
            "project_url": "https://claynosaurz.com"
          },
          "rarity": {
            "rank": 18352,
            "tier": "common"
          }
        }
      },
      {
        "interface": "KioskItem",
        "id": "0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
        "content": {
          "metadata": {
            "name": "Popkins #15620",
            "symbol": "",
            "description": "Who knew so much chaos could come in such a small package? Popkins are an expansive collection of 25,000 joyful, mischievous critters inhabiting the Claynosaurz Universe—all gas, no brakes!",
            "attributes": [
              {
                "trait_type": "Species",
                "value": "Axio"
              }
            ]
          },
          "links": {
            "image": "https://storage.claynosaurz.com/popkins/images/0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
            "external_url": "https://popkins.com/explorer/15620"
          },
          "files": [
            {
              "uri": "https://storage.claynosaurz.com/popkins/images/0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
              "cdn_uri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fstorage.claynosaurz.com%2Fpopkins%2Fimages%2F0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
              "mime": "image/*"
            }
          ]
        },
        "grouping": [
          {
            "group_key": "collection",
            "group_value": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins"
          }
        ],
        "royalty": {
          "basis_points": 500,
          "percent": 5,
          "primary_sale_happened": null,
          "locked": true
        },
        "creators": [],
        "ownership": {
          "owner": "0xdfdc1e464368e33566c6678c57632e7ecf8d84e08bd38aabe98c35ba84759233",
          "ownership_model": "kiosk",
          "kiosk": {
            "id": "0xd798b74e711e3c6d253db8232db0cfc6b18917426cd9c592fda12a338a3e9725",
            "listed": true,
            "price": {
              "amountRaw": "45349200000",
              "amount": 45.3492,
              "symbol": "SUI",
              "usd": 38.726079,
              "priceAsOf": "2026-11-06T04:17:49.601Z"
            },
            "venue": "tradeport"
          },
          "frozen": false,
          "delegated": false
        },
        "supply": null,
        "mutable": true,
        "burnt": false,
        "sui": {
          "type": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins",
          "version": "1071381969",
          "digest": "EQsogKGF86QnmKUn81bG65h6nvyCmwzDeY3mVoZRP2nt",
          "previousTransaction": "AbH2ZEDTH3vELeW6FQsNrhBqQyXBP7bDH3PdyVPQZFDA",
          "display": {
            "attributes": {
              "contents": [
                {
                  "key": "Species",
                  "value": "Axio"
                }
              ]
            },
            "avatar_thumb_url": "https://storage.claynosaurz.com/popkins/avatars-thumb/0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
            "avatar_url": "https://storage.claynosaurz.com/popkins/avatars/0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
            "creator": "Claynosaurz",
            "description": "Who knew so much chaos could come in such a small package? Popkins are an expansive collection of 25,000 joyful, mischievous critters inhabiting the Claynosaurz Universe—all gas, no brakes!",
            "image_url": "https://storage.claynosaurz.com/popkins/images/0x4f639c07a65a94afdf38410db54b9a2526b027b70433c4adcb469db42957f634",
            "link": "https://popkins.com/explorer/https://popkins.com/explorer/15620",
            "name": "Popkins #15620",
            "project_url": "https://claynosaurz.com"
          },
          "rarity": {
            "rank": 16521,
            "tier": "common"
          }
        }
      }
    ],
    "asOf": {
      "checkpoint": 342151077,
      "timestamp": "2026-11-06T04:17:46.983Z",
      "lagMs": 2703
    }
  }
}

Long lists are cut to a few items here.