Assets
getAssetBatch
Up to 1,000 assets by id in one call.
Details
- Endpoint
- POST getAssetBatch (JSON-RPC)
- Credits
- varies
- Pricing
- Depends on the input and the size of the result. The description says how.
- Rate class
- Light. Counts against your light requests per second.
Takes object ids and coin types (mixed is fine) and returns { items, asOf } with one entry per id in the same order, null where the id does not exist. Use it to enrich a list of ids from a transaction or wallet. The result is wrapped in an object so asOf can ride along. Costs 2 credits plus 1 per 10 ids.
Parameters
| Name | Type | Description |
|---|---|---|
| idsrequired | array of string | Object ids (0x...) and coin types (0x2::sui::SUI), at most 1,000.Up to 1000 items. |
| 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": "getAssetBatch",
"params": {
"ids": [
"0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
"0x2::sui::SUI"
]
}
}'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": "getAssetBatch",
"params": {
"ids": [
"0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
"0x2::sui::SUI"
]
}
}),
});
const data = await res.json();Response
JSON
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"total": 2,
"limit": 1000,
"cursor": null,
"items": [
{
"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"
}
]
},
"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:32.977Z"
},
"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"
}
}
},
{
"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": null,
"ownership_model": "none",
"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,
"price_info": {
"price_per_token": 0.8768611999999999,
"currency": "USDC",
"as_of": "2026-11-04T04:30:32.989Z"
}
},
"sui": {
"type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"version": null,
"digest": null,
"previousTransaction": null,
"display": null,
"metadataId": "0xf256d3fb6a50eaa748d94335b34f2982fbc3b63ceec78cafaa29ebc9ebaf2bbc"
}
}
],
"asOf": {
"checkpoint": 341439584,
"timestamp": "2026-11-04T04:30:31.579Z",
"lagMs": 1427
}
}
}Long lists are cut to a few items here.