---
title: "Oracle Endpoint"
method: POST
path: "/api/v1/predictions/market/oracle"
tags: ["Prediction Market Oracle"]
---

# Oracle Endpoint

`POST /api/v1/predictions/market/oracle`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/predictions/market/oracle`
- Auth: none declared

Get calibrated probability for a geophysical event question.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

Request body:
    {
        "category": "earthquake|volcano|tsunami|severe_weather|flood",
        "region": "california",           // earthquake
        "magnitude_threshold": 5.0,       // earthquake
        "time_horizon_days": 7,           // all categories
        "volcano": "popocatepetl",        // volcano
        "zone": "pacific_nw",             // tsunami
        "lat": 28.06,                     // severe_weather, flood
        "lon": -82.42                     // severe_weather, flood
    }

Returns calibrated probability, confidence interval, market formats
(Polymarket/Kalshi/Chainlink), current conditions, key factors,
and tamper-proof prediction hash.

## Query parameters

- `x_api_key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)