# Polymarket Wallet Intelligence (agentstools.dev)

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

Returns a comprehensive Polymarket trader profile for an EVM address: open positions with PnL, portfolio value, recent trade activity, and derived analytics including conviction and concentration scores.

## Facts

- Endpoint: GET https://api.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-agentstools-dev-8b2e6e4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rVXYk87AoauNtYrtNH3tA

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-agentstools-dev-8b2e6e4f
```

Example prompt: Pull up the full Polymarket wallet profile for 0x1234abcd5678ef901234abcd5678ef901234abcd — I want to see their open positions, realized and unrealized PnL, portfolio value, and how concentrated their bets are.

## When to prefer this

Use this endpoint when you need a complete Polymarket-specific trader intelligence snapshot for a single EVM wallet — combining positions, PnL, activity, and derived analytics in one call. Prefer it over manual on-chain queries when you need pre-computed metrics like conviction and concentration without writing custom subgraph queries.

## Known failure modes

- Invalid or malformed EVM address returns a 400 or validation error
- Address with no Polymarket activity returns empty positions and zero portfolio value
- Polygon RPC or Polymarket data source unavailable causes 503 or timeout
- Non-0x-prefixed address string rejected at input validation
- Rate limiting or payment failure (x402) if USDC not provided

## 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: list of open positions (market title, chosen outcome, size, average entry price, current price, current value, realized PnL, unrealized PnL, redeemable amount), total portfolio value, recent trade activity, and derived analytics (size-weighted conviction score, concentration metric, realized-win proxy).

## 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-agentstools-dev-8b2e6e4f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)