{"uid":"cap_-Y-LjswdnFzCRiu154u1p","slug":"chainhilt-polymarket-account-activity-history-253a61d7","name":"ChainHilt Polymarket Account Activity History","description":"Trade and settlement history of a venue account, newest first and cursor-paged: fills (TRADE, with the pUSD that actually moved, fees included), REDEEM, SPLIT/MERGE, CONVERSION and rewards, each with its Polygon transaction hash. Deposits and withdrawals appear only when `type` names them. To page, pass `nextCursor` as `cursor` with the same filters. The ground truth after an ambiguous submit. Errors: 400 invalid filter, 422 cursor or filters refused by the venue, 502 venue failure.","url":"https://chainhilt.ai/api/v1/predict/polymarket/activity/:address?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":{"end":{"type":"string","description":"ISO 8601: only activity at or before this time."},"side":{"enum":["buy","sell"],"type":"string","description":"Only trades on this side."},"type":{"type":"string","description":"Comma-separated activity kinds (TRADE, REDEEM, SPLIT, MERGE, CONVERSION, REWARD, DEPOSIT, WITHDRAWAL, MAKER_REBATE, TAKER_REBATE, REFERRAL_REWARD, YIELD, MIGRATION, TIP); DEPOSIT and WITHDRAWAL appear only when named."},"limit":{"type":"integer","default":100,"maximum":1000,"minimum":1,"description":"Rows per page (1-1000, default 100)."},"start":{"type":"string","description":"ISO 8601: only activity at or after this time."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `nextCursor`; send it with the same filters."},"conditionId":{"type":"string","description":"Comma-separated bytes32 condition ids (up to 20) to keep only those markets."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_eXQLtFJiJgt0QjEURSVvT","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":"Returns cursor-paged trade and settlement history for a Polymarket venue account, including fills, redemptions, splits, merges, conversions, and rewards with Polygon transaction hashes.","exampleAgentPrompt":"Can you pull the last 50 trades and redemptions for Polymarket wallet 0xAbCd1234... between January 1 and March 31, and include their Polygon transaction hashes?","exampleUseCases":[{"title":"Audit fills after ambiguous order submission","prompt":"I just submitted an order on Polymarket and I'm not sure if it went through — can you check the TRADE activity for wallet 0x1234...abcd in the last hour and show me the fills with their transaction hashes?"},{"title":"Retrieve redemptions for a resolved market","prompt":"Pull all REDEEM events for wallet 0xDeAd...BeeF filtered to condition ID 0xabc123... so I can confirm my resolved Polymarket positions were settled correctly."},{"title":"Page through full trading history for tax reporting","prompt":"Get me all TRADE, CONVERSION, and REWARD activity for Polymarket wallet 0x9999...1111 for the full year 2024, starting from the beginning — I'll need to page through everything with the cursor."}],"resultDescription":"A paginated list of account activity records (newest first), each containing the activity type (TRADE, REDEEM, SPLIT, MERGE, CONVERSION, REWARD, DEPOSIT, WITHDRAWAL, etc.), pUSD amounts that actually moved, fees, timestamps, and the associated Polygon transaction hash. A `nextCursor` field is included when more pages are available.","failureModes":["400 returned when an invalid filter value is supplied (e.g. unrecognized activity type)","422 returned when the cursor or filter combination is rejected by the Polymarket venue","502 returned when the Polymarket venue itself is unavailable or times out","Empty result set when the wallet has no activity matching the given filters","Invalid address format (not matching ^0x[a-fA-F0-9]{40}$) will cause a validation error"],"whenToPreferThis":"Use this endpoint when you need authoritative post-trade ground truth for a Polymarket account — especially after an ambiguous order submission, when reconciling fills and fees, auditing settled positions, or building a full activity ledger. It is the definitive source for Polygon transaction hashes tied to each event. Prefer it over position-snapshot endpoints when you need historical event streams rather than current state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:38:41.653Z","isFirstParty":false,"canonicalSlug":"chainhilt-polymarket-account-activity-history-253a61d7"}