Orrery.
← All Stars

public Star · 0.1.0

orrery/fx-rate

Pinned FX rate for allowlisted currency pair and as-of date.

Use this when

  • You need an offline exchange rate for a quote join
  • You want sealed FX facts without a live market feed
  • You are composing money-light enrich context

Not for

  • Live market trading or checkout paths
  • Wallet ledger or payment processing
  • Arbitrary currency pair lookup

Inputs / Outputs

Inputs

NameTypeNotes
pair string allowlisted base-quote token (e.g. usd-eur)
as_of string pinned calendar date for fixture revision

Outputs

NameTypeNotes
base string ISO currency code for base leg
quote string ISO currency code for quote leg
rate number pinned exchange rate
provider string fixture attribution (orrery-fixtures)
envelope signed-envelope

Example

{
  "method": "tools/call",
  "params": {
    "name": "answer",
    "arguments": {
      "pair": "usd-eur",
      "as_of": "2026-06-01"
    }
  }
}

Tools

fx_rate Look up an allowlisted FX pair at a pinned as-of date · schema
{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "enum": [
        "eur-gbp",
        "eur-usd",
        "gbp-jpy",
        "usd-eur",
        "usd-gbp",
        "usd-jpy"
      ],
      "description": "Allowlisted base-quote token (e.g. usd-eur)."
    },
    "as_of": {
      "type": "string",
      "format": "date",
      "enum": [
        "2026-01-15",
        "2026-06-01",
        "2026-08-01"
      ],
      "description": "Pinned calendar date for the fixture revision."
    }
  },
  "required": [
    "pair",
    "as_of"
  ]
}
answer FX rate lookup with a concise answer sealed in an Envelope · schema
{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "enum": [
        "eur-gbp",
        "eur-usd",
        "gbp-jpy",
        "usd-eur",
        "usd-gbp",
        "usd-jpy"
      ],
      "default": "usd-eur"
    },
    "as_of": {
      "type": "string",
      "format": "date",
      "enum": [
        "2026-01-15",
        "2026-06-01",
        "2026-08-01"
      ],
      "default": "2026-06-01"
    }
  }
}

In constellations

No constellation references this Star yet.