# Polymarket Wallet Flow by Condition

> Polymarket Wallet Flow by Condition is a paid API for AI agents from x402.sashco.ca, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-12).

Returns per-market trade volume and count broken down by wallet persona and side (YES/NO) for a given Polymarket condition ID, with approximately 24-hour delay.

## Facts

- Endpoint: GET https://x402.sashco.ca/markets/%7Bcondition_id%7D/wallet-flow
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-wallet-flow-by-condition-6cc92a51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LNpRIiBZ9l-s74eZ3VtQ5

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-wallet-flow-by-condition-6cc92a51
```

Example prompt: Show me how smart money wallets and different trader personas are split on Polymarket condition 0x1234abcd — I want to see volume by side and wallet type as of the last 24 hours.

## When to prefer this

Choose this endpoint when you need to understand how different categories of Polymarket wallets (smart money, insiders, retail) are positioned on a specific market condition, segmented by trade side. It is ideal for building trading dashboards, signal filters, or research tools that want persona-level breakdown rather than aggregate market data. Prefer this over raw on-chain queries when you want pre-computed persona segmentation and do not need real-time (sub-hour) data.

## Known failure modes

- Invalid or unknown condition_id returns an error or empty result
- Data may be stale by up to 24 hours, so real-time signals are not available
- Payment failure via x402/USDC results in 402 response with no data
- Low-liquidity markets may have sparse or zero flow data for some personas
- Rate limiting or payment issues may result in 429 or 402 errors

## How this service works

Wallet reputation and trading-signal detection for Polymarket prediction markets -- combining smart-money wallet tracking, insider-pattern detection, and a custom ML edge model. Wallet reputation scores, per-market wallet flow by persona, a free signal-accuracy track record, and push notifications when a high-confidence signal fires. Pay-per-call via x402 (USDC on Base). Machine-readable pricing: GET /.well-known/x402.

## Output

A JSON object containing per-market trade volume and trade count segmented by wallet persona (e.g. smart money, insider, retail) and side (YES/NO), reflecting approximately the last 24 hours of on-chain activity on Polymarket.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 },
 "description": "Per-market trade volume by persona and side, ~24h delayed."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-wallet-flow-by-condition-6cc92a51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.sashco.ca](https://www.zero.xyz/host/x402.sashco.ca/llms.txt)