# Predge On-Chain PM Flows — Polymarket Whale Activity

> Predge On-Chain PM Flows — Polymarket Whale Activity is a paid API for AI agents from api.predge.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns on-chain Polymarket whale trading flows for a rolling 24-hour window, including per-market volume, trade counts, and unique wallet activity on Polygon.

## Facts

- Endpoint: GET https://api.predge.io/v1/onchain/pm-flows
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-on-chain-pm-flows-polymarket-whale-activity-a3aee706
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AnsEsWOy9gUDmlKPd5kMi

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 predge-on-chain-pm-flows-polymarket-whale-activity-a3aee706
```

Example prompt: Pull the latest Polymarket whale on-chain flows from Predge for the last 24 hours — I want to see which prediction markets have the biggest whale volume, the YES vs NO split in USD, and how many unique wallets are trading each market.

## When to prefer this

Choose this endpoint when you need real-time, cryptographically attested on-chain Polymarket whale flow data aggregated by market — especially when you need YES/NO volume splits, wallet-level aggregation, and verifiable data provenance. Prefer this over general crypto flow APIs when your use case is specifically prediction market intelligence on Polymarket/Polygon.

## Known failure modes

- No matching whale activity in the window returns empty markets array
- Invalid properties filter returns 400 or empty result
- Payment failure (insufficient USDC balance) returns 402
- Polygon RPC downtime may cause stale or delayed data
- Signature verification failure indicates tampered response

## How this service works

Real-time alerts on whale traders on Polymarket. Heuristic Insider Watch, wallet scoring 0–100, Bloomberg-style web terminal. Free plan included.

## Output

A JSON payload containing: chain identifier (polygon), platform (polymarket), a 24-hour window start/end timestamps, total trade count, total volume in USD, unique wallet count across all markets, per-market breakdown with YES USD volume, NO USD volume, net USD, trade count, and unique wallets per market condition ID, plus human-readable market titles. The response includes a cryptographic ed25519 attestation signature over sorted canonical JSON, allowing verification of data integrity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "polygon",
  "scope": "polymarket-whale on-chain activity (prediction-market trades only, not general crypto flows)",
  "platform": "polymarket",
  "attestation": {
   "kind": "onchain-flows",
   "payload": {
    "kind": "onchain-flows",
    "chain": "polygon",
    "markets": [
     {
      "no_usd": "122000.00",
      "trades": 14,
      "net_usd": "168000.00",
      "yes_usd": "290000.00",
      "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39",
      "unique_wallets": 9
     }
    ],
    "platform": "polymarket",
    "issued_at": "2026-08-02T10:00:00.000Z",
    "window_end": "2026-08-02T09:45:00.000Z",
    "trades_count": 87,
    "window_hours": 24,
    "window_start": "2026-08-01T09:45:00.000Z",
    "unique_wallets": 41,
    "total_volume_usd": "2310000.00"
   },
   "algorithm": "ed25519",
   "canonical": "{…keys sorted, no whitespace…}",
   "signature": "3a1f…64-byte-hex…9c",
   "public_key": "d75a9807...c7e2a1"
  },
  "markets_meta": {
   "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39": {
    "title": "Will the Fed cut rates in September?"
   }
  },
  "window_hours": 24
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-on-chain-pm-flows-polymarket-whale-activity-a3aee706/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.predge.io](https://www.zero.xyz/host/api.predge.io/llms.txt)