---
title: "Daily / weekly / monthly FX bars for a currency pair (on-demand materialization)"
method: GET
path: "/v1/macro/forex-history"
---

# Daily / weekly / monthly FX bars for a currency pair (on-demand materialization)

`GET /v1/macro/forex-history`

## Query parameters

- `from` string, required
- `to` string, required
- `interval` 'daily' | 'weekly' | 'monthly'

## Response `200`

object payload

## Other responses

- `400` — validation error
- `401` — authentication error
- `402` — subscription paused
- `403` — scope insufficient
- `429` — rate limited or quota exhausted

---

[API](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api.md) · [All operations](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yehangshe/gex-heatmap-data-api/revisions/0068cd24c191/schema)