> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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](/perps/wallets/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.

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


## OpenAPI

````yaml GET /v3/perps/wallets/portfolios
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/perps/wallets/portfolios:
    get:
      tags:
        - Perps
      summary: Portfolios (batch)
      description: >-
        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.
      parameters:
        - name: addresses
          in: query
          required: true
          description: >-
            Comma-separated Polymarket addresses (proxy wallet or signer).
            Resolution is automatic.
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                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
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````