Skip to content
Eden Engine

U.S. Treasury Reporting Rates of Exchange (Official Quarterly Currency Rates)

fiscaldata/exchange-rates

The official foreign-currency exchange rates the U.S. Treasury publishes each quarter for federal reporting: how many units of a country's currency equal one U.S. dollar, for about 170 country-currency pairs, back to March 2001. Newest quarter first: filter to one currency or a date range for its history, or take the latest quarter's rates for every currency. These are quarterly reporting rates, not live market rates. Taken directly from the U.S. Treasury's Fiscal Data API (Treasury Reporting Rates of Exchange).

activeper callv1

Price

$0.00273 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

U.S. Department of the Treasury (Fiscal Data)

Data from the U.S. Department of the Treasury, Bureau of the Fiscal Service (Fiscal Data, fiscaldata.treasury.gov), offered without restriction per fiscaldata.treasury.gov/api-documentation.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "fiscaldata/exchange-rates" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "fiscaldata/exchange-rates" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "fiscaldata/exchange-rates", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "fiscaldata/exchange-rates", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00273
Updated
Oct 18, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "description": "Which page of `limit` rows to return, starting at 1. A page past the last one is an error; meta.total-pages says how many there are."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "How many rows to return, newest quarter first, 1 to 1000. One quarter holds about 170 currencies, so 200 returns every currency for the latest quarter."
    },
    "filter": {
      "type": "string",
      "default": "",
      "maxLength": 500,
      "description": "Optional Fiscal Data filter: field:operator:value terms separated by commas, all of which must hold. Fields: country_currency_desc (the pair, for example Canada-Dollar or Japan-Yen), country, currency, record_date (the quarter end, YYYY-MM-DD) and exchange_rate. Operators: eq, lt, lte, gt, gte, in (a parenthesised list). Examples: country_currency_desc:eq:Canada-Dollar, country_currency_desc:in:(Canada-Dollar,Mexico-Peso),record_date:gte:2024-01-01, record_date:eq:2026-09-30. Leave empty for no filter. A value that matches nothing returns an empty list; an unknown field or operator is a validation error."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "record_date",
          "country",
          "currency",
          "country_currency_desc",
          "exchange_rate",
          "effective_date"
        ],
        "properties": {
          "country": {
            "type": "string",
            "description": "The country, for example Canada."
          },
          "currency": {
            "type": "string",
            "description": "The currency's name, for example Dollar."
          },
          "record_date": {
            "type": "string",
            "description": "The quarter end the rate is for, YYYY-MM-DD."
          },
          "exchange_rate": {
            "type": "string",
            "description": "Units of this currency per one U.S. dollar, as a decimal string (for example 1.418 for Canada-Dollar means 1.418 Canadian dollars to one U.S. dollar)."
          },
          "effective_date": {
            "type": "string",
            "description": "The date the rate takes effect, YYYY-MM-DD."
          },
          "country_currency_desc": {
            "type": "string",
            "description": "Country and currency together, for example Canada-Dollar; the usual filter key."
          }
        },
        "additionalProperties": true
      },
      "description": "One row per country-currency pair per quarter. Empty when nothing matches."
    },
    "meta": {
      "type": "object",
      "required": [
        "count",
        "total-count",
        "total-pages"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "How many rows this page holds."
        },
        "labels": {
          "type": "object",
          "description": "Human-readable name of each column."
        },
        "dataTypes": {
          "type": "object",
          "description": "The Treasury's type name for each column."
        },
        "dataFormats": {
          "type": "object",
          "description": "The Treasury's display format for each column."
        },
        "total-count": {
          "type": "integer",
          "description": "How many rows match the filter in all, across every page."
        },
        "total-pages": {
          "type": "integer",
          "description": "How many pages of `limit` rows the whole match makes."
        }
      },
      "additionalProperties": true
    },
    "links": {
      "type": "object",
      "description": "Treasury's own self, first, prev, next and last page links."
    }
  },
  "description": "The Treasury's response: the rate rows, newest quarter first, and a meta block with the match count.",
  "additionalProperties": true
}