# BlockRun.AI Polymarket Wallet Positions

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

Returns current and historical position data for a specific Polymarket wallet, including market metadata, shares, cost basis, current value, PnL, and pagination.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/wallet/positions/0x9174e9bFF176285E9B77022eC2e4007904495280
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-560db4d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KeUMi3cgCQTmu7ZK3F5Uo

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-560db4d2
```

Example prompt: What are the current Polymarket positions, cost basis, and PnL for wallet 0x9174e9bFF176285E9B77022eC2e4007904495280?

## When to prefer this

Use this endpoint when you need detailed portfolio-level analysis of a specific Polymarket wallet, including cost basis tracking, PnL breakdown, and market-level position metadata. Prefer this over generic blockchain explorers when you specifically need Polymarket prediction market context, enriched with market titles and financial summaries rather than raw on-chain transaction data.

## Known failure modes

- Invalid or malformed wallet address returns 400 or empty result
- Wallet with no Polymarket activity returns empty positions array
- Rate limiting or payment failure returns 402 Payment Required
- Downstream Polymarket data unavailability causes 503 or stale data
- Very large position history may require multiple paginated requests

## How this service works

Returns a Polymarket wallet's current and historical position data, including market metadata, shares, cost basis, current value, PnL, summary totals, and pagination for additional positions.

## Output

A structured JSON object containing the wallet's open and historical Polymarket positions, each with market metadata (title, category, etc.), number of shares held, cost basis, current market value, realized and unrealized PnL, summary totals across all positions, and pagination info for fetching additional positions.

## 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": [
  "_truncated",
  "_originalSize"
 ],
 "properties": {
  "_truncated": {
   "type": "boolean"
  },
  "_originalSize": {
   "type": "number"
  }
 }
}
```

## More

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