# Polymarket Wallet Intelligence

> Polymarket Wallet Intelligence is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns open positions, portfolio value, recent trades, PnL, and derived conviction/concentration metrics for a given EVM wallet on Polymarket prediction markets.

## Facts

- Endpoint: GET https://payai.agentstools.dev/trader/polymarket
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-wallet-intelligence-1cb3e88c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xuLUWYh5RJkVKPKHYFldK

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-intelligence-1cb3e88c
```

Example prompt: Pull up the full Polymarket wallet brief for 0x1234abcd5678ef901234abcd5678ef901234abcd — I want to see open positions, PnL, recent trades, and how concentrated or convicted they are.

## When to prefer this

Use this endpoint when you need a comprehensive, pre-aggregated Polymarket intelligence brief for a specific wallet — including PnL, conviction, and concentration metrics — in a single call, rather than querying raw on-chain data or the Polymarket API directly and computing derived stats yourself.

## Known failure modes

- Invalid or malformed EVM address returns an error or empty result
- Address has no Polymarket activity — returns empty positions and zero portfolio value
- Polygon RPC or Polymarket subgraph outage causes timeout or partial data
- Address is valid but has only historical closed positions with nothing open — minimal output
- Rate limits or payment failures (x402) if USDC balance insufficient

## How this service works

Polymarket wallet intelligence for an EVM address: open positions (title, outcome, size, avg vs current price, current value, realized + unrealized PnL, redeemable), portfolio value, recent trade activity, and derived totals plus size-weighted conviction, concentration and a realized-win proxy — positions, value and activity fused into one brief. On-chain USDC markets on Polygon. public on-chain data, not financial advice.

## Output

A structured brief containing: all open positions (market title, chosen outcome, size, average entry price, current price, current value, realized PnL, unrealized PnL, redeemable flag), total portfolio value, recent trade activity log, and derived analytics (size-weighted conviction score, portfolio concentration, realized-win proxy ratio).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "A 0x-prefixed 40-hex EVM address (the wallet to profile). Hosts are fixed server-side; you pass only this address."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-wallet-intelligence-1cb3e88c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)