# Polymarket Live Events Ranked by Volume

> Polymarket Live Events Ranked by Volume is a paid API for AI agents from hubvibe-io.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-30).

Returns live Polymarket prediction market events (groupings of related markets) ranked by trading volume.

## Facts

- Endpoint: POST https://hubvibe-io.com/work/prediction/events?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-live-events-ranked-by-volume-9d8817e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OTJbP_ZNpNfxR9_unXHoe

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-live-events-ranked-by-volume-9d8817e4 -d '<json body>'
```

Example prompt: Show me the top 15 live Polymarket events ranked by trading volume right now.

## When to prefer this

Use this endpoint when you need real-time, volume-ranked Polymarket event data without having to integrate directly with Polymarket's API. Ideal for dashboards, trading research, or any agent that needs to surface the most actively traded prediction market topics quickly. Prefer this over scraping Polymarket directly or using generic market data APIs when the specific need is event-level (grouped) prediction market volume rankings.

## Known failure modes

- limit out of range (must be 1–50) returns validation error
- Polymarket API unavailable or rate-limited causes upstream failure
- no live events currently available returns empty list
- payment not sent or insufficient USDC causes 402 rejection

## How this service works

Top prediction market events: Polymarket events (groups of related markets) ranked by trading volume, with title, slug, end date and market count. Use it to see what the biggest prediction markets are right now. Input: optional limit.

## Output

A ranked list of live Polymarket event objects (groupings of related markets), ordered by trading volume, including event metadata such as event name, slug, related markets, and volume figures. Number of results is controlled by the limit parameter (1–50, default 10).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
   "maxLength": 35
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "count": 1,
   "events": [
    {
     "id": "24011",
     "slug": "bitcoin-price-on-december-31",
     "title": "Bitcoin price on December 31",
     "volume": 5230100,
     "end_date": "2026-12-31T00:00:00Z",
     "market_count": 6
    }
   ],
   "source": "polymarket-gamma"
  },
  "status": "ok",
  "worker": "prediction.events",
  "price_usd": 0.05,
  "provenance": {
   "steps": [
    {
     "ms": 640,
     "ok": true,
     "step": "events",
     "provider": "polymarket-gamma"
    }
   ],
   "attempts": 1,
   "elapsed_ms": 660,
   "providers_used": [
    "polymarket-gamma"
   ]
  },
  "receipt_id": "rcpt_9f1c2b3a4d5e6f70",
  "receipt_url": "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-live-events-ranked-by-volume-9d8817e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hubvibe-io.com](https://www.zero.xyz/host/hubvibe-io.com/llms.txt)