> For the complete documentation index, see [llms.txt](https://docs.cournot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cournot.ai/api-reference/partner-public-api.md). # Partner Public API Cournot provides partners with public endpoints to retrieve market verdicts and file disputes. The system produces final settlement records including verdicts, confidence assessments, and blockchain proofs. ### Base URL > #### Response Envelope All responses return HTTP 200. Branch on the `code` field, not HTTP status: ```json // Success { "code": 0, "msg": "Success", "data": { /* payload */ } } // Error { "code": 4100, "msg": "slug is required", "detail": "slug is required" } ```


Field	Type	Description
`code`	int	0 = success; non-zero = error
`msg`	string	Human-readable status
`data`	object	Present on success
`detail`	string	Present on error

### GET `/cournot/markets/public` Retrieve a market's public settlement record. No authentication required. **Query Parameters**:


Parameter	Type	Required	Description
`slug`	string	Yes	Market slug (no leading/trailing slashes)
`source`	string	Yes	Partner-specific identifier issued by Cournot

#### Example Request: ```json curl -G "https://interface.cournot.ai/cournot/markets/public" \ --data-urlencode "slug=ram-average-price-above-600-by-end-of-march" \ --data-urlencode "source=YOUR_SOURCE_ID" ``` #### Example Response: ```json { "code": 0, "msg": "Success", "data": { "markets": [ { "id": 61, "source": "YOUR_SOURCE_ID", "slug": "ram-average-price-above-600-by-end-of-march", "status": "resolved", "verdict": "YES", "resolved_at": "2026-04-28T10:08:40Z", "confidence": "HIGH", "reasoning": "multi-source evidence confirmed the final outcome is YES", "proofs": [ { "chain": "base", "tx_hash": "0xabc..." }, { "chain": "bsc", "tx_hash": "0xdef..." } ], "disputes": [ { "id": 4, "status": "closed", "submitter_selection": "NO", "reason_text": "we believe the resolved outcome is incorrect", "submitted_at": "2026-04-28T10:30:00Z", "decision": { "type": "override", "partner_final_verdict": "NO", "reason_text": "submitted dispute is valid", "decided_at": "2026-04-28T11:00:00Z" } } ] } ] } } ``` #### Response Fields (`data.markets[]`):


Field	Type	Description
`id`	int64	Market identifier
`source`	string	Partner source identifier
`slug`	string	Market slug
`status`	string	`monitoring` / `resolved` / `disputed` / `closed`
`verdict`	string	Final verdict text
`resolved_at`	string	RFC 3339 UTC timestamp
`confidence`	string	`VERY_HIGH` / `HIGH` / `MEDIUM` / `LOW` / `VERY_LOW`
`reasoning`	string	Human-readable explanation
`proofs`	array	On-chain proof records
`disputes`	array or null	Dispute records; `null` if none


Field	Type	Description
`id`	int64	Dispute identifier
`status`	string	`open` or `closed`
`submitter_selection`	string	Claimed correct outcome
`reason_text`	string	Justification
`submitted_at`	string	RFC 3339 UTC timestamp
`decision`	object or null	Present only when closed

#### Decision Object:


Field	Type	Description
`type`	string	`keep` or `override`
`partner_final_verdict`	string	Final verdict after decision
`reason_text`	string	Decision justification
`decided_at`	string	RFC 3339 UTC timestamp

Notes: * When no disputes exist, `disputes` is `null` (not an empty array). * When no market matches, `data.markets` returns an empty array. *** ### POST `/cournot/markets/dispute/submit` File a dispute on behalf of an end user. Requires API key authentication. #### Headers:


Header	Value
`Content-Type`	`application/json`
`x-api-key`	Partner API key

#### Request Body:


Field	Type	Required	Description
`market_id`	int64	Yes	Market ID from `get_public_market`
`submitter_id`	string	Yes	End user's unique identifier on partner platform
`submitter_name`	string	Yes	Submitter's display name
`submitter_selection`	string	Yes	Outcome the submitter claims is correct
`reason_text`	string	Yes	Dispute justification
`submitted_at`	string	Yes	RFC 3339 UTC timestamp

#### Example Request: ```json curl -X POST "https://interface.cournot.ai/cournot/markets/dispute/submit" \ -H "content-type: application/json" \ -H "x-api-key: YOUR_PARTNER_API_KEY" \ -d '{ "market_id": 61, "submitter_id": "partner_user_1001", "submitter_name": "alice", "submitter_selection": "NO", "reason_text": "we believe the resolved outcome is incorrect based on source evidence", "submitted_at": "2026-04-28T10:30:00Z" }' ``` #### Example Response: ```json { "code": 0, "msg": "Success", "data": { "dispute_id": 4 } } ``` **Business Rules:** * The partner's `source` (derived from API key) must match the market's source. Cross-partner disputes are forbidden. * Only markets with `status = resolved` can be disputed. * Each market accepts a maximum of one dispute. *** ### Integration Workflows #### Standard Resolution Flow: 1. Poll `GET /cournot/markets/public` for your markets. 2. When a market reaches `status: resolved`, extract the `verdict`, `confidence`, and `proofs`. 3. Use this record to settle the corresponding market on your platform. #### Dispute Handling Flow: 1. End user contests a verdict on your platform. 2. Submit dispute via `POST /cournot/markets/dispute/submit`. 3. Market transitions from `resolved` → `disputed`. 4. Cournot conducts internal review. 5. Market becomes `closed` with a `decision` object (`type: keep` or `type: override`). 6. Poll `GET /cournot/markets/public` to retrieve the final decision. #### Market Lifecycle:

*** Traditional oracles made trusted data available on-chain. Cournot makes trusted data programmable by meaning, extends it into intelligence, and ultimately enables action.

Prediction markets prove the architecture. RWA pricing proves semantic aggregation. Trading intelligence proves persistent monitoring. The agent economy is where it all converges. **Data → Semantic Data → Intelligence → Action.** Cournot is building Oracle 4.0.