Search by name, SuiNS, address, digest, object ID, coin type or checkpoint.

API

query.list

Browse saved queries

Details

Endpoint
GET /v1/queries
Credits
Free
Rate class
Light. Counts against your light requests per second.

Public queries sorted by trending (stars, forks, views and runs this week), new, top or updated. Filter by owner (address), q (text in name, description or tags) or starred=1 (what you starred). Pages with limit and offset.

Parameters

NameTypeDescription
sortstringOne of "trending", "new", "top", "updated".
ownerstring
qstring
starredstring
limitinteger
offsetinteger

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/queries?sort=trending&limit=10" \
  -H "x-api-key: YOUR_API_KEY"
TypeScript
const res = await fetch("https://api.tide.ad/v1/queries?sort=trending&limit=10", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON
{
  "items": [
    {
      "query_id": 57,
      "name": "Aftermath transactions and users by product",
      "description": "Per day over the last 180 days: Sui user transactions whose main package (the package with the most Move calls) belongs to each Aftermath product, and the distinct senders of those transactions. Today is the day so far, about a minute behind the chain.",
      "owner": "0x0000000000000000000000000000000000000000000000000000000074696465",
      "dialect": "tide",
      "parameters": [],
      "visualization_types": [
        "bar",
        "bar",
        "table"
      ],
      "tags": [
        "starter:af-products-daily",
        "aftermath",
        "products"
      ],
      "is_private": false,
      "is_archived": false,
      "forked_from": null,
      "stars": 0,
      "forks": 0,
      "runs": 292,
      "starred": false,
      "last_execution_id": "0101A1AEFC6E728A42631AFB4478D001C5",
      "last_run_at": "2026-11-06T03:52:23.728Z",
      "created_at": "2026-11-03T22:31:02.530Z",
      "updated_at": "2026-11-06T02:45:53.322Z"
    },
    {
      "query_id": 52,
      "name": "Aftermath share of Sui activity, last 24 hours",
      "description": "Aftermath's share of all Sui user transactions, senders and gas over the last 24 hours (counted in whole UTC hours: the current hour so far and the 23 before it), under two definitions: the transaction calls any Aftermath package, or Aftermath is the main protocol (the package with the most Move calls in the transaction is Aftermath's). Shares are of user transactions. Gas is the gas paid: each transaction's gas net of storage rebates, counted as 0 when its rebate beats its cost.",
      "owner": "0x0000000000000000000000000000000000000000000000000000000074696465",
      "dialect": "tide",
      "parameters": [],
      "visualization_types": [
        "counter",
        "counter",
        "counter"
      ],
      "tags": [
        "starter:af-share-windows",
        "aftermath",
        "share"
      ],
      "is_private": false,
      "is_archived": false,
      "forked_from": null,
      "stars": 0,
      "forks": 0,
      "runs": 823,
      "starred": false,
      "last_execution_id": "0101A1AEFF73D39F48F894D0644BE8EB30",
      "last_run_at": "2026-11-06T03:55:41.194Z",
      "created_at": "2026-11-03T22:31:02.528Z",
      "updated_at": "2026-11-06T02:45:53.318Z"
    },
    {
      "query_id": 69,
      "name": "Aftermath perpetuals top traders",
      "description": "The 50 account owners with the most taker notional over the chosen number of days, with trades, markets, fees and liquidations.",
      "owner": "0x0000000000000000000000000000000000000000000000000000000074696465",
      "dialect": "tide",
      "parameters": [
        {
          "key": "days",
          "type": "number",
          "value": 30
        }
      ],
      "visualization_types": [
        "table"
      ],
      "tags": [
        "starter:af-perps-top-traders",
        "aftermath",
        "perps"
      ],
      "is_private": false,
      "is_archived": false,
      "forked_from": null,
      "stars": 0,
      "forks": 0,
      "runs": 300,
      "starred": false,
      "last_execution_id": "0101A1AEF9B1D83AEB6309A8637F0FFA9D",
      "last_run_at": "2026-11-06T03:49:22.010Z",
      "created_at": "2026-11-03T22:31:02.534Z",
      "updated_at": "2026-11-06T02:45:53.340Z"
    }
  ],
  "next_offset": 10
}

Long lists are cut to a few items here.