NFTs

NFTs, kiosk items, SuiNS names and coins in one asset shape. The asset id is the object id, or the coin type for a coin.

When to use it

Show the NFTs a wallet owns, including items held in kiosks.
List a collection's members and search by trait.
Read one asset or a thousand in one call.

Quickstart

Replace YOUR_API_KEY with your key from the developer portal, or drop the key header to use the keyless tier. See Quickstart.

1. List a wallet's assets

NFTs and kiosk items, with options to add coins and the native balance.

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
    }
  }
}'

2. Get one asset

Name, image, collection, owner and traits.

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"
  }
}'

3. List a collection

Members of a collection by its Move type.

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": "getAssetsByGroup",
  "params": {
    "groupKey": "collection",
    "groupValue": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins",
    "limit": 5
  }
}'

4. Search assets

Filter by owner, collection, interface, traits or burnt.

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
  }
}'

API reference

Method	What it does	Credits
getAssetJSON-RPC	One asset: an NFT, kiosk item, SuiNS name, other object, or a coin type.	2
getAssetBatchJSON-RPC	Up to 1,000 assets by id in one call.	varies
getAssetsByOwnerJSON-RPC	Everything an address holds: NFTs (including those in its kiosks), SuiNS names and optionally coins.	5
getAssetsByGroupJSON-RPC	The items of one collection.	5
searchAssetsJSON-RPC	Find assets by owner, collection, name, traits or kind.	5
getTransactionsForAssetJSON-RPC	Every transaction that changed an object, newest first.	5
getKioskJSON-RPC	A kiosk: who controls it, what is in it, and what is listed at what price.	2
wallet.nftsGET /v1/wallet/:wallet/nfts	NFTs and kiosk items a wallet holds now.	10

Full lists: Assets. Every method page has its parameters, credits and an example response.