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": "platform",
      "title": "DeepBook",
      "id": "deepbook",
      "subtitle": "DEX",
      "verified": true,
      "url": "https://tide.ad/platform/deepbook"
    },
    {
      "kind": "coin",
      "title": "DEEP",
      "id": "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
      "subtitle": "DeepBook Token",
      "verified": true,
      "url": "https://tide.ad/coin/deep",
      "priceUsd": 0.014747046
    },
    {
      "kind": "address",
      "title": "DeepBook",
      "id": "0xbd1d25f49cc9b65f1e41d6c264ad0e065923de7ce6fd8b86d87d25c0a58742b9",
      "subtitle": "Project wallet",
      "verified": true,
      "url": "https://tide.ad/address/0xbd1d25f49cc9b65f1e41d6c264ad0e065923de7ce6fd8b86d87d25c0a58742b9"
    }
  ],
  "cursor": null,
  "asOf": {
    "checkpoint": 342145347,
    "timestamp": "2026-11-06T03:55:21.749Z",
    "lagMs": 2592
  }
}

Long lists are cut to a few items here.