> ## 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.

# Identity Lookup

> Resolve one address: by trading wallet (returns username, EOA, wallet type and the user's other wallets) or, if not a known trading wallet, by controlling EOA (returns every wallet that account controls).

One call, either direction: pass a trading wallet to get its username, controlling EOA, wallet type and the user's other deployed wallets — or pass an EOA to list every Polymarket wallet that account controls.

```bash theme={null}
curl "https://api.polynode.dev/v3/identities/0x204f72f35326db932158cba6adff0b9a1da95e14" \
  -H "x-api-key: $POLYNODE_API_KEY"
```


## OpenAPI

````yaml GET /v3/identities/{addr}
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/{addr}:
    get:
      tags:
        - Identity
      summary: Identity Lookup
      description: >-
        Resolve one address: by trading wallet (returns username, EOA, wallet
        type and the user's other wallets) or, if not a known trading wallet, by
        controlling EOA (returns every wallet that account controls).
      operationId: identity_get
      parameters:
        - name: addr
          in: path
          required: true
          description: Trading wallet or EOA.
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                identity:
                  eoa: '0xafcd9f5f78cb559c99d93f1914880df74cc3fc21'
                  other_wallets: []
                  username: swisstony
                  wallet_type: null
                matched_by: wallet
                query: '0x204f72f35326db932158cba6adff0b9a1da95e14'
                wallet: '0x204f72f35326db932158cba6adff0b9a1da95e14'
        '404':
          description: No identity found
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````