---
title: "Official financial prices and yield curves"
method: GET
path: "/v1/financial_prices/{currency}"
tags: ["monetary_policy"]
---

# Official financial prices and yield curves

`GET /v1/financial_prices/{currency}`

## Request

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

Official government and central-bank observations. Filter by source, issuer, instrument or measure. Separate nominal, real, par, zero, security quotes and auction observations by their dimensions. Source attribution and licence conditions accompany the data. Empty coverage means no observations are available yet.

## Path parameters

- `currency` string, required

## Query parameters

- `source` string, nullable
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `measure` string, nullable
- `instrument_id` string, nullable
- `issuer` string, nullable
- `limit` integer
- `offset` integer
- `api_key` string: Your Individual or Business API key

## Response `200`

Successful Response

- FinancialPriceResponse
  - `currency` string, required
  - `start_date` string, required
  - `end_date` string, required
  - `sources` FinancialSource[], required
    - `id` string, required
    - `currency` string, required
    - `publisher` string, required
    - `url` string, required
    - `license_url` string, nullable
    - `attribution` string, required
    - `frequency` string, nullable
    - `publication_frequency` string, nullable
    - `history_start` string, nullable
    - `measures` string[], required
    - `dataset_name` string, nullable
    - `license` string, nullable
    - `reuse_conditions` string, nullable
  - `coverage` FinancialCoverage[], required
    - `source_id` string, required
    - `available` boolean, required: Whether observations are available for this source; a listed source without observations is not yet available.
    - `first_observation` string, nullable
    - `last_observation` string, nullable
    - `last_updated` string, nullable
    - `source_accessed_at` string, nullable
  - `pagination` FinancialPagination, required
    - `limit` integer, required
    - `offset` integer, required
    - `returned_count` integer, required
    - `total_count` integer, required
    - `has_more` boolean, required
    - `next_offset` integer, nullable
  - `data` FinancialObservation[], required
    - `observation_id` string, required: Stable identity of the source, observation date, instrument and quote dimensions.
    - `source_id` string, required
    - `date` string, required: Source observation date; not an inferred publication date.
    - `val` number, required: Official numerical value in unit, retaining source precision.
    - `currency` string, required
    - `issuer` string, required: Issuer, official benchmark administrator, or explicitly identified market/curve basket.
    - `instrument_id` string, required
    - `instrument_name` string, nullable
    - `source_series_id` string, nullable
    - `measure` string, required
    - `unit` string, required
    - `source_url` string, required
    - `basis` string, nullable
    - `curve_type` string, nullable
    - `tenor` string, nullable
    - `maturity_years` number, nullable
    - `maturity_date` string, nullable
    - `price_side` string, nullable
    - `price_basis` string, nullable
    - `price_denominator` number, nullable
    - `coupon_rate` number, nullable
    - `quote_type` string, nullable
    - `yield_convention` string, nullable
    - `reference_rate` string, nullable
    - `inflation_index` string, nullable
    - `compounding` string, nullable
    - `averaging_period_months` number, nullable
    - `percentile` number, nullable
    - `publication_date` string, nullable
    - `source_publication_date` string, nullable
    - `source_value_date` string, nullable
    - `rate_period_start` string, nullable
    - `rate_period_end` string, nullable
    - `observation_period_start` string, nullable
    - `observation_period_end` string, nullable
    - `observation_status` string, nullable
    - `announcement_datetime` integer, nullable: Publication epoch seconds when available. A scheduled hour is explicitly assumed.
    - `publication_time_confirmed` boolean, required
    - `release_time_assumed` boolean, required
    - `point_in_time_safe` boolean, required: True only when the source supplied exact publication-time evidence.

## 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)