---
title: "Paid: Price History"
method: GET
path: "/api/x402/market-chart"
---

# Paid: Price History

`GET /api/x402/market-chart`

## Request

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

Historical price series for agents — pay $0.001 USDC per call. Pass ?id=<coingecko-id>&days=<1|7|30|90|365>. Returns a compact [[timestamp_ms, price_usd], …] array with upstream-chosen granularity (5-minutely for 1 day, hourly to 90 days, daily beyond). The coin id is supplied at runtime — the same series behind the three.ws/coin charts.

## Query parameters

- `id` string, required
- `days` string

## Response `200`

three.ws Market Data 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)