Quickstart

Everything here works against the public API. If you prefer to paste into a terminal as you read, have $DP_API_KEY in your shell before you start.

curl -X POST https://api.dotprediction.io/v1/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name": "Your Name", "email": "you@example.com", "password": "correct-horse-battery-staple"}'

The response sets a JWT cookie so the next call is already authenticated. Prefer the dashboard? Sign up at dotprediction.com instead.

Create a key

curl -X POST https://api.dotprediction.io/v1/api/auth/api-keys \
  -H "Content-Type: application/json" \
  -b "jwt=YOUR_SESSION_COOKIE" \
  -d '{"name": "my-first-key"}'

The key in the response is shown once — save it. Every request below sends it as X-API-Key.

Fetch markets

curl https://api.dotprediction.io/v1/api/markets?provider=polymarket&limit=5 \
  -H "X-API-Key: $DP_API_KEY"

import os, requests

r = requests.get(
    "https://api.dotprediction.io/v1/api/markets",
    params={"provider": "polymarket", "limit": 5},
    headers={"X-API-Key": os.environ["DP_API_KEY"]},
)
r.raise_for_status()
for m in r.json()["data"]:
    print(m["title"], "→", m["yes_price"])

const res = await fetch(
  "https://api.dotprediction.io/v1/api/markets?provider=polymarket&limit=5",
  { headers: { "X-API-Key": process.env.DP_API_KEY } },
);
const { data } = await res.json();
console.table(data.map(m => ({ title: m.title, yes: m.yes_price })));

Watch an orderbook

curl "https://api.dotprediction.io/v1/api/markets/KXCLIMATE-26/orderbook?provider=kalshi" \
  -H "X-API-Key: $DP_API_KEY"

Normalized bid/ask depth with canonical float prices — same shape on every venue.

What’s next

Authentication — JWT vs API keys, and when to use each.
Platforms — how Kalshi and Polymarket map onto our unified schema.
Pagination — cursor-based, bypassing the cache when you want fresh data.

Questions or something missing? Email support@dotprediction.com or open an issue on GitHub.

AuthenticationHow to authenticate with the Dot Prediction API.

Overview

Guides

API Reference

What’s next

​What’s next

What’s next