Assets

getAsset

One asset: an NFT, kiosk item, SuiNS name, other object, or a coin type.

Details

Endpoint: POST getAsset (JSON-RPC)
Credits: 2
Rate class: Light. Counts against your light requests per second.

Returns the asset in DAS layout: content (name, image, traits), grouping (collection), royalty, creators, ownership (including kiosk and listing price), and a sui block with type, version, digest and display. Pass an object id for NFTs, kiosk items and SuiNS names, or a Move coin type for a coin (then token_info holds supply and the price with its time). Returns not_found when the object does not exist.

Parameters

Name	Type	Description
idrequired	string	Asset id: an object id (0x...) for NFTs, kiosk items and SuiNS names, or a Move coin type (0x2::sui::SUI) for a coin.
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": "getAsset",
  "params": {
    "id": "0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0"
  }
}'

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": "getAsset",
    "params": {
      "id": "0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0"
    }
  }),
});
const data = await res.json();

Response

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "interface": "KioskItem",
    "id": "0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
    "content": {
      "metadata": {
        "name": "Popkins #10861",
        "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"
          },
          {
            "trait_type": "Mutation",
            "value": "Beta"
          },
          {
            "trait_type": "Skin",
            "value": "Forest"
          }
        ]
      },
      "links": {
        "image": "https://storage.claynosaurz.com/popkins/images/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "external_url": "https://popkins.com/explorer/10861"
      },
      "files": [
        {
          "uri": "https://storage.claynosaurz.com/popkins/images/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
          "cdn_uri": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fstorage.claynosaurz.com%2Fpopkins%2Fimages%2F0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
          "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": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
      "ownership_model": "kiosk",
      "kiosk": {
        "id": "0x57086347a30d901959121b754afe961c475541636ab2b98001ef11503c8b5509",
        "listed": true,
        "price": {
          "amountRaw": "41029200000",
          "amount": 41.0292,
          "symbol": "SUI",
          "usd": 35.976914,
          "priceAsOf": "2026-11-04T04:30:28.631Z"
        },
        "venue": "tradeport"
      },
      "frozen": false,
      "delegated": false
    },
    "supply": null,
    "mutable": true,
    "burnt": false,
    "sui": {
      "type": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins",
      "version": "1062560995",
      "digest": "EYos6BzLrxBQC1pRbr1f3b6fbbLDo89DntN3wX5d6v79",
      "previousTransaction": "HTEWNckwPM8j9v5cSdmW1vmtpaEsj5PggM9GeF8vY2m3",
      "display": {
        "attributes": {
          "contents": [
            {
              "key": "Species",
              "value": "Snarlfin"
            }
          ]
        },
        "avatar_thumb_url": "https://storage.claynosaurz.com/popkins/avatars-thumb/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "avatar_url": "https://storage.claynosaurz.com/popkins/avatars/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "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/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "link": "https://popkins.com/explorer/https://popkins.com/explorer/10861",
        "name": "Popkins #10861",
        "project_url": "https://claynosaurz.com"
      },
      "rarity": {
        "rank": 18164,
        "tier": "common"
      }
    },
    "asOf": {
      "checkpoint": 341439584,
      "timestamp": "2026-11-04T04:30:26.539Z",
      "lagMs": 2194
    }
  }
}

Long lists are cut to a few items here.