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

# Username Search

> Search 5M+ Polymarket usernames by substring, similarity-ranked with exact matches first. Polymarket has no public username search.

Find Polymarket accounts by (partial) username across 5M+ named wallets. Results are ranked by similarity with exact matches first. Not available anywhere in Polymarket's public API.

```bash theme={null}
curl "https://api.polynode.dev/v3/identities/search?q=swiss&limit=10" \
  -H "x-api-key: $POLYNODE_API_KEY"
```


## OpenAPI

````yaml GET /v3/identities/search
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/search:
    get:
      tags:
        - Identity
      summary: Username Search
      description: >-
        Search 5M+ Polymarket usernames by substring, similarity-ranked with
        exact matches first. Polymarket has no public username search.
      operationId: identity_search
      parameters:
        - name: q
          in: query
          required: true
          description: Search text, 2-60 characters.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Max results, up to 50 (default 20).
          schema:
            type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                count: 3
                query: swisstony
                results:
                  - eoa: '0xafcd9f5f78cb559c99d93f1914880df74cc3fc21'
                    exact: true
                    username: swisstony
                    wallet: '0x204f72f35326db932158cba6adff0b9a1da95e14'
                    wallet_type: null
                  - eoa: '0x1062f9d6324a75c2ddcb7d0bc952fafc0efad5d8'
                    exact: false
                    username: swisstony1111
                    wallet: '0x2abcbec8775c6ff69a8ceab565b78f585105b438'
                    wallet_type: safe
                  - eoa: '0xae2f27034b1bc11c68e5b88f8c875ca614dbf38a'
                    exact: false
                    username: testswisstonyy
                    wallet: '0x7d48c9fa8eff21911307dd0e953436c39820452b'
                    wallet_type: safe
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````