# Polymarket Historical Markets API

> Polymarket Historical Markets API is a paid API for AI agents from mechamanda.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Retrieves resolved/historical prediction markets from Polymarket, filterable by date range, slug, or category tag.

## Facts

- Endpoint: GET https://mechamanda.com/api/polymarket/historical?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-historical-markets-api-278c3d17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ob9kwzxVIaUJm-WnV33IR

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 polymarket-historical-markets-api-278c3d17
```

Example prompt: Can you pull up resolved Polymarket prediction markets about crypto that ended between January 1 and March 31, 2024? Show me the top 10 by volume.

## When to prefer this

Use this endpoint when you need historical or resolved Polymarket prediction markets — i.e. markets that have already concluded. It supports rich filtering by date range, specific event slug, or category tag, making it ideal for research, auditing past outcomes, or analyzing market accuracy. For live/trending markets, use the sibling trending endpoint instead.

## Known failure modes

- Invalid date format (non-ISO 8601) returns an error
- Unknown slug returns empty results or 404
- Invalid tag_slug category returns empty results
- Exceeding rate limits or missing payment returns 402
- Very large limit values may time out or return partial results

## How this service works

Get resolved/historical prediction markets from Polymarket. Filter by date range, slug, or category.

## Output

An array of resolved prediction market objects, each containing the market question, possible outcomes (e.g. Yes/No), outcome prices (0–1 scale), total trading volume, current liquidity, and a market description. Returns up to the requested limit of markets matching the filter criteria.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "slug": {
       "type": "string",
       "description": "Look up a specific event by slug"
      },
      "limit": {
       "type": "string",
       "description": "Max number of events to return (default 5)"
      },
      "offset": {
       "type": "string",
       "description": "Pagination offset (default 0)"
      },
      "tag_slug": {
       "type": "string",
       "description": "Filter by category tag (e.g. politics, sports, crypto)"
      },
      "endDateMax": {
       "type": "string",
       "description": "Filter events that ended on or before this date (ISO 8601)"
      },
      "endDateMin": {
       "type": "string",
       "description": "Filter events that ended on or after this date (ISO 8601)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "question",
       "outcomes",
       "outcomePrices",
       "volume"
      ],
      "properties": {
       "volume": {
        "type": "number",
        "description": "Total trading volume"
       },
       "outcomes": {
        "type": "array",
        "items": {
         "type": "string"
        },
        "description": "Possible outcomes (e.g. Yes/No)"
       },
       "question": {
        "type": "string",
        "description": "The market question"
       },
       "liquidity": {
        "type": "number",
        "description": "Current liquidity in the market"
       },
       "description": {
        "type": "string",
        "description": "Market description"
       },
       "outcomePrices": {
        "type": "array",
        "items": {
         "type": "string"
        },
        "description": "Current prices for each outcome (0-1)"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-historical-markets-api-278c3d17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mechamanda.com](https://www.zero.xyz/host/mechamanda.com/llms.txt)