Wallet

wallet.batchIdentity

Identity of up to 100 wallets in one call.

Details

Endpoint: POST /v1/wallet/batch-identity
Credits: varies
Pricing: Depends on the input and the size of the result. The description says how.
Rate class: Light. Counts against your light requests per second.

Takes { addresses: [...] } with up to 100 entries, each an address, name.sui or @name, and returns one identity per entry in the same order. An entry that came from a name carries inputDomain. A name that does not resolve comes back in place as { address: null, type: "unknown", inputDomain, unresolved: true }. Wallets with no label are returned with type unknown. Batch lookups use the default SuiNS name only: call identity for the full list of names.

Parameters

Name	Type	Description
addressesrequired	array of string	Up to 100 addresses, name.sui or @name values.Up to 100 items.

Request

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

curl

curl -X POST "https://api.tide.ad/v1/wallet/batch-identity" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "addresses": [
    "0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd",
    "@nobody-here-xyz"
  ]
}'

TypeScript

const res = await fetch("https://api.tide.ad/v1/wallet/batch-identity", {
  method: "POST",
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "addresses": [
      "0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd",
      "@nobody-here-xyz"
    ]
  }),
});
const data = await res.json();

Response

JSON

{
  "items": [
    {
      "address": "0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd",
      "name": "Binance Hot Wallet 1",
      "category": "Centralized Exchange",
      "type": "exchange",
      "tags": [
        "Centralized Exchange"
      ],
      "suiNames": []
    },
    {
      "address": null,
      "type": "unknown",
      "inputDomain": "@nobody-here-xyz",
      "unresolved": true
    }
  ],
  "asOf": {
    "checkpoint": 341486213,
    "timestamp": "2026-11-04T07:39:32.521Z",
    "lagMs": 1839
  }
}