Wallet

wallet.identity

Who a wallet is: known label and SuiNS names.

Details

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

Returns the label tide knows for a wallet (exchange, bot, named wallet) and every SuiNS name it owns as { address, name, category, type, tags } plus suiNames. Returns 404 when the wallet has no label and no SuiNS name. The wallet can be an address, name.sui or @name. Use batch-identity for many wallets at once.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.

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/wallet/0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd/identity" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/wallet/0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd/identity", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "address": "0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd",
  "name": "Binance Hot Wallet 1",
  "category": "Centralized Exchange",
  "type": "exchange",
  "tags": [
    "Centralized Exchange"
  ],
  "suiNames": [],
  "asOf": {
    "checkpoint": 341440079,
    "timestamp": "2026-11-04T04:32:54.559Z",
    "lagMs": 694
  }
}