Resolve Wallet - PolyNode

Resolve wallet

curl --request GET \
  --url https://api.polynode.dev/v1/resolve/{query} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v1/resolve/{query}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polynode.dev/v1/resolve/{query}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polynode.dev/v1/resolve/{query}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v1/resolve/{query}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "safe": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
  "eoa": "0xf6771e0308add4131b56989ca969c84b8c9f2155",
  "username": "hfheohebe",
  "type": "deposit_wallet",
  "wallets": {
    "deposit_wallet": null,
    "safe": null,
    "proxy_wallet": null
  },
  "wallet_details": [
    {
      "address": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
      "wallet_type": "deposit_wallet",
      "deployed": false,
      "current": true
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

GET

resolve

{query}

Resolve wallet

curl --request GET \
  --url https://api.polynode.dev/v1/resolve/{query} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v1/resolve/{query}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polynode.dev/v1/resolve/{query}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polynode.dev/v1/resolve/{query}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v1/resolve/{query}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "safe": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
  "eoa": "0xf6771e0308add4131b56989ca969c84b8c9f2155",
  "username": "hfheohebe",
  "type": "deposit_wallet",
  "wallets": {
    "deposit_wallet": null,
    "safe": null,
    "proxy_wallet": null
  },
  "wallet_details": [
    {
      "address": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
      "wallet_type": "deposit_wallet",
      "deployed": false,
      "current": true
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Look up the full identity for any Polymarket user: preferred trading wallet, EOA (externally owned account), username, wallet type, deployment status, and related wallets. Accepts any identifier as input and returns all fields.

If the controlling EOA has a deployed deposit wallet, safe returns that deposit wallet and type is "deposit_wallet" — even when you query the EOA, username, or an older wallet. If no deposit wallet is deployed, safe falls back to the existing Safe/proxy wallet. The safe field name is kept for backward compatibility; it means the preferred Polymarket trading wallet.

string

required

One of:

Wallet address — any Polymarket trading wallet: deposit wallet, Safe, or proxy wallet (0x..., 42 chars)
EOA address — externally owned account (0x..., 42 chars)
Username — Polymarket display name (case-insensitive)

Understanding Polymarket wallet types

Polymarket has used a few different wallet types over the years, depending on how an account signed up. You never need to know which one you’re dealing with — pass any address and the endpoint works it out — but here’s what the type values mean:

`type`	Who has one
`deposit_wallet`	Every new Polymarket account. The deposit wallet is the current standard wallet type.
`safe`	Older accounts that signed up by connecting a browser wallet (MetaMask etc.) — these got a Gnosis Safe.
`proxy`	Older accounts that signed up with an email or social login — these got a Polymarket proxy wallet.

“Deposit wallet” vs “beacon wallet”: if you’ve seen both terms, they’re the same thing. Newer deposit wallets are built so Polymarket can upgrade all of them at once — that upgradeable variant is what gets called a “beacon wallet”. There’s also an earlier standalone variant from before that change. Both behave identically and both resolve here; you never need to tell them apart. One user can have more than one wallet — for example an old Safe from years ago plus a new deposit wallet.

Wallet type, deployment, and current wallet

These fields answer three separate questions:

Field	What it tells you
`wallet_type`	What kind of Polymarket wallet the address is: `deposit_wallet`, `safe`, or `proxy`.
`deployed`	Whether the wallet contract currently exists on Polygon.
`current`	Whether this is the trading-wallet address currently selected for the account. This is the address returned in the legacy top-level `safe` field.

The legacy wallets object remains deployed-only: an address appears there only after its contract exists on Polygon. The additive wallet_details list includes the current address even if it is not deployed yet, plus the user’s other deployed wallets. This makes mixed accounts explicit without changing any existing field. For example, this account’s current address is a deposit wallet, but its contract has not been deployed yet:

{
  "safe": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
  "eoa": "0xf6771e0308add4131b56989ca969c84b8c9f2155",
  "username": "hfheohebe",
  "type": "deposit_wallet",
  "wallets": {
    "deposit_wallet": null,
    "safe": null,
    "proxy_wallet": null
  },
  "wallet_details": [
    {
      "address": "0xb8fa41b48c092ff003686ddbe64c031a6e275611",
      "wallet_type": "deposit_wallet",
      "deployed": false,
      "current": true
    }
  ]
}

By wallet address (Safe)

Look up a Polymarket Safe to get the controlling EOA and username. If that EOA also has a deployed deposit wallet, the response returns the deposit wallet in safe instead.

curl "https://api.polynode.dev/v1/resolve/0xfa85349327a63aa563029737f0492a79dca8f95d" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0xfa85349327a63aa563029737f0492a79dca8f95d",
  "eoa": "0xc2783891b1d2287345e30f75e0f1ecd189a967d0",
  "username": "Letsgetit6969",
  "type": "safe",
  "wallets": {
    "deposit_wallet": null,
    "safe": "0xfa85349327a63aa563029737f0492a79dca8f95d",
    "proxy_wallet": null
  }
}

By wallet address (deposit wallet)

Look up a deposit wallet to get the controlling EOA. Works for both deposit wallet variants.

curl "https://api.polynode.dev/v1/resolve/0x8b60bf0f650bf7a0d93f10d72375b37de18f8c40" \
  -H "x-api-key: YOUR_KEY"

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

By EOA address

Look up an EOA to find its Polymarket trading wallet and username. Deposit wallets are prioritized when deployed:

curl "https://api.polynode.dev/v1/resolve/0x7be2f44bd50761ec940fc5dc535e200b31c69377" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0xd10b418250d9a87e3162de6c8c9bd76b46f011e1",
  "eoa": "0x7be2f44bd50761ec940fc5dc535e200b31c69377",
  "username": "KauaiMagic",
  "type": "deposit_wallet",
  "wallets": {
    "deposit_wallet": "0xd10b418250d9a87e3162de6c8c9bd76b46f011e1",
    "safe": null,
    "proxy_wallet": null
  }
}

By wallet address (proxy wallet)

Resolve a Polymarket proxy 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",
  "wallets": {
    "deposit_wallet": null,
    "safe": null,
    "proxy_wallet": "0x16cbe223607a6513ae76d1e3751c78e4eabc2704"
  }
}

By username

Look up a Polymarket username to find the trading wallet and EOA. Case-insensitive.

curl "https://api.polynode.dev/v1/resolve/Fredi9999" \
  -H "x-api-key: YOUR_KEY"

{
  "safe": "0x1f2dd6d473f3e824cd2f8a89d9c69fb96f6ad0cf",
  "eoa": "0x92fee51e468fcd2467e89300be7ca4b5ed7ccfb3",
  "username": "Fredi9999",
  "type": "proxy",
  "wallets": {
    "deposit_wallet": null,
    "safe": null,
    "proxy_wallet": "0x1f2dd6d473f3e824cd2f8a89d9c69fb96f6ad0cf"
  }
}

Response fields

string

required

Preferred Polymarket trading wallet address. The field name is kept for backward compatibility. If the controlling EOA has a deployed deposit wallet, this is the deposit wallet. Otherwise it is the existing Safe/proxy wallet.

string

Externally owned account that controls the trading wallet. This is the signer address. May be null in rare cases where it cannot be determined.

string

Polymarket display name. null if the user has no profile set.

string

Wallet type for the address returned in safe. One of "deposit_wallet", "safe", or "proxy" — see wallet types above. null only when the resolver cannot verify the wallet’s implementation.

object

Every Polymarket wallet this user has deployed, by type. Each field is an address or null:

wallets.deposit_wallet — their deposit wallet (either variant)
wallets.safe — their Gnosis Safe
wallets.proxy_wallet — their proxy wallet

Useful when a user has more than one — for example, matching historical activity on an old Safe with current activity on a new deposit wallet.

array

Status for the current wallet and every other deployed wallet associated with the EOA. Each item contains:

address — wallet address
wallet_type — "deposit_wallet", "safe", or "proxy"; rarely null when the implementation cannot be verified
deployed — true when contract code currently exists on Polygon
current — true for the selected trading-wallet address returned in safe

Use this list when you need to distinguish wallet type from deployment, or when an account has both a Safe/proxy and a deposit wallet.

Error responses

404 — Not found

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

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

Coverage

The resolver supports every Polymarket wallet type on Polygon: deposit wallets (both variants), Gnosis Safes, and proxy wallets. Cached lookups are sub-millisecond. Uncached lookups resolve in real time, then prefer a deployed deposit wallet when one exists for the resolved EOA.

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 the preferred Polymarket trading wallet
Whale tracking — identify the EOA behind a trading wallet to track activity across protocols
Multi-wallet users — use wallet_details to distinguish the current wallet from other deployed wallet types

Authorizations

x-api-key

string

header

required

Path Parameters

query

string

required

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

Response

Resolved wallet identity

safe

string

Preferred Polymarket trading wallet. Field name is kept for backward compatibility; deposit wallet is returned when deployed, otherwise Safe/proxy.

eoa

string | null

Externally owned account (signer)

username

string | null

Polymarket display name, or null

type

enum<string> | null

Wallet type for the address returned in safe

Available options:

safe,

deposit_wallet,

proxy

wallets

object

Legacy deployed-only wallet map. An address is null until its contract exists on Polygon.

Show child attributes

wallet_details

object[]

Current wallet plus other deployed wallets, with wallet type and status kept separate.

Show child attributes

​Understanding Polymarket wallet types

​Wallet type, deployment, and current wallet

​By wallet address (Safe)

​By wallet address (deposit wallet)

​By EOA address

​By wallet address (proxy wallet)

​By username

​Response fields

​Error responses

​Coverage

​Use cases

Authorizations

Path Parameters

Response

Understanding Polymarket wallet types

Wallet type, deployment, and current wallet

By wallet address (Safe)

By wallet address (deposit wallet)

By EOA address

By wallet address (proxy wallet)

By username

Response fields

Error responses

Coverage

Use cases