# disputes.online

> disputes.online is a social prediction platform. Anyone can open a "dispute" — a question about a real-world event with two or more outcomes — and other people stake the platform's internal currency (QOT) on the outcome they expect. The split of stakes between outcomes is a live, crowd-sourced estimate of how likely each outcome is.

Things worth knowing before using the data:

- A dispute has a question (`description`), a list of outcomes (`variants`), a moment when betting closes (`stop_date`) and a moment when the result is due (`finish_date`).
- Payouts are pari-mutuel: winners share the whole pool, so an outcome's `coefficient` is the payout multiplier at the current split, and `variant.amount / total_amount` is the crowd's implied probability for that outcome.
- Amounts are in QOT, the platform's internal currency, not in dollars.
- Results are settled by a community jury vote, or by sports data for sports events.
- Disputes are written in many languages. List endpoints return one language at a time plus disputes marked `all`; pass `lang` explicitly (`en`, `ua`, `pl`, `de`, …). Without it the API assumes `en`.
- The public read API needs no key. Please keep it to a few requests per second and cache what you can; lists are cached server-side for a minute anyway.
- The canonical page for a dispute is `https://disputes.online/d/{id}`.

## Data for agents

- [MCP server](https://disputes.online/mcp): Model Context Protocol endpoint (Streamable HTTP, no key) with read-only tools to search disputes, read one, and list categories
- [OpenAPI description](https://disputes.online/openapi.json): the public, read-only API — list, search and read disputes, get the current odds on one (`/disputes/{id}/odds`), and list categories
- [Full reference in one file](https://disputes.online/llms-full.txt): the same API explained in prose with examples and field meanings
- [RSS feed](https://disputes.online/rss.xml): disputes open to bets right now, newest first
- [The same feed as JSON](https://disputes.online/rss.json): JSON Feed 1.1, served as `application/json` — use this one if your fetcher does not accept XML
- [Sitemap](https://disputes.online/sitemap.xml): every public page, including one entry per dispute

## Site

- [All disputes](https://disputes.online/d): browse and filter open disputes by category, country and language
- [Archive](https://disputes.online/d/archive): finished disputes and how they were settled
- [Rules](https://disputes.online/info/rules): how disputes are created, judged and paid out
- [Questions and answers](https://disputes.online/info/qas): common questions about the platform
- [QOT](https://disputes.online/qot): what the internal currency is and how it is obtained
- [Risk disclaimer](https://disputes.online/info/rd): what a participant should understand before staking

## Building on the platform

- [Developers](https://disputes.online/developers): the public API, the MCP server and the partner SDKs on one page
- [Partner API reference](https://docs.disputes.online/swagger/index.html): the signed API for games and apps that create disputes and settle them for their own users
- [Node.js SDK](https://github.com/peccancy/partner-sdk-node): `@peccancy/partner-sdk`
- [PHP SDK](https://github.com/peccancy/partner-sdk-php): `peccancy/partner-sdk`
- [Python SDK](https://github.com/peccancy/partner-sdk-python): `peccancy-partner-sdk`
- [Go SDK](https://github.com/peccancy/partner-sdk-go): `github.com/peccancy/partner-sdk-go`
- [Partners](https://disputes.online/all-partners): products already connected

## Optional

- [Terms of use](https://disputes.online/info/terms)
- [Privacy policy](https://disputes.online/info/privacy)
- [Contacts](https://disputes.online/info/contacts)