# BlockRun.AI Polymarket User Positions

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

Fetch all Polymarket positions for a user with filtering and pagination support

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/positions
- Price: $0.001/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-4f939a1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_twLbcvTkzLTypEDvZFHlI

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-4f939a1a
```

Example prompt: Can you pull up all of my current Polymarket positions for wallet 0xAbC123... and show me what markets I'm in right now?

## When to prefer this

Use this endpoint when you need to enumerate all positions held by a specific Polymarket user, especially when you need pagination support for wallets with many positions. Prefer this over the wallet analytics endpoint when you want raw position data rather than aggregated performance metrics.

## Known failure modes

- Invalid or missing wallet address returns empty or error response
- Pagination parameters out of range return empty data set
- Rate limiting or payment failure returns 402 or 429 status
- Wallet with no positions returns empty data array
- Network or upstream Polymarket API unavailability causes 503

## How this service works

Fetch all user positions with filtering and pagination

## Output

Returns a paginated list of user positions on Polymarket, including market metadata, share quantities, current values, and position details for each open or historical market the wallet has participated in.

## Example request

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

## 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-4f939a1a/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)