Coverage
What you get
| Item | Detail |
|---|---|
| Product code | CR-PREDICTION |
| Coverage | Event contracts on prediction market venues, starting with on-chain venues such as Polymarket |
| Granularity | One row per trade |
| History | From each market's opening until it resolves |
| Delivery | REST and WebSocket |
| Update speed | As trades happen |
An event contract pays 1 if an outcome happens and 0 if it doesn't. So its price, between 0 and 1, reads directly as the market's probability. A yes contract at 0.41 says the market puts 41% on that outcome, minus whatever premium traders demand for tying up money until resolution_time.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Our contract id: venue plus market plus outcome |
venue |
string | yes | e.g. polymarket |
market_id |
string | yes | Venue market id |
question |
string | yes | Plain-language question |
outcome |
string | yes | e.g. yes |
timestamp |
string | yes | Trade or quote time, ISO 8601 UTC |
price |
number | yes | 0 to 1, read as probability |
size |
number | optional | Contracts traded |
aggressor_side |
string | optional | buy or sell |
resolution_time |
string | optional | When the market settles |
Example record:
{
"symbol": "POLYMARKET-0x8f1a-YES",
"venue": "polymarket",
"market_id": "0x8f1a",
"question": "Will BTC close above $80,000 on 2026-12-31?",
"outcome": "yes",
"timestamp": "2026-11-19T14:31:52Z",
"price": 0.41,
"size": 1250,
"aggressor_side": "buy",
"resolution_time": "2026-12-31T23:59:59Z"
}
The market, its id and the price are invented for the example. This schema is our proposal, since neither seller we studied publishes a full field list.
Sample data
Sample data
No sample is available. Until the venue terms are clear, we won't hand out files, even small ones. Leave the markets you'd want on the request form.
Use cases
Use cases
Event odds next to price. Put the price of a crypto-price question next to our BTC bars. When the implied probability and the spot price disagree, one of them is likely to move.
News reaction speed. For a scheduled event like an economic release or a central bank decision, plot price by timestamp in the minutes after the announcement. It shows how quickly a market prices news compared with futures or FX.
Calibration testing. Collect resolved markets and bucket their prices a week before resolution_time. If contracts at 0.70 resolved yes about 70% of the time, the venue's odds were well calibrated.
Flow direction. Sum size by aggressor_side per hour. Persistent buying of yes while the price stays flat suggests someone is absorbing that flow on the other side.
Code
Code examples
Example: trades in one market with curl.
curl "https://api.marketdata.co/v1/crypto/predictions/trades?venue=polymarket&market_id=0x8f1a&outcome=yes" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, hourly implied probability with traded size.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/crypto/predictions/trades",
params={"venue": "polymarket", "market_id": "0x8f1a", "outcome": "yes",
"start": "2026-11-01", "end": "2026-11-19"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
tr = pd.DataFrame(resp.json()["results"])
tr["timestamp"] = pd.to_datetime(tr["timestamp"])
hourly = tr.set_index("timestamp").resample("1h").agg({"price": "last", "size": "sum"})
hourly["prob_pct"] = hourly["price"] * 100
print(hourly.dropna().tail(12))
Pricing
Pricing
Prediction market data is not offered at launch and has no price yet. It won't be sold as a dataset at first.
Of the vendors we studied, one lists plans from $79 to $599 a month that may include prediction markets; another starts at $650 a month, though which plan includes them isn't confirmed.
Side by side
How we compare
Only 2 of the 50 providers we studied carry prediction market data, and neither publishes the fields. If we add it, we'll publish the full schema up front, keep the question text on every row so files make sense on their own, and use the same timestamp, price and size names as our crypto trades.
FAQ
Frequently asked questions
How do I read the price?
As a probability. A price of 0.41 on a yes outcome means the market prices that outcome at about 41%.
Which venues will you cover?
We'd start with on-chain venues whose trades are public, such as Polymarket. Regulated US venues would need their own agreements.
What time zone are timestamps in?
UTC, for both timestamp and resolution_time.
What happens when a market resolves?
Trading stops and the winning outcome settles at 1, the losing one at 0. History stays available after resolution.
Is it real-time?
If we launch it, trades would stream over WebSocket as they happen, with REST for history.
Why isn't it available now?
The terms for redistributing venue data are unclear, and only two vendors sell it. We'll wait until we can license it properly.
Keep reading
Related
- Asset hub: Crypto
- Crypto: BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD
- Docs: API reference: crypto
- Learn: Choosing a market data provider