# Polymarket Batch Prices History

> Polymarket Batch Prices History is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.012/call, status unknown (last checked 2026-10-14).

Retrieves historical price time-series data for up to 20 Polymarket prediction market assets in a single request.

## Facts

- Endpoint: POST https://api.aisa.one/apis/v1/polymarket/batch-prices-history?utm_source=zero.xyz
- Price: $0.012/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-batch-prices-history-4975fa9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y0ZiNCp4FhN1S0pG8NInI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-polymarket-batch-prices-history-4975fa9e -d '<json body>'
```

Example prompt: Can you pull the hourly price history for the last week for these three Polymarket market assets — 0xabc123, 0xdef456, and 0x789ghi — so I can see how their prices moved over time?

## When to prefer this

Use this endpoint when you need historical price data for multiple Polymarket prediction market assets in one call rather than making separate per-market requests. It is ideal for batch analysis, backtesting, or cross-market comparison workflows where efficiency matters. Choose this over single-market endpoints when processing 2–20 markets simultaneously.

## Known failure modes

- More than 20 market IDs provided — request rejected with validation error
- Invalid market asset ID format — returns empty or missing data for that key
- start_ts greater than end_ts — may return empty arrays or error
- Invalid interval enum value — returns 400 bad request
- Market ID not found on Polymarket — returns empty array for that market
- Network or upstream Polymarket data unavailability — may return partial results or 503

## How this service works

Retrieve historical price data for multiple markets in a single request.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

A JSON object with a 'history' map where each key is a market asset ID and the value is an array of price data points, each containing a price ('p' as float) and a unix timestamp ('t' as uint32).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "markets"
 ],
 "properties": {
  "end_ts": {
   "type": "number",
   "format": "double",
   "description": "Filter by items before this unix timestamp (seconds)."
  },
  "markets": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20,
   "description": "List of market asset ids to query. Maximum 20."
  },
  "fidelity": {
   "type": "integer",
   "description": "Accuracy of the data expressed in minutes. Default is 1 minute."
  },
  "interval": {
   "enum": [
    "max",
    "all",
    "1m",
    "1w",
    "1d",
    "6h",
    "1h"
   ],
   "type": "string",
   "description": "Time interval for data aggregation."
  },
  "start_ts": {
   "type": "number",
   "format": "double",
   "description": "Filter by items after this unix timestamp (seconds)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "history": {
   "type": "object",
   "description": "Map of market asset id to array of price data points.",
   "additionalProperties": {
    "type": "array",
    "items": {
     "type": "object",
     "properties": {
      "p": {
       "type": "number",
       "format": "float"
      },
      "t": {
       "type": "integer",
       "format": "uint32"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-batch-prices-history-4975fa9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)