Wallet Search

GET/gateway/v1/search/wallet

Searches wallets by ENS name, address label, or address prefix.

Returns matching wallet addresses with entity labels.

Query Parameters

qstringrequired

Search keyword like `binance`, `vitalik.eth`, or `0xd8dA...`

Example: vitalik.eth

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Wallet Search

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/search/wallet?q=vitalik.eth&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseWalletSearchItem.json",
  "data": [
    {
      "address": "<string>",
      "addresses": [
        {
          "address": "<string>",
          "chain": "<string>"
        }
      ],
      "chain": "<string>",
      "entity_name": "<string>",
      "entity_type": "<string>",
      "label": "<string>",
      "num_addresses": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}