Chain

search

Find coins, names, packages, collections, addresses, objects and transactions.

Details

Endpoint: GET /v1/search
Credits: 1
Rate class: Light. Counts against your light requests per second.

Searches by free text or by id: a coin symbol or type, a SuiNS name, a package or module name, a validator, a collection, a 0x address or object id, a transaction digest, a checkpoint number. Returns ranked hits, each with a kind, title, id, a short subtitle and a link on tide.ad. interpretedAs says how the query was read. Use it to turn a name into an id before calling another method.

Parameters

Name	Type	Description
qrequired	string	Search text or id, up to 300 characters.
limit	integer	Hits to return, default 20.From 1 to 50.

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/search?q=deepbook&limit=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/search?q=deepbook&limit=5", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "query": "deepbook",
  "interpretedAs": "text",
  "items": [
    {
      "kind": "label",
      "title": "DeepBook",
      "id": "deepbook",
      "subtitle": "Order book, https://deepbook.tech",
      "verified": true,
      "url": "https://tide.adhttps://deepbook.tech"
    },
    {
      "kind": "address",
      "title": "DeepBook",
      "id": "0xbd1d25f49cc9b65f1e41d6c264ad0e065923de7ce6fd8b86d87d25c0a58742b9",
      "subtitle": "Project wallet",
      "verified": true,
      "url": "https://tide.ad/address/0xbd1d25f49cc9b65f1e41d6c264ad0e065923de7ce6fd8b86d87d25c0a58742b9"
    },
    {
      "kind": "address",
      "title": "DeepBook",
      "id": "0x37f187e1e54e9c9b8c78b6c46a7281f644ebc62e75493623edcaa6d1dfcf64d2",
      "subtitle": "Project wallet",
      "verified": true,
      "url": "https://tide.ad/address/0x37f187e1e54e9c9b8c78b6c46a7281f644ebc62e75493623edcaa6d1dfcf64d2"
    }
  ],
  "cursor": null,
  "asOf": {
    "checkpoint": 341482509,
    "timestamp": "2026-11-04T07:24:27.084Z",
    "lagMs": 1492
  }
}

Long lists are cut to a few items here.