---
title: "Paid: Market Heatmap"
method: GET
path: "/api/x402/market-heatmap"
---

# Paid: Market Heatmap

`GET /api/x402/market-heatmap`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/market-heatmap`
- Auth: none required

three.ws Market Heatmap — pay $0.002 USDC per call for a normalized snapshot of the top coins by market cap: rank, price, 1 h / 24 h / 7 d momentum, market cap, and 24 h volume per coin, plus market-breadth statistics (advancers vs decliners, average and median 24 h move) that tell an agent whether strength is broad or narrow. Dual live sources with automatic failover (CoinGecko primary, CoinPaprika fallback) so a single upstream rate-limit never breaks a paid call. Size the board with ?limit=1..100. Refreshed every 60 seconds; upstream outages refuse before settlement.

## Query parameters

- `limit` integer

## Response `200`

three.ws Market Heatmap result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)