# US Treasury Official Quarterly FX Rate

> US Treasury Official Quarterly FX Rate is a paid API for AI agents from treasury-macro.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns the US Treasury's official quarterly reporting exchange rate for a given country's currency, including the current rate, effective date, and prior quarters' history.

## Facts

- Endpoint: GET https://treasury-macro.x402tookit.com/treasury-fx-rate?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-treasury-official-quarterly-fx-rate-682264bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E-AcAs8HbiNAwK1mdCW2L

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-treasury-official-quarterly-fx-rate-682264bf
```

Example prompt: What is the US Treasury's official quarterly exchange rate for Japan, and how has it changed over the past few quarters?

## When to prefer this

Use this endpoint when you need the official US Treasury-sanctioned exchange rate for government financial reporting, compliance, or fiscal analysis — not a live market rate. It is ideal for scenarios requiring the rate the US government itself uses for quarterly reporting, with historical quarterly context. Prefer this over market FX APIs when official government sourcing and effective dates matter.

## Known failure modes

- Ambiguous country/currency fragment returns multiple matches or no match (otherMatches array populated)
- Country not found in Treasury data returns null rate and reasons array explaining the issue
- Upstream Treasury data temporarily unavailable may result in degraded=true response with partial data
- Malformed or empty query param returns validation error

## How this service works

US Treasury official quarterly reporting exchange rate for a country's currency, with effective date and prior quarters.

## Output

Returns the current official US Treasury quarterly reporting exchange rate for the requested country's currency (rate per USD), the effective date of that rate, a list of prior quarters' rates and dates, a summary, a verdict, attribution details, a source URL, and a disclaimer. May also include a 'degraded' flag if data quality is partial.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "country": {
       "type": "string",
       "description": "Country or currency fragment, e.g. Canada, Japan, Euro"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "history": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "rate": {
          "type": [
           "null",
           "number"
          ]
         },
         "effectiveDate": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "currency": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "ratePerUsd": {
       "type": [
        "null",
        "number"
       ]
      },
      "attribution": {
       "type": [
        "null",
        "string"
       ]
      },
      "otherMatches": {
       "type": [
        "array",
        "null"
       ]
      },

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-treasury-official-quarterly-fx-rate-682264bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from treasury-macro.x402tookit.com](https://www.zero.xyz/host/treasury-macro.x402tookit.com/llms.txt)