Skip to content

Prediction Market Data API

GET/v1/predictiondata/markets/{market_id}/consensus

The real-money probability for one question (volume weighted across real-money venues) with any matched play-money venues shown beside it and not weighted in. Today the real-money side is the on-chain Polymarket price only; play-money matching arrives with the Manifold integration. Refreshes every 60 seconds.

Price

$0.015/ call

Edge cache

30s

Uptime 24h

100.00%

p95

2.88s

The Prediction Market Data API provides prediction market prices, implied probabilities, volumes, movers, resolutions, and history. Data is derived from public Polygon chain data. Access the API using USDC over x402 or an API key. The API offers a GET endpoint for cross-venue consensus, returning volume-weighted real-money probabilities and matched play-money venues. The data refreshes every 60 seconds.

Parameters

NameInTypeDescription
market_id* path string

Code

curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/predictiondata/markets/top/consensus"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/predictiondata/markets/top/consensus" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"
TypeScript · @x402/fetch
// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/predictiondata/markets/top/consensus")).json();
console.log(data);
Python · x402
# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests

session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/predictiondata/markets/top/consensus").json())
With an API key
curl "https://api.realtimeapi.ai/v1/predictiondata/markets/top/consensus" -H "X-API-Key: $RTAPI_KEY"

Frequently asked questions

What data does the API provide?

Prediction market prices, implied probabilities, volumes, movers, resolutions, and history.

How is the data derived?

From public Polygon chain data (Polymarket exchange contracts).

How can I access the API?

Using USDC over x402 or an API key.

What is the price of the API?

$0.015 per request.

How often is the data updated?

Every 60 seconds.

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.