Portfolios (batch)

Fetch the enriched live portfolio for many wallets in one call (max 20). Each address is resolved and reported inline; a failure on one address does not fail the batch.

GET /v3/perps/wallets/portfolios

Portfolios (batch)

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/perps/wallets/portfolios \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "input": "0x4f78...8731",
      "wallet_type": "eoa",
      "registered": true,
      "equity": "255137.89",
      "positions": [
        {
          "symbol": "SP500-USD",
          "side": "short",
          "size": "-133.9",
          "notional": "1004179.30"
        }
      ],
      "timestamp": 1783605489339
    }
  ]
}

Fetch the enriched live portfolio for a list of wallets in one request (up to 20) — positions, equity, explicit side, live mark and derived notional, exactly as the single-wallet portfolio endpoint returns them, one entry per address.

Pass a comma-separated addresses list. Each address is resolved automatically; a malformed or unresolvable address returns an error field inline rather than failing the whole batch. Because every entry is a live per-wallet fetch, this endpoint is capped tighter than the registration check.

curl "https://api.polynode.dev/v3/perps/wallets/portfolios?addresses=0xABC...,0xDEF...&key=$POLYNODE_API_KEY"

Authorizations

x-api-key · string · header · required

Query Parameters

addresses · string · required

Comma-separated Polymarket addresses (proxy wallet or signer). Resolution is automatic.

Response

200 - application/json

Success