API Documentation

Access prediction market data and cosmic analysis through our RESTful API

API Status: Operational
•
Base URL: https://api.predicttian.com

Authentication

All API requests require an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the API Pricing page.

GET/api/oracle/:marketId

Get cosmic analysis for a specific market

Parameters

marketId
stringrequired

Unique market identifier

Headers

AuthorizationBearer YOUR_API_KEYrequired

Example Request (cURL)

curl -X GET "https://api.predicttian.com/api/oracle/poly_12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "marketId": "poly_12345",
  "title": "Will Donald Trump win the 2024 US Presidential Election?",
  "probability": 0.65,
  "cosmicAnalysis": {
    "recommendation": "YES",
    "confidence": 85,
    "summary": "The celestial forces align strongly in favor of this outcome.",
    "methods": ["I Ching", "Tarot", "Qimen Dunjia"]
  }
}
GET/api/oracle

Get cosmic analysis for multiple markets with filters

Parameters

category
string

Filter by category (politics, crypto, sports, etc.)

source
string

Filter by source (polymarket, kalshi, etc.)

limit
number

Number of results (default: 20, max: 100)

Headers

AuthorizationBearer YOUR_API_KEYrequired

Example Request (cURL)

curl -X GET "https://api.predicttian.com/api/oracle" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "markets": [
    {
      "marketId": "poly_12345",
      "title": "...",
      "probability": 0.65,
      "cosmicRecommendation": "YES",
      "cosmicConfidence": 85
    }
  ],
  "total": 435,
  "page": 1
}
GET/api/cosmic/:marketId

Get detailed cosmic readings (I Ching, Tarot, Qimen Dunjia) for a market

Parameters

marketId
stringrequired

Unique market identifier

Headers

AuthorizationBearer YOUR_API_KEYrequired

Example Request (cURL)

curl -X GET "https://api.predicttian.com/api/cosmic/poly_12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "marketId": "poly_12345",
  "readings": [
    {
      "method": "i_ching",
      "data": {
        "hexagram": 14,
        "name": "Possession in Great Measure",
        "interpretation": "..."
      }
    }
  ]
}
GET/api/markets

Get raw market data without cosmic analysis

Parameters

category
string

Filter by category

source
string

Filter by source

status
string

Filter by status (open, closed, resolved)

limit
number

Number of results (default: 20, max: 100)

Headers

AuthorizationBearer YOUR_API_KEYrequired

Example Request (cURL)

curl -X GET "https://api.predicttian.com/api/markets" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "markets": [
    {
      "id": 123,
      "externalId": "poly_12345",
      "title": "...",
      "probability": "0.65",
      "volume": "$2.4M",
      "category": "politics",
      "source": "polymarket",
      "status": "open"
    }
  ],
  "total": 435
}

Rate Limits

Rate limits are enforced per API key and reset every minute. Exceeding your limit will result in a 429 response.

1/min
Free Tier
10/min
Builder Tier
60/min
Pro Tier
300/min
Enterprise Tier

Interactive API Playground

Test API endpoints directly in your browser. Enter your API key to make live requests.

TIAN Prediction API
 1.0.0 
OAS 3.0

/openapi.json

Access TIAN's cosmic intelligence predictions for prediction markets. Get AI-powered insights combining 8 ancient divination methods.

Servers

default

SDKs & Libraries

Official SDKs for popular languages are coming soon. For now, use standard HTTP clients to interact with the API.