{"uid":"cap_9SCYwuLywf0HQIxPU64Vz","slug":"chainhilt-polymarket-positions-lookup-7372886f","name":"ChainHilt Polymarket Positions Lookup","description":"Discover, pay for, and execute the on-chain actions your agent needs. No API keys. Compatible with x402. Your wallet stays local.","url":"https://chainhilt.ai/api/v1/predict/polymarket/positions/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FUEMvdS9lDDauHqOlMuoz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current Polymarket prediction market positions held by a given Ethereum wallet address, including size, PnL, pricing, and redeemability.","exampleAgentPrompt":"What Polymarket positions is wallet 0xd9f530D88C105B1bf8cB5DfC68778C5987839D17 currently holding, and are any of them redeemable?","exampleUseCases":[{"title":"Polymarket portfolio PnL review","prompt":"Pull up all the Polymarket positions for my wallet 0xd9f530D88C105B1bf8cB5DfC68778C5987839D17 and tell me the cash PnL and current price vs average price on each one."},{"title":"Find redeemable prediction market winnings","prompt":"Check wallet 0xd9f530D88C105B1bf8cB5DfC68778C5987839D17 on Polymarket and show me only the positions that are redeemable so I can claim my winnings."},{"title":"Monitor specific wallet's market bets","prompt":"Look up what prediction market bets wallet 0xAbc123...def456 has open on Polymarket right now, including which outcome they're holding and at what average price they entered."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:39:43.936Z","isFirstParty":false,"canonicalSlug":"chainhilt-polymarket-positions-lookup-2567de08"}