# Prediction Market Volume & Trade-Count by Exchange (Time-Bucketed)

> Prediction Market Volume & Trade-Count by Exchange (Time-Bucketed) is a paid API for AI agents from api.predictionmarketdata.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns time-bucketed prediction market volume and trade-count aggregated by exchange for a specified time range and interval.

## Facts

- Endpoint: GET https://api.predictionmarketdata.io/market-overview
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prediction-market-volume-trade-count-by-exchange-time-bucketed-2ef12b3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dHMqaZAU0Q7eKH4UIkUY6

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 prediction-market-volume-trade-count-by-exchange-time-bucketed-2ef12b3e
```

Example prompt: Show me prediction market trading volume and trade counts by exchange for the past 24 hours, broken into 1-hour buckets — so from 2024-06-10T00:00:00Z to 2024-06-11T00:00:00Z with an interval of 3600000 milliseconds.

## When to prefer this

Use this endpoint when you need quantitative time-series data (volume and trade counts) for prediction markets aggregated across or broken down by exchange, especially for charting, trend analysis, or comparing activity levels over specific intervals. Prefer this over the narrative recap endpoint when you need raw numeric data rather than a human-readable summary, and over the market search endpoint when you need aggregate activity metrics rather than individual market listings.

## Known failure modes

- Missing required query parameters (from, to, interval) returns a 400 error
- Invalid ISO-8601 timestamp format causes a parse error
- Interval value of 0 or negative may return an error or empty buckets
- Time range too large combined with a very small interval may return too many buckets or a timeout
- Payment not provided or invalid results in a 402 Payment Required response
- Future time ranges may return empty data

## How this service works

Time-bucketed prediction market volume and trade-count by exchange.

## Output

A time-series dataset with prediction market volume and trade counts bucketed by the specified interval, broken down by exchange, covering the requested time window.

## 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",
     "required": [
      "from",
      "to",
      "interval"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "UTC end timestamp in ISO-8601 format."
      },
      "from": {
       "type": "string",
       "description": "UTC start timestamp in ISO-8601 format."
      },
      "interval": {
       "type": "string",
       "description": "Bucket size in milliseconds (e.g. 300000 = 5m, 3600000 = 1h)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "time": "2026-06-07T00:00:00Z",
    "volume": "4299.0",
    "sourceId": 4008,
    "volumeUsd": "1700.9",
    "entityCode": "GMNI",
    "entityName": "Gemini",
    "tradeCount": 37,
    "instrumentType": "PREDICTION_MARKET"
   }
  ],
  "count": 144,
  "dataType": "prediction-volume-by-exchange"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prediction-market-volume-trade-count-by-exchange-time-bucketed-2ef12b3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.predictionmarketdata.io](https://www.zero.xyz/host/api.predictionmarketdata.io/llms.txt)