Skip to main content
GET
/
v1
/
resolve
/
{query}
Resolve wallet
curl --request GET \
  --url https://api.polynode.dev/v1/resolve/{query} \
  --header 'x-api-key: <api-key>'
{
  "safe": "0xfa85349327a63aa563029737f0492a79dca8f95d",
  "eoa": "0xc2783891b1d2287345e30f75e0f1ecd189a967d0",
  "username": "Letsgetit6969"
}

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Look up the full identity for any Polymarket user: trading wallet, EOA (externally owned account), username, and wallet type. Accepts any of the three identifiers as input and returns all fields. Supports both Polymarket’s original Safe proxy wallets and the newer deposit wallets. The response format is the same regardless of wallet type, with an additional type field to distinguish them.
​
query
string
required
One of:
  • Wallet address — Polymarket trading wallet: Safe proxy or deposit wallet (0x..., 42 chars)
  • EOA address — externally owned account (0x..., 42 chars)
  • Username — Polymarket display name (case-insensitive)

​
By wallet address (Safe)

Look up a Polymarket Safe proxy wallet to get the controlling EOA and username. 
curl "https://api.polynode.dev/v1/resolve/0xfa85349327a63aa563029737f0492a79dca8f95d" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0xfa85349327a63aa563029737f0492a79dca8f95d",
  "eoa": "0xc2783891b1d2287345e30f75e0f1ecd189a967d0",
  "username": "Letsgetit6969",
  "type": "safe"
}

​
By wallet address (deposit wallet)

Look up a Polymarket deposit wallet to get the controlling EOA. Deposit wallets are a newer wallet type introduced by Polymarket for new accounts. 
curl "https://api.polynode.dev/v1/resolve/0x8b60bf0f650bf7a0d93f10d72375b37de18f8c40" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0x8b60bf0f650bf7a0d93f10d72375b37de18f8c40",
  "eoa": "0xa60601a4d903af91855c52bfb3814f6ba342f201",
  "username": null,
  "type": "deposit_wallet"
}

​
By EOA address

Look up an EOA to find its Polymarket trading wallet and username. Works for both Safe and deposit wallet users. 
curl "https://api.polynode.dev/v1/resolve/0xc2783891b1d2287345e30f75e0f1ecd189a967d0" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0xfa85349327a63aa563029737f0492a79dca8f95d",
  "eoa": "0xc2783891b1d2287345e30f75e0f1ecd189a967d0",
  "username": "Letsgetit6969",
  "type": "safe"
}
Resolve a Polymarket magic-link wallet — the wallet type used by accounts created with email or social login. The endpoint returns the controlling EOA, recovered automatically. 
curl "https://api.polynode.dev/v1/resolve/0x16cbe223607a6513ae76d1e3751c78e4eabc2704" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0x16cbe223607a6513ae76d1e3751c78e4eabc2704",
  "eoa": "0xbe5ba588ab7173b34efc0706b881794951014293",
  "username": "MRF",
  "type": "proxy"
}

​
By username

Look up a Polymarket username to find both wallet addresses. Case-insensitive. 
curl "https://api.polynode.dev/v1/resolve/Fredi9999" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0x1f2dd6d473f3e824cd2f8a89d9c69fb96f6ad0cf",
  "eoa": null,
  "username": "Fredi9999",
  "type": "safe"
}

​
Response fields

​
safe
string
required
Polymarket trading wallet address. This is the address that holds positions and executes trades on Polymarket. For older accounts this is a Gnosis Safe proxy, for newer accounts it may be a deposit wallet.
​
eoa
string
Externally owned account that controls the trading wallet. This is the signer address. May be null for some magic-link wallets where the EOA cannot be determined.
​
username
string
Polymarket display name. null if the user has no profile set.
​
type
string
Wallet type. One of:
  • "safe" — Gnosis Safe proxy wallet (most existing Polymarket accounts)
  • "deposit_wallet" — deposit wallet (newer Polymarket accounts)
  • "proxy" — magic-link wallet (accounts created via email or social login)

​
Error responses

404 — Not found 
{"error": "Address not found."}

{"error": "Username not found."}

​
Coverage

The resolver supports every Polymarket wallet type on Polygon, including Safe proxy wallets and the newer deposit wallets. Cached lookups are sub-millisecond. Uncached lookups resolve on-chain in real time.

​
Use cases

  • Database enrichment — bulk-resolve trading wallets to EOAs for analytics pipelines
  • Profile lookups — show usernames alongside wallet addresses in your UI
  • Cross-referencing — match on-chain activity (EOA) to Polymarket activity (trading wallet)
  • Whale tracking — identify the EOA behind a trading wallet to track activity across protocols
  • Wallet type detection — use the type field to determine how a user’s account is set up

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
query
string
required

Safe address, EOA address, or Polymarket username (case-insensitive)

Response

Resolved wallet identity

​
safe
string

Polymarket proxy wallet address (Gnosis Safe)

​
eoa
string

Externally owned account (signer)

​
username
string | null

Polymarket display name, or null