Assets

getKiosk

A kiosk: who controls it, what is in it, and what is listed at what price.

Details

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

Returns the kiosk's controlling address (the holder of its KioskOwnerCap), the cap id, profits, and a page of its items. Each item has its id (pass it to getAsset for full details), type, name, image, whether it is locked, and its listing when listed: the price a buyer pays in SUI with USD and its price time, and the venue (kiosk, Tradeport and so on). limit counts kiosk entries per page (an item can use up to three entries: item, lock, listing), so pages may hold fewer items than limit. Continue with cursor.

Parameters

Name	Type	Description
idrequired	string	Kiosk object id (0x...).
limit	integer	Kiosk entries per page.Default 100. From 1 to 100.
cursor	string	Cursor from the previous response.

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": "getKiosk",
  "params": {
    "id": "0x57086347a30d901959121b754afe961c475541636ab2b98001ef11503c8b5509"
  }
}'

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

Response

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "0x57086347a30d901959121b754afe961c475541636ab2b98001ef11503c8b5509",
    "version": "1069836665",
    "owner": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
    "ownerCapId": "0x5b891235165152ccd082f7455449ba6ace03d48af38038fc843ab9db2cf3140a",
    "personal": false,
    "itemCount": 1,
    "profits": {
      "amountRaw": "0",
      "amount": 0,
      "symbol": "SUI",
      "usd": 0,
      "priceAsOf": "2026-11-04T12:22:07.413Z"
    },
    "allowExtensions": false,
    "total": 1,
    "limit": 100,
    "cursor": null,
    "items": [
      {
        "id": "0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "type": "0xb908f3c6fea6865d32e2048c520cdfe3b5c5bbcebb658117c41bad70f52b7ccc::popkins_nft::Popkins",
        "name": "Popkins #10861",
        "image": "https://storage.claynosaurz.com/popkins/images/0xae81a1f657fa67206d3de56546fb476a2726266e06ad8ae225cd8f161887c1e0",
        "locked": true,
        "listed": true,
        "listing": {
          "venue": "tradeport",
          "price": {
            "amountRaw": "41029200000",
            "amount": 41.0292,
            "symbol": "SUI",
            "usd": 36.961653,
            "priceAsOf": "2026-11-04T12:22:07.413Z"
          }
        }
      }
    ],
    "asOf": {
      "checkpoint": 341555830,
      "timestamp": "2026-11-04T12:22:06.049Z",
      "lagMs": 1040
    }
  }
}