Objects

objects.tree

Everything an object holds: dynamic fields, tables, wrapped structs and kiosk items.

Details

Endpoint: GET /v1/objects/:id/tree
Credits: 10
Rate class: Heavy. Counts against your heavy requests per second.

Walks down from an object and returns its children as a tree: dynamic fields and dynamic object fields, tables and bags, and structs wrapped inside its contents (found by their UID). Depth defaults to 2 and goes up to 3. Each level shows at most 50 children, and a node says moreChildren with a cursor for /dynamic-fields when it was cut; total work is capped too and the top level sets truncated when anything was left out. For a kiosk the answer also lists its items with listing price in MIST and lock state. Values are current, not historical.

Parameters

Name	Type	Description
idrequired	string	Object id (0x...).
depth	integer	Levels to walk down, default 2.From 1 to 3.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/objects/0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407/tree?depth=2" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/objects/0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407/tree?depth=2", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "objectId": "0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407",
  "type": "0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809::pool::Pool<0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI,0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC>",
  "version": 1071339318,
  "depth": 2,
  "children": [
    {
      "kind": "wrapped",
      "objectId": "0x50997b5f1f6401674d3d881a61e09a71776ee19cd8b83114a0a21b3a82f130b5",
      "path": "inner",
      "expanded": true,
      "children": [
        {
          "kind": "field",
          "objectId": "0x5c44ceb4c4e8ebb76813c729f8681a449ed1831129ac6e1cf966c7fcefe7dddb",
          "name": {
            "type": "u64",
            "value": "1"
          },
          "type": "0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809::pool::PoolInner<0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI,0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC>",
          "expanded": false,
          "valueOmitted": true
        }
      ],
      "childCount": 1,
      "moreChildren": false,
      "cursor": null
    },
    {
      "kind": "field",
      "objectId": "0x80b1a10261cbe450d2c0948a06efc7066739526c95f0074afe9252eaa08785fb",
      "name": {
        "type": "vector<u8>",
        "value": "ZXdtYQ=="
      },
      "type": "0x00c1a56ec8c4c623a848b2ed2f03d23a25d17570b670c22106f336eb933785cc::ewma::EWMAState",
      "expanded": true,
      "value": {
        "additional_taker_fee": "1000000",
        "alpha": "10000000",
        "enabled": false,
        "last_updated_timestamp": "1793781637643",
        "mean": "167011652881",
        "variance": "11972601077255",
        "z_score_threshold": "3000000000"
      }
    },
    {
      "kind": "field",
      "objectId": "0x283dc819809213e3d02c79171b6fe484e4e86251c3491f54835dc874d76873f8",
      "name": {
        "type": "0x0000000000000000000000000000000000000000000000000000000000000002::object::ID",
        "value": "0xf29fcdf2957836bd175a24d202d51a11eeb404c61cb4edbe6cc308ec532cfd97"
      },
      "type": "0x00c1a56ec8c4c623a848b2ed2f03d23a25d17570b670c22106f336eb933785cc::pool::ReferralRewards<0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI,0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC>",
      "expanded": true,
      "value": {
        "base": "0",
        "deep": "0",
        "multiplier": "2000000000",
        "quote": "0"
      }
    }
  ],
  "moreChildren": false,
  "cursor": null,
  "truncated": false,
  "asOf": {
    "checkpoint": 341501281,
    "timestamp": "2026-11-04T08:40:37.700Z",
    "lagMs": 634
  }
}

Long lists are cut to a few items here.