---
title: "Page official forecast vintages from one publisher"
method: GET
path: "/v1/predictions/{currency}"
tags: ["predictions"]
---

# Page official forecast vintages from one publisher

`GET /v1/predictions/{currency}`

## Request

- Base URL: `https://api.fxmacrodata.com`
- URL: `https://api.fxmacrodata.com/v1/predictions/{currency}`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

Read one explicitly named source; bare currency listings stay disabled.

This path never fans out to announcement indicators. Native variables,
publication precision and horizons remain those of the publisher.

## Path parameters

- `currency` string, required

## Query parameters

- `prediction_source` string, nullable: Required publisher identifier for source-scoped native forecast history.
- `prediction_class` 'compiled_consensus' | 'forecaster_survey' | 'expectations_survey' | 'market_implied' | 'model_nowcast' | 'central_bank_projection' | 'institutional_projection' | 'fxmacrodata', nullable
- `statistic` string, nullable
- `respondent_population` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `variable` string, nullable
- `target_period` string, nullable
- `publication_precision` 'exact' | 'date' | 'unknown', nullable
- `before_id` string, nullable
- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api.md) · [All operations](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/revisions/fadaa543b154?raw)