Skip to main content
GET
/
polymarket
/
wallet
Get Wallet
curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/wallet
{
  "eoa": "0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29",
  "proxy": "0x60881d7dce725bfb0399ee0b11cc11f5782f257d",
  "wallet_type": "safe",
  "handle": "satoshi",
  "pseudonym": "Satoshi Nakamoto",
  "image": "https://example.com/avatar.png"
}

Query Parameters

​
eoa
string

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

Example:

"0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29"

​
proxy
string

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

Example:

"0x60881d7dce725bfb0399ee0b11cc11f5782f257d"

​
handle
string

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.

Example:

"satoshi"

​
with_metrics
enum<string>

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.

Available options:
true,
false
Example:

"true"

​
start_time
integer

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

Example:

1640995200

​
end_time
integer

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

Example:

1672531200

Response

Wallet information response

​
eoa
string
required

The EOA (Externally Owned Account) wallet address

Example:

"0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29"

​
proxy
string
required

The proxy wallet address

Example:

"0x60881d7dce725bfb0399ee0b11cc11f5782f257d"

​
wallet_type
string
required

The type of wallet

Example:

"safe"

​
handle
string | null

User handle/username

Example:

"satoshi"

​
pseudonym
string | null

User pseudonym/display name

Example:

"Satoshi Nakamoto"

​
image
string | null

User profile image URL

Example:

"https://example.com/avatar.png"

​
wallet_metrics
object

Trading metrics for this wallet (only present when with_metrics=true)