---
title: "List public FX reference-rate pair universe"
method: GET
path: "/v1/fx/source-universe"
tags: ["fx_markets"]
---

# List public FX reference-rate pair universe

`GET /v1/fx/source-universe`

## Request

- Base URL: `https://api.fxmacrodata.com`
- URL: `https://api.fxmacrodata.com/v1/fx/source-universe`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

## Query parameters

- `currency` string: Optional currency filter, for example USD.
- `source` string: Optional source id filter, for example ecb_eurofxref_daily.

## Response `200`

Successful Response

- FxSourceUniverseResponse
  - `source_policy` FxSourcePolicy, required: Redistribution rules governing which rows the public endpoints serve.
    - `public_data_policy` string, nullable
    - `request_time_upstream_fetches` boolean, nullable: Whether serving a request contacts the upstream publisher. Always false: responses come from FXMacroData's collected dataset.
    - `value_field` string, nullable
    - `legacy_daily_forex_value_field` string, nullable
  - `currency` string, nullable
  - `source` string, nullable
  - `data` FxSourceUniverseEntry[], required
    - `source` FxSource: One official FX reference-rate source.
      - `id` string, nullable
      - `name` string, nullable
      - `authority_type` string, nullable
      - `country_or_area` string, nullable
      - `url` string, nullable
      - `attribution_text` string, nullable
      - `tier` string, nullable
      - `is_official` boolean, nullable
      - `is_aggregator` boolean, nullable
      - `default_timezone` string, nullable
      - `publication_frequency` string, nullable
      - `native_pairs` string[], nullable: Every pair the authority publishes, as documentation of the source. Not a list of requestable pairs; see served_pairs.
      - `native_pair_count` integer, nullable
      - `served_pairs` string[], nullable: The pairs from this source that the public FX endpoints serve. Only these pairs can be requested; a pair listed in native_pairs but not here returns no rows.
      - `served_pair_count` integer, nullable
      - `serves_public_data` boolean, nullable: True when at least one pair from this source is served by the public FX endpoints (served_pair_count > 0). False means the source is listed for provenance only and no data from it can be requested.
      - `coverage_note` string, nullable
      - `source_universe_endpoint` string, nullable
    - `pair_count` integer, nullable
    - `pairs` FxSourceUniversePair[], nullable
      - `pair` string, nullable
      - `availability` string, nullable
      - `anchor` string, nullable

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