---
title: "Get Wallet Identity"
method: GET
path: "/v2/polymarket/wallet/identity/{wallet}"
tags: ["polymarket"]
---

# Get Wallet Identity

`GET /v2/polymarket/wallet/identity/{wallet}`

Fetch identity + profile metadata for a wallet:
display name, pseudonym, profile image (pfp), X handle, verified/creator/mod
badges, type (proxy/safe/eoa), signer, USDC balance, and timestamps.

Lookup matches against either the proxy address (`wallet.id`) or the
underlying signer EOA (`wallet.signer`).

## Path parameters

- `wallet` string, required — Wallet address (proxy or signer EOA)

## Response `200`

Successful Response

- WalletIdentityResponse — Response for the single-wallet identity endpoint.
  - `address` string, required — Requested wallet address (lowercased)
  - `found` boolean, required — Whether a wallet record was found
  - `profile` WalletIdentity — Identity + profile metadata for a Polymarket wallet.
    - `address` string, required — Wallet address (proxy / safe address)
    - `signer` string, nullable — Underlying EOA / signer address
    - `type` string, nullable — Wallet type (proxy, safe, eoa, etc.)
    - `display_name` string, nullable — User-set display name from Gamma profile
    - `pseudonym` string, nullable — Auto-generated pseudonym
    - `bio` string, nullable — User bio
    - `profile_image` string, nullable — Profile picture URL
    - `x_username` string, nullable — Linked X (Twitter) username
    - `verified_badge` boolean — Verified badge on Polymarket
    - `is_creator` boolean — Polymarket market creator
    - `is_mod` boolean — Polymarket moderator
    - `usdc_balance` number — On-chain USDC balance (USD)
    - `last_transfer_at` integer, nullable — Unix ts of last USDC transfer
    - `created_at` integer, nullable — Unix ts the wallet was first observed
    - `profile_fetched_at` integer, nullable — Unix ts profile was last refreshed from Gamma

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)