Home/API Access

TIAN Predict API

Programmatic access to TIAN's prediction signals, market data, and webhook delivery. One tier, no free access — 100,000 TIAN Points per month.

Endpoints

12+

REST + Webhooks

Rate Limit

60 / min

per API key

Price

100k pts

per 30 days

Endpoint Reference
All endpoints require an X-API-Key: tian_… header. Base URL: https://predict.asktian.com
GET
/api/v1/stats

Global overview — accuracy, daily volume, totalPointsConsumed

GET
/api/v1/stats/markets

Paginated market list with readingCount, confidence, sort options (trending | confidence | recent | volume | engagement)

GET
/api/v1/stats/markets/batch

Bulk market lookup by IDs (?ids=1,2,3) — includes pointsConsumed per market

POST
/api/v1/stats/markets/batch

Same as GET batch but accepts {"marketIds":[…]} body for large sets

GET
/api/v1/stats/market/:id

Single market detail — full reading history, latestReading, totalPointsConsumed

GET
/api/v1/predict/binary

Latest binary signal for a market (?marketId=… or ?slug=…)

GET
/api/v1/predict/multi

Latest multi-outcome signal with ranked options

GET
/api/v1/predict/poll

Cursor-based polling for new readings since a timestamp

GET
/api/v1/webhooks

List your registered webhook subscriptions

POST
/api/v1/webhooks

Register a new webhook URL (event: reading.created)

DELETE
/api/v1/webhooks/:id

Remove a webhook subscription

POST
/api/v1/webhooks/:id/test

Fire a test delivery to verify your endpoint

Who Is This For?

Trading Bots

Subscribe to webhook push and act on TIAN signals the moment a new reading is created — no polling lag.

Analytics Dashboards

Pull the full reading history and confidence scores for any market to build your own visualisations and accuracy tracking.

Research & Backtesting

Use the paginated markets list with sort=engagement to find the most-analysed markets and backtest TIAN's historical edge.

Aggregators

Batch-fetch signals for hundreds of markets in a single request and surface TIAN picks alongside other data sources.

Quick Start
Replace YOUR_API_KEY with the key from your active subscription below.
curl -s https://predict.asktian.com/api/v1/predict/binary \
  -G --data-urlencode "slug=will-the-us-enter-a-recession" \
  -H "X-API-Key: YOUR_API_KEY" | jq .

The binary endpoint returns pick (the TIAN-favoured outcome) and confidence (0–100). Use /api/v1/predict/multi for markets with more than two outcomes.

Connect your wallet to subscribe

You need a Privy wallet to pay with TIAN Points.

API Reference
All endpoints require X-API-Key: tian_... header.
GET/api/v1/signals

High-confidence TIAN signals for live binary markets. Ideal for trading bots.

Params: minConfidence, minEdge, limit, category, marketType

GET/api/v1/stats/market/:id

Full market detail — all readings, confidence history, and market odds.

Params: id (DB id or polymarketSlug)

POST/api/v1/webhooks

Register a webhook URL to receive reading.created events in real time.

Params: url, label, events, secret

GET/api/v1/webhooks/poll

Polling fallback — returns all readings since a given timestamp.

Params: since (ISO 8601 or Unix ms)

POST/api/v1/webhooks/:id/test

Fire a test payload to a registered webhook URL to verify your receiver is correctly configured. Returns delivery status, HTTP status code, latency, and the test payload sent. The delivery is logged in the webhook delivery history.

Params: id (webhook subscription id from POST /api/v1/webhooks)

Base URL: https://predict.asktian.com

Webhook Integration Guide
Register a URL, receive signed payloads, and verify deliveries.

1. Register your endpoint

POST /api/v1/webhooks X-API-Key: tian_… { "url": "https://your-server.com/webhook", "events": "reading.created", "secret": "your-signing-secret" }

The response includes the subscription id — save it to fire test deliveries.

2. Verify with a test delivery

POST /api/v1/webhooks/:id/test X-API-Key: tian_…

Fires a [TEST] payload to your registered URL and returns success, statusCode, latencyMs, and the full payload sent. The delivery is also written to your webhook delivery log.

3. Verify the HMAC signature

Every delivery (including test deliveries) includes an X-Signature-256 header. Validate it on your server before processing the payload:

// Node.js example const sig = req.headers['x-signature-256']; const expected = 'sha256=' + crypto.createHmac('sha256', YOUR_SECRET) .update(rawBody) .digest('hex'); if (sig !== expected) return res.status(401).end();

Test delivery response shape

{ "success": true, "deliveryId": "a3f…", "statusCode": 200, "latencyMs": 142, "responseBody": "OK", "error": null, "payload": { "event": "reading.created", "test": true, "question": "[TEST] Will this webhook delivery succeed?", … } }
What's Included

Signal Feed

High-confidence picks filtered by edge vs market

Market Data

Full reading history, confidence scores, system breakdowns

Webhooks

Real-time push on every new TIAN reading

Polling

Fallback polling endpoint with cursor pagination

HMAC Signatures

SHA-256 signed payloads for webhook verification

Hourly Updates

Readings refreshed every hour via live sync