> ## 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, wallet types, deployment status, and current status in one call.

Resolve up to 1,000 trading wallets per call against PolyNode's identity index (refreshed daily). Each found identity includes `wallet_type`, `deployed`, and `current`. 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, wallet types, deployment status, and current status in one call.
      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: safe
                    deployed: true
                    current: true
                  '0x84cfffc3f16dcc353094de30d4a45226eccd2f63':
                    eoa: '0x30694d545db14898353d6dbf2b1dcd9c993fd5c2'
                    username: mooseborzoi
                    wallet_type: proxy
                    deployed: true
                    current: true
                requested: 2
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````