{"uid":"cap_JVptYuPbMRf4DSKQXHoMw","slug":"vextorium-polymarket-trades-f716e595","name":"Vextorium Polymarket Trades","description":"Recent trades of a Polymarket market (by slug): buys and sells per outcome with price, USD size, wallet and tx, net buy/sell flow per outcome and the largest orders. Set a minimum size to follow whales.","url":"https://api.vextorium.com/v1/polymarket-trades?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["slug"],"properties":{"slug":{"type":"string"},"limit":{"type":"integer"},"min_usd":{"type":"number"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"note":{"type":["string","null"]},"slug":{"type":["string","null"]},"since":{"type":["string","null"]},"recent":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"tx":{"type":["null","string"]},"usd":{"type":["null","number"]},"date":{"type":["null","string"]},"side":{"type":["null","string"]},"price":{"type":["null","number"]},"result":{"type":["null","string"]},"stakes":{"type":["null","number"]},"wallet":{"type":["null","string"]}}}},"source":{"type":["string","null"]},"largest":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"tx":{"type":["null","string"]},"usd":{"type":["null","number"]},"date":{"type":["null","string"]},"side":{"type":["null","string"]},"price":{"type":["null","number"]},"result":{"type":["null","string"]},"stakes":{"type":["null","number"]},"wallet":{"type":["null","string"]}}}},"question":{"type":["string","null"]},"analyzed_trades":{"type":["number","null"]},"flow_per_result":{"type":["object","null"],"properties":{"No":{"type":["object","null"],"properties":{"trades":{"type":["number","null"]},"buys_usd":{"type":["number","null"]},"sells_usd":{"type":["number","null"]},"net_flow_usd":{"type":["number","null"]}}},"Yes":{"type":["object","null"],"properties":{"trades":{"type":["number","null"]},"buys_usd":{"type":["number","null"]},"sells_usd":{"type":["number","null"]},"net_flow_usd":{"type":["number","null"]}}}}}}}}}}},"responseSchema":{"type":"json","example":{"note":"Flow of the latest trades (up to 500); they are not guaranteed predictions.","slug":"will-oprah-winfrey-win-the-2028-democratic-presidential-nomination","since":"2026-08-31T05:13:04+00:00","recent":[{"tx":"0x61126fd9cdfdf95d47802855d8884597fe057d1e691da9a71eda913f95913469","usd":0.03,"date":"2026-10-02T16:21:30+00:00","side":"buy","price":0.001,"result":"Yes","stakes":25,"wallet":"0x55c07e4005ce11ee0c1e91c481b39091bb350b35"},{"tx":"0x4accf4d49d34870911b92a400eaa0da272056622ead422149bddef3a123c1d89","usd":0.03,"date":"2026-10-02T16:21:27+00:00","side":"buy","price":0.001,"result":"Yes","stakes":25,"wallet":"0x55c07e4005ce11ee0c1e91c481b39091bb350b35"}],"source":"Polymarket (public data API)","largest":[{"tx":"0x2c94952c6905afb733fb388950ff1f61c2c616c6537afbd5e57c8643a7ab0838","usd":499.5,"date":"2026-09-04T16:48:45+00:00","side":"buy","price":0.999,"result":"No","stakes":500,"wallet":"0x72f9fc3bed03fc02b33d4a242d576a9dfca7c573"},{"tx":"0x2e71591406b95337712df97460869d2773883660cdb010565577541bca7aabb6","usd":499.5,"date":"2026-09-03T14:13:00+00:00","side":"buy","price":0.999,"result":"No","stakes":500,"wallet":"0x72f9fc3bed03fc02b33d4a242d576a9dfca7c573"}],"question":"Will Oprah Winfrey win the 2028 Democratic presidential nomination?","analyzed_trades":500,"flow_per_result":{"No":{"trades":454,"buys_usd":3785,"sells_usd":5661,"net_flow_usd":-1876},"Yes":{"trades":46,"buys_usd":50,"sells_usd":105,"net_flow_usd":-55}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CJ7nfRzAdCXSZeu8RXNpN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent and largest trades on a specific Polymarket prediction market, including money flow analysis broken down by outcome (Yes/No).","exampleAgentPrompt":"Pull the Polymarket trade data for the market 'will-trump-win-the-2024-us-presidential-election' — show me recent trades, the largest ones, and how money is flowing between Yes and No outcomes.","exampleUseCases":[{"title":"Monitoring smart money on political markets","prompt":"Show me the biggest trades and net money flow for Yes vs No on the Polymarket market 'will-kamala-harris-win-the-2024-us-presidential-election' — I want to see if large wallets are piling into one side."},{"title":"Detecting whale activity on a crypto event market","prompt":"Pull recent trades on the Polymarket slug 'will-bitcoin-reach-100k-by-end-of-2024' and highlight the top 5 largest trades with wallet addresses and transaction hashes."},{"title":"Tracking sentiment shift via trade flow","prompt":"For the Polymarket market 'will-the-fed-cut-rates-in-september-2024', analyze the USD flow into Yes versus No across the latest 500 trades and tell me if there's been a net buy or sell on each side."}],"resultDescription":"Returns a JSON object containing: the market question text, a list of the most recent trades (up to the requested limit), a list of the largest trades by USD size, total analyzed trade count, a timestamp since when trades were analyzed, and a flow_per_result breakdown showing total trades, buys USD, sells USD, and net flow USD separately for Yes and No outcomes. Each trade includes transaction hash, USD amount, date, buy/sell side, price, outcome result, number of stakes, and wallet address.","failureModes":["Invalid or non-existent slug returns empty or error response","Market has no trades yet — returns empty recent/largest arrays","Limit parameter exceeds maximum (500) resulting in capped results","Network latency from Polymarket's public API causing delayed or failed fetch","Malformed slug format causes lookup failure"],"whenToPreferThis":"Use this endpoint when you need granular trade-level data for a specific Polymarket prediction market, including individual transaction details, wallet addresses, and directional money flow analysis. Prefer this over general Polymarket browsing when you want to detect whale activity, analyze net buying/selling pressure per outcome, or monitor a particular market's trading history programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:39:18.140Z","isFirstParty":false,"canonicalSlug":"vextorium-polymarket-trades-f716e595"}