Skip to main content
GET
/
polymarket
/
wallet
Get Wallet
curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/wallet \
  --header 'Authorization: Bearer <token>'
{
  "eoa": "0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29",
  "proxy": "0x60881d7dce725bfb0399ee0b11cc11f5782f257d",
  "wallet_type": "safe",
  "handle": "satoshi",
  "pseudonym": "Satoshi Nakamoto",
  "image": "https://example.com/avatar.png"
}
Wallet fetches Polymarket 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 includes trading metrics such as total volume, number of trades, and unique markets traded when with_metrics=true. Best for: Looking up wallet identities, resolving handles to addresses, retrieving user profiles, analyzing wallet trading performance. Endpoint: GET /polymarket/wallet
Note: Exactly one of eoa, proxy, or handle must be provided per request.

​
Example

curl -X GET "https://api.aisa.one/apis/v1/polymarket/wallet?handle=satoshi&with_metrics=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

The response returns wallet identity fields including eoa, proxy, wallet_type, handle, pseudonym, and image. When with_metrics=true is set, a wallet_metrics object is also included with total volume, total trades, total markets, highest volume day, and counts for merges, splits, conversions, and redemptions.

Authorizations

​
Authorization
string
header
required

Your AIsa API key as a Bearer token.

Query Parameters

​
eoa
string

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

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0xe9a69b28ffd86f6ea0c5d8171c95537479b84a29"

​
proxy
string

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

Pattern: ^0x[0-9a-fA-F]{40}$
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)