API

API Overview

The Caliber API lets you rate prediction market definitions, retrieve ratings, and access criteria metadata.

Base URL

https://api.caliberratings.xyz

Quick Example

Rate a market definition with a single POST request:

curl -X POST https://api.caliberratings.xyz/v0/ratings/markets \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Who won the 2026 Australian Grand Prix?",
    "answer_type": "string",
    "expected_results": ["Oscar Piastri", "Max Verstappen", "Lando Norris"],
    "comparison_operator": "==",
    "source_urls": [
      "https://www.formula1.com/en/results/2026/races/1279/australia/race-result",
      "https://racingnews365.com/2026-f1-australian-grand-prix-results"
    ],
    "min_agreement": 2,
    "resolution_start": "2026-03-23T00:00:00Z",
    "resolution_end": "2026-03-24T00:00:00Z"
  }'

Endpoints

POST/v0/ratings/markets

Rate a market definition

GET/v0/ratings/markets/{id}

Get a previously rated market by ID

GET/v0/ratings/markets/latest

List recent ratings with cursor pagination

GET/v0/ratings/bands

List all rating bands (Aaa to C) with score ranges

GET/v0/ratings/criteria

List rating criteria and their weights

GET/v0/ratings/bands/{bandId}/badge.svg

SVG badge for a rating band

GET/v0/ratings/markets/{id}/badge.svg

SVG badge for a rated market

OpenAPI Schema

The full OpenAPI specification is available at https://api.caliberratings.xyz/openapi.yaml. It defines all request/response schemas, validation rules, and endpoint details.