Authentication

Most data endpoints accept an API key in the X-API-Key header. Generate keys from your dashboard.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.probsights.com/v1/search/series?q=15m"

import requests

response = requests.get(
    "https://api.probsights.com/v1/search/series",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"q": "15m"},
)
print(response.json())

The interactive Try playground on each API reference page uses the same X-API-Key header. Paste your key once in the playground auth panel.

Public endpoints (no API key)

These routes do not require authentication:

Prefix	Examples
`/v1/search/**`	series, events, markets, recent listings
`/v1/whales/public/**`	public whale feed and event catalog

You can still send an API key on search routes — it identifies your account for dashboard usage tracking but does not change search results.

Protected endpoints (API key required)

Prefix	Examples
`/v1/historical/**`	Kalshi / Polymarket / unified orderbooks
`/v1/arbitrage/**`	cross-venue opportunities and price spreads
`/v1/whales/user/`, `/v1/whales/event/`, `/v1/whales/market/**`	personal watchlist, feed, stats
`/v1/trades`	live Kalshi / Polymarket trade proxy
`/v1/webhooks/**`	outbound whale and arbitrage webhook registration

Invalid or missing credentials on protected routes receive 401.

Endpoint access by plan

Endpoint group	Auth	Required plan	Notes
Search	Optional	—	Public; no key required
Public whale feed	Optional	—	Free preview; paid keys unlock full pool
Historical (general)	Required	Free	Bracket and non-interval markets
Historical (BTC/ETH Up/Down intervals)	Required	Pro+	Crypto interval orderbook history
Whale watchlist & user feed	Required	Free+	Tier caps tracked events (see below)
Arbitrage & price spreads	Required	Trader	`/v1/arbitrage/current` and `/v1/arbitrage/current/difference`
Webhooks (`whale`, `arbitrage`)	Required	Builder / Trader	One registration per type; see Webhooks

Requests that exceed your plan’s endpoint access receive 403.

Whale tracked-event limits

Tier	Max tracked events
Free	1
Pro / Builder	10
Trader	15

Historical data depth

Paid tiers can request deeper history for crypto interval markets. Free tier requests to BTC/ETH Up/Down interval orderbooks are rejected with 403. Keep your API key confidential. Do not expose it in client-side code or public repositories.

Getting started

Search

Historical

Arbitrage

Whales

Webhooks

Public endpoints (no API key)

Protected endpoints (API key required)

Endpoint access by plan

Whale tracked-event limits

Historical data depth

​Public endpoints (no API key)

​Protected endpoints (API key required)

​Endpoint access by plan

​Whale tracked-event limits

​Historical data depth

Public endpoints (no API key)

Protected endpoints (API key required)

Endpoint access by plan

Whale tracked-event limits

Historical data depth