# Polymarket Spreads (Batch)

> Polymarket Spreads (Batch) 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-18).

Retrieves bid-ask spreads for multiple Polymarket prediction market token IDs in a single request.

## Facts

- Endpoint: POST https://api.aisa.one/apis/v1/polymarket/spreads?utm_source=zero.xyz
- Price: $0.012/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- 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-spreads-batch-2a219c5c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jhoUTVIfzI1Ra59n1uHy6

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-spreads-batch-2a219c5c -d '<json body>'
```

Example prompt: Can you pull the current bid-ask spreads for these Polymarket token IDs: 0xabc123def456 and 0xdef789ghi012? I want to see how liquid these markets are.

## When to prefer this

Use this endpoint when you need spread data for multiple Polymarket token IDs in one call rather than making individual price requests. It is ideal for batch liquidity analysis, portfolio monitoring, or pre-trade checks across many markets simultaneously. Prefer this over the single-token price endpoint when you have two or more tokens to evaluate.

## Known failure modes

- Invalid or non-existent token IDs return missing keys or empty results
- Malformed input array (missing required token_id field) causes a 400 validation error
- Network or server errors may return 5xx responses
- Empty input array returns an empty object
- Stale or illiquid markets may return zero or very large spreads

## How this service works

Retrieves spreads for multiple token IDs. The spread is the difference between the best ask and best bid prices.

<!-- 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 mapping each token ID (string key) to its corresponding spread value (string), representing the difference between the best ask and best bid prices for that prediction market token.

## Request schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object",
  "required": [
   "token_id"
  ],
  "properties": {
   "side": {
    "enum": [
     "BUY",
     "SELL"
    ],
    "type": "string",
    "example": "BUY",
    "description": "Order side (optional, not used for midpoint calculation)"
   },
   "token_id": {
    "type": "string",
    "example": "0xabc123def456...",
    "description": "Token ID (asset ID)"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "description": "Map of token ID to spread",
 "additionalProperties": {
  "type": "string"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-spreads-batch-2a219c5c/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)