Wallet Labels (Batch)

GET/gateway/v1/wallet/labels/batch

Returns entity labels for multiple wallet addresses.

Pass up to 100 comma-separated addresses via the `addresses` query parameter.

Included fields: entity name, type, and labels per address.

Query Parameters

addressesstringrequired

Comma-separated wallet addresses to look up, max 100

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045,0xdead

Wallet Labels (Batch)

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/wallet/labels/batch?addresses=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045,0xdead', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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