v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Wallet

Fetches wallet information by providing either an EOA (Externally Owned Account) address, a proxy wallet address, or a user handle. Returns the associated EOA, proxy, wallet type, handle, pseudonym, and profile image. Optionally returns trading metrics when with_metrics=true.

get/polymarket/wallet

Query parameters

eoastring

Example:0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29

EOA (Externally Owned Account) wallet address. Either eoa, proxy, or handle must be provided, but not more than one.

proxystring

Example:0x60881d7dce725bfb0399ee0b11cc11f5782f257d

Proxy wallet address. Either eoa, proxy, or handle must be provided, but not more than one.

handlestring

Example:satoshi

User handle/username. Accepts both formats: username or @username (the @ prefix will be automatically stripped). Either eoa, proxy, or handle must be provided, but not more than one.

with_metrics'true' | 'false'

Example:true

Whether to include wallet trading metrics (total volume, trades, and markets). Pass true to include metrics. Metrics are computed only when explicitly requested for performance reasons.

start_timeinteger

Example:1640995200

Optional start date for metrics calculation (Unix timestamp in seconds). Only used when with_metrics=true.

end_timeinteger

Example:1672531200

Optional end date for metrics calculation (Unix timestamp in seconds). Only used when with_metrics=true.

Response

Wallet information response

eoastring required

The EOA (Externally Owned Account) wallet address

proxystring required

The proxy wallet address

wallet_typestring required

The type of wallet

handlestring nullable

User handle/username

pseudonymstring nullable

User pseudonym/display name

imagestring nullable

User profile image URL

Example response

{
  "eoa": "0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29",
  "proxy": "0x60881d7dce725bfb0399ee0b11cc11f5782f257d",
  "wallet_type": "safe",
  "handle": "satoshi",
  "pseudonym": "Satoshi Nakamoto",
  "image": "https://example.com/avatar.png",
  "wallet_metrics": {
    "total_volume": 150000.5,
    "total_trades": 450,
    "total_markets": 25,
    "highest_volume_day": {
      "date": "2025-10-12",
      "volume": 25000.75,
      "trades": 145
    },
    "merges": 262,
    "splits": 31,
    "conversions": 4,
    "redemptions": 2338
  }
}