---
title: "Map Heat"
method: GET
path: "/api/v1/map/heat"
tags: ["map"]
---

# Map Heat

`GET /api/v1/map/heat`

## Request

- Base URL: `https://api.pdata.world`
- URL: `https://api.pdata.world/api/v1/map/heat`
- Auth: none declared

Use when you need a geographic snapshot of where prediction-market attention is concentrated. Returns per-country heat (capped news score, summed) for the current moment (`at=now`) or a past hour (`at=<ISO8601>`).

## Query parameters

- `at` string: 'now' (live cache) or an ISO-8601 timestamp for a past hourly frame.
- `source` string, nullable: Restrict to one source (only honored when at=now): polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.

## Response `200`

Successful Response

- MapHeatOut
  - `as_of` string, date-time, required
  - `at` string, required: 'now' or the resolved snapshot ISO timestamp.
  - `source` string, nullable
  - `reference` number, nullable: Display yardstick (p95 per-country heat, 30d).
  - `total_heat` number, required
  - `total_heat_avg_30d` number, nullable
  - `frame` MapHeatCountry[], required
    - `country` string, required
    - `heat_abs` number, required: Sum of capped per-market news scores for this country.
    - `intensity` number, required: heat_abs / rolling-30d reference, clamped to [0,1].
    - `total_markets` integer: Geo-tagged, non-excluded markets active in the trailing 24h.
    - `total_volume` number: Sum of lifetime market volume (USD).
    - `volume_24hr` number: Sum of 24h market volume (USD).
    - `top_markets` MapTopMarket[], required
      - `source` string, required
      - `market_id` string, required
      - `event_id` string, nullable
      - `title` string, nullable
      - `url` string, nullable: External source-platform URL for this market; None if unknown.
      - `delta_pp` number, required
      - `vol` number, required: Market 24h notional volume (USD).
      - `prob` number, nullable: Current implied probability (0-1); None if unknown.
      - `more` integer: Count of other moved markets in the same event (collapsed into this row).
  - `_meta` ResponseMetaList, required: Agent metadata for list/aggregate responses (no cite_as).
    - `attribution` string: Who aggregated this data, under which licence, and whose data it is.
    - `canonical_url` string, required: Stable URL for this resource: the pdata.world page, or the API URL for list responses.
    - `as_of` string, date-time: When this response was generated (UTC).
    - `docs` string: API documentation.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pdata/apis/pdata-backend.md) · [All operations](https://skmtc.dev/pdata/apis/pdata-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/pdata/apis/pdata-backend/revisions/4c9bf3856786?raw)