# BlockRun.AI Polymarket Trades History

> BlockRun.AI Polymarket Trades History is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0075/call, status unknown (last checked 2026-09-15).

Retrieves historical trade data from Polymarket prediction markets

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/prediction-market/polymarket/trades
- Price: $0.0075/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-6cb926f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Op5rLzBOs9HR1d3UqM26z

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 blockrun-ai-6cb926f5
```

Example prompt: Pull the recent trades history from Polymarket so I can see what transactions have been executed across prediction markets.

## When to prefer this

Use this endpoint when you need historical trade execution data from Polymarket specifically, such as auditing trading activity, analyzing market liquidity, or tracking wallet behavior on prediction markets. Prefer this over general DeFi data endpoints when the focus is specifically on Polymarket trade records rather than positions or market listings.

## Known failure modes

- No trades found for the given parameters — empty data array returned
- Invalid or missing market/wallet filter — may return all trades or an error
- Rate limiting or payment failure — 402 payment required if USDC not attached
- Polymarket API upstream unavailability — 503 or timeout
- Malformed query parameters — 400 bad request

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

Returns a list of historical trade records from Polymarket, including trade details such as market context, amounts, timestamps, wallet addresses, and transaction metadata.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-6cb926f5/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)