> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serialized.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Labels: batch

> Batch twin: the labels of up to 100 wallets in one call, EVM and Solana mixed freely. Response in input order, one slot per wallet, billed 2 credits per 25 wallets.

`POST /v1/wallet/labels` · **2 credits per 25 wallets**

Batch twin: the labels of up to 100 wallets in one call, EVM and Solana mixed freely, response in input order. Each slot is `{ data }`, the body of the single GET for that wallet, or `{ error: { code, message } }` for that address alone: an invalid address never fails the others. Send `{ "items": [{ "address": "…" }] }`, 1 to 100 items. Billed 2 credits per 25 wallets served: up to 25 wallets cost 2 credits, 26 to 50 cost 4, and so on; an address sent twice counts once, and a slot in error is not billed.

> [!NOTE]
>
> A slot's `data` is exactly what [`GET /v1/wallet/labels`](https://docs.serialized.xyz/endpoints/wallet-labels) returns for that wallet: `address`, `labels`, `labelTokens`, `entity`, `funding`, `profile` and `linkedWallets`; see that page for the fields.

```bash cURL theme={null}
curl -X POST 'https://api.serialized.xyz/v1/wallet/labels' \
  -H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"items":[{"address":"3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u"},{"address":"0xd13da05b9288ba4961973110594bd0fe3428791f"},{"address":"not-a-wallet"}]}'
```

```json Response theme={null}
{
  "data": [
    {
      "data": {
        "address": "3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u",
        "labels": [
          "whale"
        ],
        "labelTokens": {
          "checked": 50,
          "sniper": 0,
          "bundler": 0,
          "whale": 8,
          "insider": 0
        },
        "entity": null,
        "platform": null,
        "funding": {
          "chain": "solana",
          "funder": {
            "address": "5VCwKtCXgCJ6kit5FybXjvriW3xELsFDhYrPSqtJNmcD",
            "name": "OKX",
            "logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg",
            "entity": {
              "name": "OKX",
              "type": "cex",
              "labels": [
                "custody"
              ],
              "logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg"
            }
          },
          "fundedAt": 1634019095000,
          "txHash": "3TN6yZK7z9gUhKU8XXxhJdN3uDY5FRqGZeMY2rSZMKxUGENMtnwiF8KxhrgcNZfvey8da9BRRNcFgtSVKQNxDmCe",
          "amountNative": "3000000000",
          "amount": 3,
          "currency": {
            "symbol": "SOL",
            "name": "Solana",
            "decimals": 9,
            "logo": "https://cdn.serialized.xyz/dex/coin-sol.c107b7bd.png",
            "address": "So11111111111111111111111111111111111111112"
          }
        },
        "profile": null,
        "linkedWallets": []
      }
    },
    {
      "data": {
        "address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
        "labels": [
          "smartTrader"
        ],
        "labelTokens": null,
        "entity": null,
        "platform": {
          "id": "uniswap",
          "name": "Uniswap",
          "logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
        },
        "funding": {
          "chain": "evm:8453",
          "funder": {
            "address": "0x20fe51a9229eef2cf8ad9e89d91cab9312cf3b7a",
            "name": "Coinbase",
            "logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png",
            "entity": {
              "name": "Coinbase",
              "type": null,
              "labels": [],
              "logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png"
            }
          },
          "fundedAt": 1722264859000,
          "txHash": "0xb0634b8a6581f0ce99b8cb6ac8f986fb290cb9c34641c4197d8d56c30586ffff",
          "amountNative": "49999990000000000",
          "amount": 0.04999999,
          "currency": {
            "symbol": "ETH",
            "name": "Ethereum",
            "decimals": 18,
            "logo": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png",
            "address": "0x0000000000000000000000000000000000000000"
          }
        },
        "profile": {
          "address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
          "displayName": null,
          "avatarUrl": null,
          "ensName": null,
          "basename": null,
          "solName": null,
          "bio": null,
          "socials": null,
          "followerCounts": null,
          "isProTrader": false,
          "isSmartTrader": true
        },
        "linkedWallets": []
      }
    },
    {
      "error": {
        "code": "INVALID_PARAM",
        "message": "Invalid address \"not-a-wallet\": expected a base58 Solana address"
      }
    }
  ],
  "meta": {
    "asOf": 1794357470820
  }
}
```


## OpenAPI

````yaml openapi.json POST /v1/wallet/labels
openapi: 3.1.0
info:
  title: Serialized Data API
  description: >-
    On-chain data for trading apps - tokens, candles, token filters. Built on
    our own indexers. 19 EVM chains + Solana, live.
  version: 0.1.0
servers:
  - url: https://demo.serialized.xyz
    description: 'Demo: no key needed, read endpoints, rate-limited per IP'
  - url: https://api.serialized.xyz
    description: 'Production: your API key in the Authorization header'
security:
  - apiKey: []
  - {}
paths:
  /v1/wallet/labels:
    post:
      summary: 'Wallet Labels: batch'
      description: >-
        Batch twin: the labels of up to 100 wallets in one call, EVM and Solana
        mixed freely, response in input order. Each slot is `{ data }`, the body
        of the single GET for that wallet, or `{ error: { code, message } }` for
        that address alone: an invalid address never fails the others. Billed 2
        credits per 25 wallets served: up to 25 wallets cost 2 credits, 26 to 50
        cost 4, and so on; an address sent twice counts once, and a slot in
        error is not billed.
      operationId: wallet-labels-batch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              required:
                - items
              properties:
                items:
                  minItems: 1
                  maxItems: 100
                  type: array
                  items:
                    additionalProperties: false
                    type: object
                    required:
                      - address
                    properties:
                      address:
                        description: Wallet address (EVM hex or Solana base58)
                        type: string
                  description: >-
                    `[{ "address": "…" }]` - 1 to 100 items, EVM and Solana
                    mixed freely.
                  example:
                    - address: 3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u
                    - address: '0xd13da05b9288ba4961973110594bd0fe3428791f'
                  x-default:
                    - address: 3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u
                    - address: '0xd13da05b9288ba4961973110594bd0fe3428791f'
      responses:
        '200':
          description: Standard `{ data, meta }` envelope.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
      description: Your raw API key (not needed on the demo server).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.