Outcomes are determined by Kash’s automated resolution system from the market’s published sources and rules. A market resolves in three steps: the system proposes an outcome, a dispute window runs until the market’s
resolution.finalizableAt, then the market settles. An undisputed proposal settles when its window ends. An open dispute holds settlement while the same automated system reviews it against the market’s sources and rules; the market settles on the result of that review.
Watch resolution and resolutionState on the market resource to know when a proposal exists and when its window closes.
The dispute resource
POST /v1/markets/{id}/disputes
Files your dispute against the market’s pending proposal.
Response
201: { dispute, data, _meta }. Settlement is now blocked until review.
Errors:
409 DISPUTE_WINDOW_CLOSED: the window ended (afterfinalizableAt).409 DISPUTE_DECIDED: the market’s disputes have already been reviewed and the market has settled.409 DISPUTE_ALREADY_FILED: one dispute per user per proposal.422 MARKET_NOT_DISPUTABLE: the market has no proposal, or its settlement has begun.404 RESOURCE_NOT_FOUND: the market does not exist.
GET /v1/markets/{id}/disputes
Returns the latest dispute you filed against this market, including the review outcome. Response 200: { dispute, data, _meta }. Returns 404 RESOURCE_NOT_FOUND if you have not filed one: disputes filed by other users are never visible.