# ChainHilt Polymarket Positions Lookup

> ChainHilt Polymarket Positions Lookup is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-16).

Fetches the current Polymarket prediction market positions held by a given Ethereum wallet address, including size, PnL, pricing, and redeemability.

## Facts

- Endpoint: GET https://chainhilt.ai/api/v1/predict/polymarket/positions/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-polymarket-positions-lookup-7372886f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9SCYwuLywf0HQIxPU64Vz

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 chainhilt-polymarket-positions-lookup-7372886f
```

Example prompt: What Polymarket positions is wallet 0xd9f530D88C105B1bf8cB5DfC68778C5987839D17 currently holding, and are any of them redeemable?

## When to prefer this

Use this endpoint when you need on-chain Polymarket position data for a specific Ethereum wallet without managing API keys, particularly in x402-compatible agent workflows. Prefer this over direct Polymarket API calls when you want pay-per-call pricing, no key management, and seamless integration with other ChainHilt on-chain actions in the same pipeline.

## Known failure modes

- Invalid Ethereum address format (must match ^0x[a-fA-F0-9]{40}$) returns a 400 error
- Address with no Polymarket positions returns an empty positions array
- Payment not completed (x402 flow not satisfied) results in a 402 Payment Required response
- Network or upstream Polymarket data unavailability may cause 503 or timeout
- Incorrect redeemable query param value (not 'true' or 'false') may be rejected or ignored

## How this service works

Discover, pay for, and execute the on-chain actions your agent needs. No API keys. Compatible with x402. Your wallet stays local.

## Output

Returns a list of Polymarket positions for the given wallet, each including the market title, venue, outcome held, token ID, condition ID, position size, average entry price, current price, cash PnL, realized PnL, redeemability status, and a negRisk flag. Also returns a truncated flag and an observedAt timestamp indicating data freshness.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "The holding wallet: for deposit-wallet accounts the deposit wallet, not the signer."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "redeemable": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string",
       "description": "\"true\" keeps positions in resolved markets (losing outcomes included), \"false\" the rest; omit for all."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "positions": [
   {
    "size": "25",
    "title": "Will the Fed cut rates at its December meeting?",
    "venue": "polymarket",
    "account": "0xd9f530D88C105B1bf8cB5DfC68778C5987839D17",
    "cashPnl": "0.5",
    "negRisk": false,
    "outcome": "Yes",
    "tokenId": "111",
    "avgPrice": "0.41",
    "redeemable": false,
    "conditionId": "0x9f1c1c4c1d6a2b2f0d5a7e8b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f",
    "realizedPnl": "0",
    "currentPrice": "0.43"
   }
  ],
  "truncated": false,
  "observedAt": "2026-10-30T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainhilt-polymarket-positions-lookup-7372886f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
