# Polymarket Market Historical Cumulative Volume

> Polymarket Market Historical Cumulative Volume is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0085/call, status unknown (last checked 2026-09-15).

Returns historical cumulative trading volume data for a specific Polymarket prediction market token

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/markets/TOKEN_ID/volume
- Price: $0.0085/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-historical-cumulative-volume-73d8d36d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4OW0hxHrQfKDI-qlFxCpY

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-market-historical-cumulative-volume-73d8d36d
```

Example prompt: Can you pull the historical cumulative volume data for Polymarket token 0x1234abc so I can see how trading activity has grown over time on that market?

## When to prefer this

Use this endpoint when you need time-series or historical cumulative volume data for a specific Polymarket market token — particularly useful for liquidity analysis, trend detection, or comparing market activity over time. Prefer over wallet-level endpoints when the focus is on market-wide trading volume rather than individual user activity.

## Known failure modes

- Invalid or non-existent TOKEN_ID returns an empty or error response
- Rate limiting if called excessively
- Network timeout for markets with very large volume history
- Payment failure if USDC balance is insufficient for the $0.001 per-call fee

## How this service works

Get historical cumulative volume data for a market

## Output

Returns a data object containing historical cumulative volume figures for the specified Polymarket market token, showing how total traded volume has accumulated over time. Useful for assessing market liquidity and trading interest trends.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "query": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-market-historical-cumulative-volume-73d8d36d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)