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

# Batch Resolve

> Resolve up to 1,000 Polymarket trading wallets to usernames, controlling EOAs and wallet types in one call — roughly 1000x the throughput of per-wallet resolution.

Resolve up to 1,000 trading wallets per call against PolyNode's identity index (11.9M wallets, refreshed daily). Answers come from a single indexed query — typical response time is tens of milliseconds regardless of batch size.

Wallets without a known identity come back as `null`, so the response always covers every requested wallet. For richer single-wallet resolution (live on-chain fallback for brand-new wallets), the [Resolve Wallet](/api-reference/wallets/resolve) endpoint remains the deepest option.

```bash theme={null}
curl -X POST "https://api.polynode.dev/v3/identities/batch" \
  -H "x-api-key: $POLYNODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallets": ["0x204f72f35326db932158cba6adff0b9a1da95e14"]}'
```


## OpenAPI

````yaml POST /v3/identities/batch
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/identities/batch:
    post:
      tags:
        - Identity
      summary: Batch Resolve
      description: >-
        Resolve up to 1,000 Polymarket trading wallets to usernames, controlling
        EOAs and wallet types in one call — roughly 1000x the throughput of
        per-wallet resolution.
      operationId: identity_batch
      requestBody:
        required: true
        content:
          application/json:
            example:
              wallets:
                - '0x204f72f35326db932158cba6adff0b9a1da95e14'
                - '0x84cfffc3f16dcc353094de30d4a45226eccd2f63'
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                found: 2
                identities:
                  '0x204f72f35326db932158cba6adff0b9a1da95e14':
                    eoa: '0xafcd9f5f78cb559c99d93f1914880df74cc3fc21'
                    username: swisstony
                    wallet_type: null
                  '0x84cfffc3f16dcc353094de30d4a45226eccd2f63':
                    eoa: '0x30694d545db14898353d6dbf2b1dcd9c993fd5c2'
                    username: mooseborzoi
                    wallet_type: proxy
                requested: 2
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````