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

https://interface.cournot.ai

Response Envelope

All responses return HTTP 200. Branch on the code field, not HTTP status:

// 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:

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:

{
  "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

Proof Item:

Field	Type	Description
chain	string	base or bsc
tx_hash	string	Transaction hash

Dispute Item:

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:

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:

{ "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.