API Reference

# No request body — pass id as a query parameter
GET https://interface.cournot.ai/play/polymarket/markets/id?id=185557

curl "https://interface.cournot.ai/play/polymarket/markets/id?id=185557"

{
  "code": 0,
  "msg": "Success",
  "data": {
    "market": {
      "id": 185557,
      "title": "Will Denmark use a 4-3-3 starting lineup?",
      "description": "<resolution criteria...>",
      "platform_url": "https://polymarket.com/event/...",
      "source": "polymarket",
      "status": "monitoring",
      "market_timing_type": "time_based",
      "start_time": "2025-03-20T00:00:00Z",
      "end_time": "2026-03-26T21:00:00Z",
      "ai_prompt": { "..." : "..." },
      "ai_result": "",
      "ai_outcome": ""
    },
    "external_data": [
      {
        "collector": "espn_soccer",
        "data": {
          "event": "Denmark vs North Macedonia",
          "status": "pre",
          "venue": "Parken Stadium"
        }
      }
    ],
    "classification": {
      "category": "sports",
      "subcategory": "football",
      "competition": "FIFA World Cup Qualifiers"
    }
  }
}

# Pass parameters as query strings
GET https://interface.cournot.ai/play/polymarket/markets/disputes?code={code}&market_id=185557&dispute_type=manual&page_num=1&page_size=10

curl "https://interface.cournot.ai/play/polymarket/markets/disputes?code={code}&market_id=185557&dispute_type=manual&page_num=1&page_size=10"

{
  "code": 0,
  "msg": "Success",
  "data": {
    "disputes": [
      {
        "id": 42,
        "market_id": 185557,
        "dispute_type": "manual",
        "previous_ai_result": "{\"outcome\":\"YES\",\"confidence\":0.92,...}",
        "previous_ai_outcome": "YES",
        "proposed_ai_result": "{\"outcome\":\"NO\",\"confidence\":0.85,...}",
        "proposed_ai_outcome": "NO",
        "reason": "New evidence shows the event was cancelled",
        "submitted_by": "admin_1",
        "is_accepted": true,
        "accepted_by": "admin_2",
        "accepted_time": "2025-06-15T14:30:00Z",
        "created_time": "2025-06-15T12:00:00Z"
      }
    ],
    "total": 1
  }
}

{
  "code":      "<YOUR_ACCESS_CODE>",
  "post_data": "<STRINGIFIED_JSON_PAYLOAD>",
  "path":      "<INTERNAL_PATH>",
  "method":    "<HTTP_METHOD>"
}

{
  "code": 0,
  "msg":  "Success",
  "data": {
    "result": "<STRINGIFIED_STEP_RESPONSE>"
  }
}

{
  "user_input": "Will Bitcoin exceed 100k by March 2025?",
  "strict_mode": false
}

curl -X POST 'https://interface.cournot.ai/play/polymarket/ai_data' \
  -H 'Content-Type: application/json' \
  --max-time 300 \
  -d '{
    "code": "YOUR_CODE",
    "post_data": "{\"user_input\": \"Will Bitcoin exceed 100k by March 2025?\", \"strict_mode\": false}",
    "path": "/step/prompt",
    "method": "POST"
  }'

{
  "ok": true,
  "market_id": "mk_3f5b9c7e",
  "prompt_spec": {
    "schema_version": "v1",
    "task_type": "prediction_resolution",
    "market": {
      "market_id": "mk_3f5b9c7e",
      "question": "Will Bitcoin exceed 100k by March 2025?",
      "market_type": "binary",
      "possible_outcomes": ["YES", "NO"],
      "resolution_rules": {
        "rules": [
          { "rule_id": "r1", "description": "...", "priority": 1 }
        ]
      }
    },
    "prediction_semantics": {
      "target_entity": "Bitcoin",
      "predicate": "exceeds",
      "threshold": "100000 USD",
      "timeframe": "by March 2025"
    },
    "data_requirements": [
      {
        "requirement_id": "req_01",
        "description": "Current BTC price data",
        "source_targets": [...]
      }
    ]
  },
  "tool_plan": {
    "plan_id": "plan_abc123",
    "requirements": ["req_01"],
    "sources": ["source_coinmarketcap"],
    "min_provenance_tier": 1,
    "allow_fallbacks": true
  },
  "metadata": {
    "compiler": "prompt-compiler-v2",
    "strict_mode": false,
    "requirement_count": 3
  },
  "error": null
}

PromptSpec {
  schema_version      "v1"
  task_type           "prediction_resolution"
  market {
    market_id, question, event_definition, timezone
    resolution_deadline, resolution_window { start, end }
    resolution_rules.rules[] { rule_id, description, priority }
    allowed_sources[]  { source_id, kind, allow, min_provenance_tier }
    market_type        "binary"
    possible_outcomes  ["YES", "NO"]
  }
  prediction_semantics { target_entity, predicate, threshold, timeframe }
  data_requirements[] {
    requirement_id, description
    source_targets[] { source_id, uri, method, expected_content_type }
    selection_policy  { strategy, min_sources, max_sources, quorum }
  }
  extra {
    strict_mode, compiler, assumptions[]
    confidence_policy { min_confidence_for_yesno, default_confidence }
    temporal_constraint? {       // auto-detected for scheduled events
      enabled        true
      event_time     ISO 8601 UTC
      reason         string
    }
  }
}

ToolPlan {
  plan_id, requirements[], sources[]
  min_provenance_tier, allow_fallbacks
}

{
  "prompt_spec": { ... },
  "tool_plan":   { ... },
  "collectors":  ["CollectorWebPageReader", "CollectorOpenSearch"],
  "include_raw_content": false
}

{
  "ok": true,
  "collectors_used": ["CollectorWebPageReader", "CollectorOpenSearch"],
  "evidence_bundles": [
    {
      "bundle_id": "eb_a1b2c3",
      "market_id": "mk_3f5b9c7e",
      "collector_name": "CollectorWebPageReader",
      "weight": 1.0,
      "items": [
        {
          "evidence_id": "ev_abc123",
          "source_uri": "https://...",
          "source_name": "CoinMarketCap",
          "tier": 1,
          "fetched_at": "2025-01-15T10:30:00Z",
          "content_hash": "sha256:a1b2c3...",
          "parsed_excerpt": "Bitcoin is currently trading at ...",
          "success": true,
          "extracted_fields": {
            "confidence": 0.85,
            "resolution_status": "OPEN"
          }
        }
      ],
      "collected_at": "2025-01-15T10:30:05Z",
      "execution_time_ms": 4523
    }
  ],
  "execution_logs": [
    {
      "plan_id": "plan_abc123",
      "calls": [
        {
          "tool": "CollectorWebPageReader",
          "started_at": "...",
          "ended_at": "...",
          "error": null
        }
      ]
    }
  ],
  "errors": []
}

EvidenceBundle {
  bundle_id, market_id, plan_id, collector_name
  weight             number (default 1.0)
  items[] {
    evidence_id      hex hash
    requirement_id   links back to data_requirements
    provenance {
      source_id, source_uri, tier, fetched_at
      content_hash   SHA-256 of raw content
      cache_hit      boolean
    }
    content_type, parsed_value, success, error
    extracted_fields { ... }
  }
  collected_at, execution_time_ms
  requirements_fulfilled[], requirements_unfulfilled[]
}

ExecutionLog {
  plan_id
  calls[] { tool, input, output, started_at, ended_at, error }
  started_at, ended_at
}

{
  "prompt_spec":      { ... },
  "evidence_bundles": [ ... ]
}

{
  "ok": true,
  "scorecard": {
    "source_match": "PARTIAL",
    "data_type_match": true,
    "collector_agreement": "AGREE",
    "requirements_coverage": 0.65,
    "quality_level": "MEDIUM",
    "quality_flags": ["source_mismatch"],
    "meets_threshold": false,
    "recommendations": [
      "Try broader search terms for requirement req_001"
    ],
    "retry_hints": {
      "search_queries": ["bitcoin price 2025 prediction"],
      "required_domains": ["coinmarketcap.com"],
      "skip_domains": [],
      "data_type_hint": null,
      "focus_requirements": ["req_001"],
      "collector_guidance": "Focus on price data sources"
    }
  },
  "meets_threshold": false,
  "errors": []
}

{
  "prompt_spec":          { ... },
  "evidence_bundles":     [ ... ],
  "quality_scorecard":    { ... },
  "temporal_constraint":  {
    "enabled": true,
    "event_time": "2027-05-31T00:00:00Z",
    "reason": "Champions League final"
  }
}

{
  "ok": true,
  "reasoning_trace": {
    "trace_id": "tr_xyz789",
    "market_id": "mk_3f5b9c7e",
    "steps": [
      {
        "step_id": "s1",
        "step_type": "evidence_evaluation",
        "description": "Evaluate BTC price data from CoinMarketCap",
        "evidence_refs": [
          {
            "evidence_id": "ev_abc123",
            "source_id": "source_coinmarketcap",
            "field_used": "current_price",
            "value_at_reference": "97500"
          }
        ],
        "conclusion": "BTC is currently at $97,500, close to but below the $100k threshold",
        "confidence_delta": 0.1
      }
    ],
    "conflicts": [],
    "evidence_summary": "Multiple sources confirm BTC near $97.5k ...",
    "reasoning_summary": "Based on current price trajectory ...",
    "preliminary_outcome": "YES",
    "preliminary_confidence": 0.72,
    "recommended_rule_id": "r1"
  },
  "errors": []
}

ReasoningTrace {
  trace_id, market_id, bundle_id
  steps[] {
    step_id, step_type, description
    evidence_refs[] {
      evidence_id, requirement_id, source_id
      field_used, value_at_reference
    }
    rule_id, input_summary, output_summary
    conclusion, confidence_delta
    depends_on[], metadata
  }
  conflicts[]
  evidence_summary       human-readable text
  reasoning_summary      human-readable text
  preliminary_outcome    "YES" | "NO" | "INVALID"
  preliminary_confidence number (0-1)
  recommended_rule_id
}

{
  "prompt_spec":         { ... },
  "evidence_bundles":    [ ... ],
  "reasoning_trace":     { ... },
  "quality_scorecard":   { ... },
  "temporal_constraint": {
    "enabled": true,
    "event_time": "2027-05-31T00:00:00Z",
    "reason": "Champions League final"
  }
}

{
  "ok": true,
  "outcome": "YES",
  "confidence": 0.78,
  "verdict": {
    "market_id": "mk_3f5b9c7e",
    "outcome": "YES",
    "confidence": 0.78,
    "resolution_time": "2025-01-15T10:31:00Z",
    "resolution_rule_id": "r1",
    "prompt_spec_hash": "0xabc123...",
    "evidence_root": "0xdef456...",
    "reasoning_root": "0x789ghi...",
    "justification_hash": "0xjkl012...",
    "selected_leaf_refs": ["ev_abc123", "ev_def456"],
    "metadata": {
      "strict_mode": false,
      "trace_id": "tr_xyz789",
      "justification": "Evidence strongly suggests BTC will exceed $100k ...",
      "llm_review": {
        "outcome": "YES",
        "confidence": 0.78,
        "reasoning_valid": true,
        "reasoning_issues": [],
        "confidence_adjustments": [],
        "final_justification": "The reasoning chain is sound ..."
      }
    }
  },
  "errors": []
}

Verdict {
  market_id, outcome, confidence
  resolution_time, resolution_rule_id
  prompt_spec_hash     hex hash
  evidence_root        hex Merkle root
  reasoning_root       hex Merkle root
  justification_hash   hex hash
  selected_leaf_refs[] evidence_id references
  metadata {
    strict_mode, trace_id, bundle_id
    bundle_count, step_count, conflict_count
    justification        human-readable string
    llm_review {
      outcome, confidence, resolution_rule_id
      reasoning_valid    boolean
      reasoning_issues[], confidence_adjustments[]
      final_justification
    }
  }
}

{
  "prompt_spec":      { ... },
  "evidence_bundles": [ ... ],
  "reasoning_trace":  { ... },
  "verdict":          { ... }
}

{
  "ok": true,
  "por_root": "0xba9ec9c2d4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3",
  "roots": {
    "prompt_spec_hash": "0xabc123...",
    "evidence_root":    "0xdef456...",
    "reasoning_root":   "0x789ghi...",
    "por_root":         "0xba9ec9c2..."
  },
  "por_bundle": {
    "schema_version": "1.0",
    "protocol_version": "1.0",
    "market_id": "mk_3f5b9c7e",
    "prompt_spec_hash": "0xabc123...",
    "evidence_root": "0xdef456...",
    "reasoning_root": "0x789ghi...",
    "verdict_hash": "0xjkl012...",
    "por_root": "0xba9ec9c2...",
    "verdict": { ... },
    "tee_attestation": null,
    "signatures": {},
    "created_at": "2025-01-15T10:31:05Z",
    "metadata": {
      "pipeline_version": "2.1.0",
      "mode": "live"
    }
  },
  "errors": []
}

PoRBundle {
  schema_version, protocol_version, market_id
  prompt_spec_hash   hex
  evidence_root      hex
  reasoning_root     hex
  verdict_hash       hex
  por_root           hex (master Merkle root)
  verdict            full Verdict object
  tee_attestation    null | object
  signatures         {}
  created_at, metadata { pipeline_version, mode }
}

roots {
  prompt_spec_hash   hex
  evidence_root      hex
  reasoning_root     hex
  por_root           hex
}

{
  "prompt_spec": { ... },
  "tool_plan":   { ... },
  "collectors":  ["CollectorOpenSearch"],
  "execution_mode": "development",
  "enable_quality_check": true,
  "max_quality_retries": 2
}

{
  "ok": true,
  "outcome": "YES",
  "confidence": 0.85,
  "por_root": "0xba9ec9c2...",
  "artifacts": {
    "evidence_bundles": [ ... ],
    "reasoning_trace": { ... },
    "verdict": { ... },
    "por_bundle": { ... }
  },
  "errors": []
}

{
  "user_input": "Highest temperature in Buenos Aires on March 1?",
  "strict_mode": true
}

{
  "ok": true,
  "classification": {
    "market_type": "TEMPERATURE",
    "confidence": 0.95,
    "detection_rationale": "Contains 'temperature', city name, and date"
  },
  "validation": {
    "checks_passed": ["U-02", "U-03", "TEMP-01"],
    "checks_failed": [
      {
        "check_id": "TEMP-04",
        "severity": "warning",
        "message": "No fallback data source specified.",
        "suggestion": "Add an alternative source if Wunderground is unavailable."
      }
    ]
  },
  "resolvability": {
    "score": 35,
    "level": "MEDIUM",
    "risk_factors": [
      { "factor": "Single data source with no fallback", "points": 30 }
    ]
  },
  "source_reachability": [
    { "url": "https://www.wunderground.com", "reachable": true, "status_code": 200, "error": null }
  ],
  "prompt_spec": { "..." : "..." },
  "tool_plan": { "..." : "..." },
  "errors": []
}

{
  "mode": "reasoning_only",
  "reason_code": "EVIDENCE_MISREAD",
  "message": "The evidence was misinterpreted",
  "target": {
    "artifact": "evidence_bundle",
    "leaf_path": "items[0].extracted_fields.outcome"
  },
  "prompt_spec": { ... },
  "evidence_bundle": { ... },
  "reasoning_trace": { ... }
}

{
  "ok": true,
  "case_id": null,
  "rerun_plan": ["audit", "judge"],
  "artifacts": {
    "prompt_spec": { ... },
    "evidence_bundle": { ... },
    "evidence_bundles": [ ... ],
    "reasoning_trace": { ... },
    "verdict": { ... }
  },
  "diff": {
    "steps_rerun": ["audit", "judge"],
    "verdict_changed": null
  }
}

{
  "reason_code": "EVIDENCE_MISREAD",
  "message": "Wikipedia shows PM Shmyhal announced a preliminary agreement on Feb 25 2025",
  "evidence_urls": [
    "https://en.wikipedia.org/wiki/Ukraine_US_Mineral_Agreement"
  ],
  "prompt_spec": { ... },
  "evidence_bundle": { ... },
  "reasoning_trace": { ... }
}

{
  "ok": true,
  "case_id": null,
  "rerun_plan": ["audit", "judge"],
  "artifacts": {
    "prompt_spec": { ... },
    "evidence_bundles": [ ... ],
    "reasoning_trace": { ... },
    "verdict": { "outcome": "YES", "confidence": 0.92, "..." : "..." }
  },
  "diff": {
    "steps_rerun": ["audit", "judge"],
    "verdict_changed": null
  }
}

curl -X POST 'https://interface.cournot.ai/play/polymarket/ai_data' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "YOUR_CODE",
    "post_data": "{}",
    "path": "/capabilities",
    "method": "GET"
  }'

{
  "providers": [
    { "provider": "openai", "default_model": "gpt-4o" },
    { "provider": "google", "default_model": "gemini-2.5-flash" },
    { "provider": "grok", "default_model": "grok-4-fast" }
  ],
  "steps": [
    {
      "name": "prompt",
      "agents": ["prompt-compiler-v2"],
      "description": "Compile market question into structured specification"
    },
    ...
  ]
}

// Gateway succeeds but step reports errors
{
  "code": 0,
  "msg": "Success",
  "data": {
    "result": "{
      \"ok\": false,
      \"errors\": [\"Timeout fetching source_coinmarketcap\"],
      \"evidence_bundles\": []
    }"
  }
}

// Recommended error handling pattern:
const gateway = await response.json();
if (gateway.code !== 0) {
  throw new Error(`Gateway error: ${gateway.msg}`);
}
const step = JSON.parse(gateway.data.result);
if (!step.ok) {
  console.warn("Step errors:", step.errors);
}