# Arkham x402 – Polymarket Positions

> Arkham x402 – Polymarket Positions is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.6/call, status unknown (last checked 2026-09-15).

Returns a wallet's open Polymarket prediction-market positions including net flow, unrealized P&L, last price, and trade count, charged per-request via x402 micropayment.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/positions
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-positions-c1b89db3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Mb2cEeL_Cqkrm3tS33N7

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 arkham-x402-polymarket-positions-c1b89db3 -d '<json body>'
```

Example prompt: Pull up all current Polymarket positions for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see which markets they're in, their net position sizes, and unrealized P&L on each.

## When to prefer this

Use this endpoint when you specifically need on-chain Polymarket position data attributed to a known wallet address, including financial metrics like unrealized P&L and net USDC flow. Prefer this over generic Polymarket APIs when you need Arkham's wallet intelligence layer (address labeling, entity attribution) combined with position data, and when pay-per-request x402 billing is acceptable over a subscription model.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty positions array
- Wallet has no Polymarket activity — returns positions array with zero items and totalCount 0
- Insufficient x402 payment (under $0.60 USDC) causes request to be rejected with a 402 Payment Required response
- Rate limiting or network errors on the Arkham API side may return 5xx errors
- Querying a non-Ethereum or unsupported address format may produce an error response

## How this service works

Get Arkham Polymarket positions for a wallet. $0.60 per call.

## Output

Returns a JSON object containing an array of position objects — each with the event ID, outcome label, market question, image URL, last traded price, net USDC flow, net position size, total trade count, condition ID, token address, and unrealized P&L — plus a total count and the queried wallet address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addr": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Required. Polymarket trade address (0x + 40 hex chars)."
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max results (default 50, max 1000)."
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Offset for pagination (default 0)."
  },
  "sortBy": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Column to order by: trades (default), shares, value, pnl."
  },
  "sortOrder": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Sort direction: asc or desc (default)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "positions": [
   {
    "eventId": 544680,
    "outcome": "Boston Red Sox",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/MLB.jpg",
    "question": "Boston Red Sox vs. New York Yankees",
    "lastPrice": 0.495,
    "conditionId": "0x0bbc63372aaf0867db23fc361b4e37f7d3125c7acef6cc8e2d5ce40f65b7e523",
    "netFlowUsdc": "-34690.684786",
    "netPosition": "72272.25996",
    "totalTrades": 31,
    "tokenAddress": "0x535fa6646d139e4b4400ccece2b6d34c1a7d925602f58a5add648030c6f3378f",
    "unrealizedPnl": "1084.0838942"
   },
   {
    "eventId": 544680,
    "outcome": "Under",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/MLB.jpg",
    "question": "Boston Red Sox vs. New York Yankees: O/U 8.5",
    "lastPrice": 0.54,
    "conditionId": "0x717c526bb6a5946f75423352cdbd0d92ab87651710a7740997126d58b3a7925d",
    "netFlowUsdc": "-40596.758127",
    "netPosition": "79601.486519",
    "totalTrades": 16,
    "tokenAddress": "0x15e06d413ac75c0e88e7c0292cfdbf8b767273081f43cb146143dbc5a68ea6dc",
    "unrealizedPnl": "2388.04459326",
    "groupItemTitle": "O/U 8.5"
   }
  ],
  "totalCount": 5,
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-positions-c1b89db3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)