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

# Backtest Copy PnL — Batch

> Score multiple wallets in one call. Same math as the single-wallet endpoint.

```http theme={null}
POST https://api.polynode.dev/v2/copy-pnl/batch
```

Use this when you need to score many wallets at once — for example, ranking a candidate-leader list. The endpoint returns one result per wallet, processed in parallel so 50 wallets don't take 50× single-wallet time.

## Request body

| Field            | Type               | Required | Description                                                                                                       |
| ---------------- | ------------------ | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `addresses`      | `string[]`         | yes      | Array of wallet addresses (Safe proxy or EOA). 1 to 100 entries per call.                                         |
| `from`           | `string \| number` | no       | Window start. `YYYY-MM-DD` (UTC midnight) or unix seconds. Defaults to last 30 days when omitted.                 |
| `to`             | `string \| number` | no       | Window end. Same format as `from`. Defaults to current time.                                                      |
| `include_trades` | `boolean`          | no       | When `true`, every result includes the per-fill `trades` array. Off by default — payloads can grow large quickly. |

The `from`/`to` window applies to **every** wallet in the batch — pass per-wallet windows by making separate calls.

`?period=` preset is **not supported** in the batch body. Use explicit `from`/`to`.

## Response

```
{
  count: int,
  elapsed_ms: int,
  results: [ /* one entry per address — same shape as the single-wallet endpoint */ ]
}
```

Per-result fields are identical to the [single-wallet response](/api-reference/backtesting/copy-pnl#response-fields).

## Example: 3 wallets over a 10-day window

Request:

```bash theme={null}
curl -H "x-api-key: $YOUR_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "addresses": [
      "0x0c73d8abc3cd918bc62d0204e33ee05c3f5a68e7",
      "0xba4ac793e68eacb93b41566137f25757656a9fa6",
      "0x4b2995b6c8cc2cf56899ad62ee87c3f70c97716f"
    ],
    "from": "2026-04-15",
    "to":   "2026-04-25"
  }' \
  "https://api.polynode.dev/v2/copy-pnl/batch"
```

Response (`200 OK`, abridged):

```json theme={null}
{
  "count": 3,
  "elapsed_ms": 1948,
  "results": [
    {
      "wallet": "0x0c73d8abc3cd918bc62d0204e33ee05c3f5a68e7",
      "actual_pnl_usdc": -7323.06,
      "backtest_copy_pnl_usdc": -9664.1,
      "slippage_amount_usdc": 2341.04,
      "slippage_cost_rate_pct": 31.97,
      "toxic_for_copying": true,
      "trade_count": 1637,
      "pnl_definition": "cashflow",
      "applied_filters": {
        "from": 1776211200,
        "to": 1777075200,
        "window_days": null
      },
      "partial": false,
      "sources": { "...": "..." }
    },
    {
      "wallet": "0xba4ac793e68eacb93b41566137f25757656a9fa6",
      "actual_pnl_usdc": 0,
      "backtest_copy_pnl_usdc": 0,
      "slippage_amount_usdc": 0,
      "slippage_cost_rate_pct": null,
      "toxic_for_copying": false,
      "trade_count": 0,
      "pnl_definition": "cashflow",
      "applied_filters": { "from": 1776211200, "to": 1777075200, "window_days": null },
      "partial": false,
      "sources": { "...": "..." }
    },
    {
      "wallet": "0x4b2995b6c8cc2cf56899ad62ee87c3f70c97716f",
      "actual_pnl_usdc": -2637.15,
      "backtest_copy_pnl_usdc": -2690.17,
      "slippage_amount_usdc": 53.02,
      "slippage_cost_rate_pct": 2.01,
      "toxic_for_copying": false,
      "trade_count": 12,
      "pnl_definition": "cashflow",
      "applied_filters": { "from": 1776211200, "to": 1777075200, "window_days": null },
      "partial": false,
      "sources": { "...": "..." }
    }
  ]
}
```

Note the second wallet — no on-chain trading activity in the window — returns the standard zero-shape with `slippage_cost_rate_pct: null` (denominator unstable per the spec edge case). Wallets that error individually return `{"wallet": "...", "error": "..."}` instead of the full shape, so a single bad wallet won't fail the whole batch.

## Errors

`400 Body must include "addresses": [...]`:

```json theme={null}
{ "error": "Body must include \"addresses\": [...]." }
```

`400 Invalid wallet`:

```json theme={null}
{ "error": "Invalid wallet: not-a-wallet" }
```

`400 Too many addresses`:

```json theme={null}
{ "error": "Max 100 addresses per batch." }
```

Auth errors (`401`, `403`) and rate-limit errors (`429`) are identical to the single-wallet endpoint — see [Backtest Copy PnL](/api-reference/backtesting/copy-pnl#errors).

## Limits and behavior

* **Max 100 addresses per call**.
* **Typical batch latency** — a 100-wallet batch with average \~1.5s per wallet completes in roughly 20s.
* **45-second total timeout**. Heavy batches (many high-volume wallets) may exceed — split the address list across multiple calls if so.
* **Same rate limit** as the single endpoint: 1 request per 5 seconds per API key. The batch counts as one request regardless of how many wallets are inside.
* **Per-wallet errors don't fail the batch.** A wallet that errors during processing returns `{"wallet": "...", "error": "..."}` in its slot. Other wallets still return their full result.
* **Same `partial: true` behavior per wallet** as the single endpoint — extreme high-frequency wallets may flag partial inside their result.