# BlockRun.AI Polymarket Wallet Activity Insights

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

Fetches wallet data and activity insights for a specific Polymarket address, including positions, trading history, and behavioral analytics.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/wallet/0x4ffe49ba2a4cae123536a8af4fda48faeb609f71
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-221613c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dASq4QYVX0Gl5fLT7KS4_

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-221613c7
```

Example prompt: Pull up the Polymarket wallet activity and trading insights for address 0x4ffe49ba2a4cae123536a8af4fda48faeb609f71 — I want to see what markets they've been active in and their overall position data.

## When to prefer this

Use this endpoint when you need detailed wallet-level activity and insights for a specific Polymarket address, including trading history, positions, and behavioral analytics. Prefer this over generic blockchain explorers when you specifically need Polymarket prediction market context and enriched trading insights rather than raw transaction data.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Address not found on Polymarket returns empty or null data
- Network or upstream blockchain data unavailability causes timeout
- Rate limiting or payment failure ($0.005 USDC x402) causes 402 response
- Address with no Polymarket activity returns empty dataset

## How this service works

Fetches wallet data and activity insights for a Polymarket address.

## Output

Returns wallet data and activity insights for the given Polymarket address, including current and historical positions, market participation details, trading behavior metrics, and other on-chain analytics specific to that wallet's Polymarket activity.

## Example request

```json
{
 "input": {
  "body": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "user",
  "metrics",
  "total_pnl",
  "entry_edge",
  "computed_at",
  "last_trade_at",
  "first_trade_at",
  "trading_styles",
  "unrealized_pnl"
 ],
 "properties": {
  "user": {
   "type": "string"
  },
  "metrics": {
   "type": "object",
   "required": [
    "one_day",
    "all_time",
    "seven_day",
    "thirty_day"
   ],
   "properties": {
    "one_day": {
     "type": "object",
     "required": [
      "roi",
      "wins",
      "losses",
      "trades",
      "volume",
      "win_rate",
      "fees_paid",
      "total_pnl",
      "realized_pnl",
      "avg_buy_price",
      "fees_refunded",
      "profit_factor",
      "avg_sell_price",
      "positions_closed"
     ],
     "properties": {
      "roi": {
       "type": "number"
      },
      "wins": {
       "type": "number"
      },
      "losses": {
       "type": "number"
      },
      "trades": {
       "type": "number"
      },
      "volume": {
       "type": "number"
      },
      "win_rate": {
       "type": "number"
      },
      "fees_paid": {
       "type": "number"
      },
      "total_pnl": {
       "type": "number"
      },
      "realized_pnl": {
       "type": "number"
      },
      "avg_buy_price": {
       "type": "null"
      },
      "fees_refunded": {
       "type": "number"
      },
      "profit_factor": {
       "type": "number"
      },
      "avg_sell_price": {
       "type": "null"
      },
      "positions_closed": {
       "type": "number"
      }
     }
    },
    "all_time": {
     "type": "object",
     "required": [
      "roi",
      "wins",
      "losses",
      "trades",
      "volume",
      "win_rate",
      "fees_paid",
      "total_pnl",
      "realized_pnl",
      "avg_buy_price",
      "fees_refunded",
      "profit_factor",
      "avg_sell_price",
      "max_win_streak",
      "max_loss_streak",
      "total_positions",
      "wallet_age_days",
      "active_positions",
      "positions_closed",
      "avg_hold_time_seconds",
      "best_position_realized_pnl",
      "worst_position_realized_pnl"
     ],
     "properties": {
      "roi": {
       "type": "number"
      },
      "wins": {
       "type": "number"
      },
      "losses": {
       "type": "number"
      },
      "trades": {
       "type": "number"
      },
      "volume": {
       "type": "number"
      },
      "win_rate": {
       "type": "number"
      },
      "fees_paid": {
       "type": "number"
      },
      "total_pnl": {
       "type": "n
… (truncated)
```

## More

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