{"uid":"cap_t3jwiPYg_0z0MlW5GGqbI","slug":"dripmetrics-ai-polymarket-two-sidedness-42fb4b29","name":"DripMetrics AI – Polymarket Two-Sidedness","description":"DripMetricsAI (https://dripmetrics.ai/) provides on-demand crypto market microstructure metrics, Hyperliquid candle metrics, Polymarket diagnostics, and on-chain DefiLlama metrics for agents, dashboards, and trading workflows.","url":"https://api.dripmetrics.ai/polymarket/two-sidedness","method":"POST","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":["POST"],"type":"string"},"queryParams":{"type":"object","anyOf":[{"required":["conditionId"]},{"required":["slug"]}],"required":[],"properties":{"slug":{"type":"string","description":"Polymarket market or event slug for human-readable market selection. Multi-market event slugs may require conditionId to disambiguate."},"endTs":{"type":"integer","description":"Optional unix timestamp upper bound."},"limit":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum number of trades to evaluate."},"newsTs":{"type":"integer","description":"Optional explicit event timestamp for leakage scoring. If omitted, the metric uses the midpoint of the effective analysis window."},"assetId":{"type":"string","description":"Alias for tokenId on price-history-based endpoints."},"outcome":{"enum":["YES","NO"],"type":"string","description":"Required for token-side Polymarket diagnostics when the selected YES or NO side must be interpreted."},"startTs":{"type":"integer","description":"Optional unix timestamp lower bound."},"tokenId":{"type":"string","description":"Polymarket token / asset ID for orderbook and price-history endpoints."},"conditionId":{"type":"string","description":"Polymarket condition ID for trade-based metrics."},"windowMinutes":{"type":"integer","minimum":1,"description":"Lookback window in minutes."},"lookbackMinutes":{"type":"integer","minimum":1,"description":"Historical lookback used for probability shock normalization."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["metric","window","value","components","sampleSize","source","computedAt"],"properties":{"slug":{"type":"string"},"value":{"type":["number","null"]},"metric":{"type":"string"},"source":{"type":"object"},"window":{"type":"object"},"assetId":{"type":"string"},"outcome":{"type":"string"},"tokenId":{"type":"string"},"components":{"type":"object"},"computedAt":{"type":"string","format":"date-time"},"sampleSize":{"type":"object"},"conditionId":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"slug":"fed-decision-in-october","value":0.7816,"metric":"two-sidedness","source":{"market":"https://gamma-api.polymarket.com/markets/slug/fed-decision-in-october","trades":"https://data-api.polymarket.com/trades"},"window":{"windowMinutes":60},"components":{"noVolume":7978.6,"yesVolume":12450.2,"dominantOutcome":"YES"},"computedAt":"2026-05-25T14:00:00.000Z","sampleSize":{"trades":186},"conditionId":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9tD2FIkNcHq_RdYQBY36X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a two-sidedness score for a Polymarket prediction market, measuring how balanced YES vs NO trading volume is over a given time window.","exampleAgentPrompt":"What's the two-sidedness score for the Polymarket market with slug 'fed-decision-in-october' over the last 60 minutes? I want to know how balanced the YES and NO trading volumes are.","exampleUseCases":[{"title":"Detect one-sided market manipulation","prompt":"Check the two-sidedness score for the Polymarket market 'will-trump-win-2024' over the last 120 minutes — I want to know if trading is heavily skewed toward one outcome or reasonably balanced."},{"title":"Pre-trade liquidity check for a bot","prompt":"Before my trading bot enters a position, can you pull the two-sidedness metric for Polymarket conditionId 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917 over the last 30 minutes so I know whether there's real two-way flow?"},{"title":"Dashboard monitoring for market health","prompt":"I'm building a prediction market dashboard — give me the two-sidedness score for the Polymarket slug 'us-recession-2025' using up to 500 trades so I can display a market health indicator."}],"resultDescription":"Returns a JSON object with a two-sidedness score (float 0–1, where 1 = perfectly balanced), the YES and NO volumes, the dominant outcome, the number of trades sampled, the effective time window, the conditionId, a source URLs object pointing to Polymarket data, and a computedAt ISO timestamp.","failureModes":["Missing both conditionId and slug returns a 400 validation error","Unknown or invalid conditionId/slug returns a 404 or empty result","Insufficient trade data in the window yields a low sample size and possibly unreliable score","windowMinutes too small may return zero trades","Limit exceeding 5000 is rejected by schema validation","Payment failure (x402) returns a 402 if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a single scalar metric summarizing the balance of YES vs NO trading volume on a specific Polymarket market — especially useful for pre-trade liquidity checks, market health dashboards, or detecting one-sided manipulation. Prefer it over raw trade feeds when you want a pre-computed, normalized two-sidedness score rather than raw orderbook data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:08.101Z","isFirstParty":false}