# BlockRun.AI Polymarket Wallet Filter

> BlockRun.AI Polymarket Wallet Filter is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Filter Polymarket wallets by market trading activity using combinable AND/OR logic conditions

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/wallets/filter
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-e6795e31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__9KVs26f63wTn2xFJMz9c

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-e6795e31
```

Example prompt: Show me all Polymarket wallets that traded on both the US election market AND the crypto price market — use AND logic to filter only wallets that participated in all of those markets.

## When to prefer this

Use this endpoint when you need to segment or identify Polymarket wallets based on their trading history across specific markets, especially when combining multiple conditions with boolean AND/OR logic. Prefer this over raw wallet lookups when building trader cohorts, doing competitive analysis, or finding wallets that share specific market participation patterns.

## Known failure modes

- Invalid or malformed filter logic returns 400 error
- No wallets match the given criteria — empty result set returned
- Unknown market IDs in filter conditions cause query failure
- Payment not received or insufficient USDC triggers 402 response
- Rate limiting on high-volume filter queries

## How this service works

Filter wallets by market trades with AND/OR logic

## Output

A filtered list of Polymarket wallet addresses that match the specified trade-based filter conditions, potentially including wallet metadata and trade context for each matching wallet.

## 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/blockrun-ai-e6795e31/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)