{"id":"clarification-impact","title":"Prediction-Market Clarification Impact Pricer","description":"Prices a prediction-market rules clarification as a trade. Given an open Polymarket market (slug, URL or conditionId; Kalshi ticker supported), reads the posted clarification (Additional context) from the UMA adapter on Polygon, or takes your clarificationText to price a pending or hypothetical one. Finds the real-world outcomes whose resolution changed, quotes each changed clause verbatim, shifts fair probability by their ensemble-estimated mass with an adversarial check, walks the live order book at your size after fees and slippage, and returns verdict.action BUY_YES / BUY_NO / EXIT / HOLD / NO_MATERIAL_CHANGE with edge in bps, fractional-Kelly size, confidence and reason_code. Closed markets return HOLD without a model call; if the estimate stage fails you still get the verified scenarios as a partial result. Not financial advice.","roi":"Turns a rules clarification into an executable, fee-aware trade decision before the order book re-prices: edge in bps, stake in dollars and the clause that drives it.","audience":"crypto","channels":["x402","mcp","rapidapi"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/clarification-impact","path":"/api/v1/clarification-impact","contentType":"application/json"},"price":{"amount":"0.50","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["market"],"properties":{"market":{"type":"string","minLength":3,"maxLength":500,"description":"Polymarket market slug, polymarket.com URL or conditionId; or a Kalshi market ticker (rules from the public trade-api v2)."},"rulesBefore":{"type":"string","maxLength":20000,"description":"Rules text before the change. Overrides the on-chain read; defaults to the creation-time rules plus earlier updates."},"clarificationText":{"type":"string","maxLength":10000,"description":"The clarification / Additional context text. Overrides the on-chain read."},"position":{"type":"object","additionalProperties":false,"required":["outcome","shares","avgPrice"],"properties":{"outcome":{"type":"string","enum":["YES","NO"],"description":"Held side; YES is the market's first outcome."},"shares":{"type":"number","minimum":0,"maximum":1000000000000},"avgPrice":{"type":"number","minimum":0,"maximum":1}}},"bankrollUsd":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Used to turn the Kelly fraction into dollars."},"sizeUsd":{"type":"number","minimum":0,"maximum":1000000000,"description":"Intended order size in USD (default 100)."},"priorYes":{"type":"number","minimum":0,"maximum":1,"description":"Override for the pre-clarification fair P(YES); default is the Polymarket CLOB price history just before the clarification, falling back to the current YES order-book mid."},"feeRate":{"type":"number","minimum":0,"maximum":0.25,"description":"Taker fee coefficient: fee = shares * feeRate * p * (1 - p). Defaults to the market's Gamma feeSchedule rate (0 when fees are disabled); Kalshi defaults to 0.07 times the series fee_multiplier from /series."},"minEdgeBps":{"type":"number","minimum":0,"maximum":10000,"description":"Minimum edge after fees and slippage, in bps of cost (default 100)."},"minMoveBps":{"type":"number","minimum":0,"maximum":10000,"description":"Fair-value move below which the answer is NO_MATERIAL_CHANGE (default 100)."},"kellyFraction":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of full Kelly to stake (default 0.25)."}}},"resultSchema":{"type":"object","properties":{"verdict":{"type":"object","description":"Machine-readable call, computed in code. Leads the answer; detail follows in the other fields.","properties":{"action":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason_code":{"type":"string","description":"Stable code for why this action was returned."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"0-1; null when no judgment was made."},"confidence_label":{"type":"string","enum":["low","medium","high"]},"edge_bps":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in bps of cost; null when not priced."},"edge_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in USD (cover-claim: cover-asset units); null when not priced."},"size_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Suggested stake in USD; null when not sized."},"headline":{"type":"string"},"drivers":{"type":"array","items":{"type":"string"}},"next_step":{"type":"string"},"partial":{"type":"boolean","description":"True when part of the analysis could not run; see missing."},"missing":{"type":"array","items":{"type":"string"}}}},"disclaimer":{"type":"string","description":"Not financial advice."},"partial":{"type":"boolean","description":"True when the estimate stage failed; scenarios are listed unpriced in unpriced_scenarios."},"missing":{"type":"array","items":{"type":"string"}},"unpriced_scenarios":{"type":"array","items":{"type":"object"},"description":"Present on a partial answer: verified scenarios without probabilities."},"market":{"type":"object"},"clarification":{"type":"object"},"recommendation":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason":{"type":"string"},"predicates":{"type":"object","description":"Deprecated: always {before: null, after: null}; predicates are no longer extracted."},"decided_by":{"type":"string","description":"\"deterministic\" when no model ran (restatement gate, placeholder, absent clarification), else \"llm_scenarios\"."},"flipped_scenarios":{"type":"array","items":{"type":"object"},"description":"Outcomes that resolve differently, with verified verbatim clauses and ensemble probabilities."},"dropped_scenarios":{"type":"array","items":{"type":"object"}},"fair":{"type":"object","description":"Pre-clarification prior (with anchor timestamp and source), current mid, posterior and adversarial posterior P(YES)."},"book":{"type":"object","description":"Fee coefficient and book walks: average fill, slippage, fees."},"edge":{"type":"object"},"sizing":{"type":"object"},"sibling_implications":{"type":"array","items":{"type":"object"}},"confidence":{"type":"object"},"what_would_change_the_call":{"type":"array","items":{"type":"string"}},"evidence_sources":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"}},"analyzed_at":{"type":"string"}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"verdict":{"type":"object","description":"Machine-readable call, computed in code. Leads the answer; detail follows in the other fields.","properties":{"action":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason_code":{"type":"string","description":"Stable code for why this action was returned."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"0-1; null when no judgment was made."},"confidence_label":{"type":"string","enum":["low","medium","high"]},"edge_bps":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in bps of cost; null when not priced."},"edge_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in USD (cover-claim: cover-asset units); null when not priced."},"size_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Suggested stake in USD; null when not sized."},"headline":{"type":"string"},"drivers":{"type":"array","items":{"type":"string"}},"next_step":{"type":"string"},"partial":{"type":"boolean","description":"True when part of the analysis could not run; see missing."},"missing":{"type":"array","items":{"type":"string"}}}},"disclaimer":{"type":"string","description":"Not financial advice."},"partial":{"type":"boolean","description":"True when the estimate stage failed; scenarios are listed unpriced in unpriced_scenarios."},"missing":{"type":"array","items":{"type":"string"}},"unpriced_scenarios":{"type":"array","items":{"type":"object"},"description":"Present on a partial answer: verified scenarios without probabilities."},"market":{"type":"object"},"clarification":{"type":"object"},"recommendation":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason":{"type":"string"},"predicates":{"type":"object","description":"Deprecated: always {before: null, after: null}; predicates are no longer extracted."},"decided_by":{"type":"string","description":"\"deterministic\" when no model ran (restatement gate, placeholder, absent clarification), else \"llm_scenarios\"."},"flipped_scenarios":{"type":"array","items":{"type":"object"},"description":"Outcomes that resolve differently, with verified verbatim clauses and ensemble probabilities."},"dropped_scenarios":{"type":"array","items":{"type":"object"}},"fair":{"type":"object","description":"Pre-clarification prior (with anchor timestamp and source), current mid, posterior and adversarial posterior P(YES)."},"book":{"type":"object","description":"Fee coefficient and book walks: average fill, slippage, fees."},"edge":{"type":"object"},"sizing":{"type":"object"},"sibling_implications":{"type":"array","items":{"type":"object"}},"confidence":{"type":"object"},"what_would_change_the_call":{"type":"array","items":{"type":"string"}},"evidence_sources":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"}},"analyzed_at":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"market":"will-jd-vance-win-the-2028-us-presidential-election","clarificationText":"Clarification: if no person has been inaugurated by January 20, 2029 because the election result is contested or decided by a House contingent election, this market resolves 50-50 rather than to the person eventually seated.","bankrollUsd":10000,"sizeUsd":250},"openapiOperation":{"operationId":"clarification_impact","summary":"Prediction-Market Clarification Impact Pricer","description":"Prices a prediction-market rules clarification as a trade. Given an open Polymarket market (slug, URL or conditionId; Kalshi ticker supported), reads the posted clarification (Additional context) from the UMA adapter on Polygon, or takes your clarificationText to price a pending or hypothetical one. Finds the real-world outcomes whose resolution changed, quotes each changed clause verbatim, shifts fair probability by their ensemble-estimated mass with an adversarial check, walks the live order book at your size after fees and slippage, and returns verdict.action BUY_YES / BUY_NO / EXIT / HOLD / NO_MATERIAL_CHANGE with edge in bps, fractional-Kelly size, confidence and reason_code. Closed markets return HOLD without a model call; if the estimate stage fails you still get the verified scenarios as a partial result. Not financial advice.\n\nPrice: 0.50 USDC on Base (x402).","x-x402-price-usdc":"0.50","x-x402-amount":"500000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"x-audience":"crypto","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/clarification-impact","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["market"],"properties":{"market":{"type":"string","minLength":3,"maxLength":500,"description":"Polymarket market slug, polymarket.com URL or conditionId; or a Kalshi market ticker (rules from the public trade-api v2)."},"rulesBefore":{"type":"string","maxLength":20000,"description":"Rules text before the change. Overrides the on-chain read; defaults to the creation-time rules plus earlier updates."},"clarificationText":{"type":"string","maxLength":10000,"description":"The clarification / Additional context text. Overrides the on-chain read."},"position":{"type":"object","additionalProperties":false,"required":["outcome","shares","avgPrice"],"properties":{"outcome":{"type":"string","enum":["YES","NO"],"description":"Held side; YES is the market's first outcome."},"shares":{"type":"number","minimum":0,"maximum":1000000000000},"avgPrice":{"type":"number","minimum":0,"maximum":1}}},"bankrollUsd":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Used to turn the Kelly fraction into dollars."},"sizeUsd":{"type":"number","minimum":0,"maximum":1000000000,"description":"Intended order size in USD (default 100)."},"priorYes":{"type":"number","minimum":0,"maximum":1,"description":"Override for the pre-clarification fair P(YES); default is the Polymarket CLOB price history just before the clarification, falling back to the current YES order-book mid."},"feeRate":{"type":"number","minimum":0,"maximum":0.25,"description":"Taker fee coefficient: fee = shares * feeRate * p * (1 - p). Defaults to the market's Gamma feeSchedule rate (0 when fees are disabled); Kalshi defaults to 0.07 times the series fee_multiplier from /series."},"minEdgeBps":{"type":"number","minimum":0,"maximum":10000,"description":"Minimum edge after fees and slippage, in bps of cost (default 100)."},"minMoveBps":{"type":"number","minimum":0,"maximum":10000,"description":"Fair-value move below which the answer is NO_MATERIAL_CHANGE (default 100)."},"kellyFraction":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of full Kelly to stake (default 0.25)."}}},"example":{"market":"will-jd-vance-win-the-2028-us-presidential-election","clarificationText":"Clarification: if no person has been inaugurated by January 20, 2029 because the election result is contested or decided by a House contingent election, this market resolves 50-50 rather than to the person eventually seated.","bankrollUsd":10000,"sizeUsd":250}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"verdict":{"type":"object","description":"Machine-readable call, computed in code. Leads the answer; detail follows in the other fields.","properties":{"action":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason_code":{"type":"string","description":"Stable code for why this action was returned."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"0-1; null when no judgment was made."},"confidence_label":{"type":"string","enum":["low","medium","high"]},"edge_bps":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in bps of cost; null when not priced."},"edge_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expected edge in USD (cover-claim: cover-asset units); null when not priced."},"size_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Suggested stake in USD; null when not sized."},"headline":{"type":"string"},"drivers":{"type":"array","items":{"type":"string"}},"next_step":{"type":"string"},"partial":{"type":"boolean","description":"True when part of the analysis could not run; see missing."},"missing":{"type":"array","items":{"type":"string"}}}},"disclaimer":{"type":"string","description":"Not financial advice."},"partial":{"type":"boolean","description":"True when the estimate stage failed; scenarios are listed unpriced in unpriced_scenarios."},"missing":{"type":"array","items":{"type":"string"}},"unpriced_scenarios":{"type":"array","items":{"type":"object"},"description":"Present on a partial answer: verified scenarios without probabilities."},"market":{"type":"object"},"clarification":{"type":"object"},"recommendation":{"type":"string","enum":["BUY_YES","BUY_NO","EXIT","HOLD","NO_MATERIAL_CHANGE","INSUFFICIENT_EVIDENCE"]},"reason":{"type":"string"},"predicates":{"type":"object","description":"Deprecated: always {before: null, after: null}; predicates are no longer extracted."},"decided_by":{"type":"string","description":"\"deterministic\" when no model ran (restatement gate, placeholder, absent clarification), else \"llm_scenarios\"."},"flipped_scenarios":{"type":"array","items":{"type":"object"},"description":"Outcomes that resolve differently, with verified verbatim clauses and ensemble probabilities."},"dropped_scenarios":{"type":"array","items":{"type":"object"}},"fair":{"type":"object","description":"Pre-clarification prior (with anchor timestamp and source), current mid, posterior and adversarial posterior P(YES)."},"book":{"type":"object","description":"Fee coefficient and book walks: average fill, slippage, fees."},"edge":{"type":"object"},"sizing":{"type":"object"},"sibling_implications":{"type":"array","items":{"type":"object"}},"confidence":{"type":"object"},"what_would_change_the_call":{"type":"array","items":{"type":"string"}},"evidence_sources":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"}},"analyzed_at":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/clarification-impact/","docsJson":"https://agents.writerslogic.com/docs/clarification-impact.json","sample":"https://agents.writerslogic.com/api/v1/samples/clarification-impact","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}