# Treasury Fiscal Data Exchange Rates API

> US Treasury reporting rates of exchange: the exchange rate of each country's currency against the US dollar, with country, currency, record date and effective date.

- Page: https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/
- Contract (JSON): https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/contract.json
- Source: api.fiscaldata.treasury.gov (https://api.fiscaldata.treasury.gov/)
- Category: Public data
- Updated: 2026-11-20

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `currency` | string | `Dollar` |
| `country` | string | `Canada` |
| `country_currency_desc` | string | `Canada-Dollar` |
| `effective_date` | string | `2026-09-30` |
| `exchange_rate` | string | `1.418` |
| `record_calendar_day` | string | `30` |
| `record_calendar_month` | string | `09` |
| `record_calendar_quarter` | string | `3` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/contract.json

## Inputs

- `sort` (string): Optional. Filters by sort. Choose one or more. Default: -record_date. Options: -record_date, record_date.
- `country` (string \| array of string): Optional. The exact value of the source's "country" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.
- `currency` (string \| array of string): Optional. The exact value of the source's "currency" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.
- `record_date_from` (string): Optional. Lowest value of the source's "record_date" field to keep (inclusive), written as the records write it (for example 2024-01-01). Omit it to leave this side open.
- `record_date_to` (string): Optional. Highest value of the source's "record_date" field to keep (inclusive), written as the records write it (for example 2024-12-31). Omit it to leave this side open.
- `effective_date_from` (string): Optional. Lowest value of the source's "effective_date" field to keep (inclusive), written as the records write it (for example 2024-01-01). Omit it to leave this side open.
- `effective_date_to` (string): Optional. Highest value of the source's "effective_date" field to keep (inclusive), written as the records write it (for example 2024-12-31). Omit it to leave this side open.
- `exchange_rate_min` (string): Optional. Lowest value of the source's "exchange_rate" field to keep (inclusive), written as the records write it (for example 0). Omit it to leave this side open.
- `exchange_rate_max` (string): Optional. Highest value of the source's "exchange_rate" field to keep (inclusive), written as the records write it (for example 0). Omit it to leave this side open.
- `record_fiscal_year` (string \| array of string): Optional. The exact value of the source's "record_fiscal_year" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.
- `record_fiscal_quarter` (string \| array of string): Optional. The exact value of the source's "record_fiscal_quarter" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "country": "Canada"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-19

The same changelog, as data, is in https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_c2a79885d6c82dcd59fb439a`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Treasury.
