---
title: "Batch up to 10 GETs"
method: POST
path: "/v3/batch"
tags: ["v3 - Utility"]
---

# Batch up to 10 GETs

`POST /v3/batch`

Execute up to 10 v3 GET sub-requests in parallel. Each sub-request consumes one rate-limit slot. Outer status is always 200; inspect each `data[].status` for individual outcomes.

## Request body

- V3BatchRequest
  - `requests` V3BatchSubRequest[], required
    - `id` string, required — Caller-defined id, echoed in the response
    - `path` string, required — Relative v3 GET path (e.g. /v3/btc/markets?type=5m&limit=10)

## Response `200`

Successful response

- V3BatchResponse
  - `data` V3BatchSubResponse[], required
    - `id` string, required
    - `status` integer, required
    - `body` object, required
  - `meta` V3Meta, required — Per-response metadata included on every v3 response.
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `400` — Validation error (invalid coin, cursor, parameter, timestamp, …)
- `401` — Authentication failure (missing or invalid API key)
- `402` — Plan upgrade required
- `403` — Endpoint or coin not in the caller's plan
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/polybacktest/apis/polybacktest-api.md) · [All operations](https://skmtc.dev/polybacktest/apis/polybacktest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polybacktest/polybacktest-api/revisions/262c9a5e60e4/schema)