Skip to main content
Glama

get_live_fx_rates

Read-onlyIdempotent

utilpeek: Use when an agent needs on-chain EUR/GBP/MXN/BRL/CAD/SGD/ZAR/IDR vs USD or exchange quotes for 8 pairs, not ECB. For the ECB fix or a past date use get_fx_rates. Returns on-chain FX bid/ask/mid with ECB deviation_pct; indicative quotes from a regulated exchange for EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, EURGBP, EURJPY (exchange_quotes). USDCHF/EURGBP/EURJPY exchange-only; USDCAD also on-chain. Matching gap_pct in exchange_gaps. Indicative, not dealable or synchronized arbitrage. Pools cached 15 s; thin/errors reported. Exchange cache 60 s; stale=true data kept at most 300 s. as_of/age_s: fetch age, not venue age; venue_timestamp null. Exchange-only empty: 503 exchange_unavailable (not charged). Unknown pair: 422 (not charged). Typically 2 to 4 s (two chain reads). Price: USD 0.002. Free: 10 utilpeek calls per IP per UTC day. Docs: https://tanod.dev/learn/live-fx-rates-api.html

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_live_fx_rates"
  }
}

Input Schema

NameRequiredDescriptionDefault
pairsNoPairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair. Exchange quotes cover EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, EURGBP and EURJPY. USDJPY, AUDUSD, USDCHF, EURGBP and EURJPY are exchange-only; EURUSD, GBPUSD and USDCAD also have configured on-chain pools. An unknown pair is a 422 that lists the supported ones.
amount_usdNoReference trade size in USD for the price-impact measurement, 100 to 100000 (default 1000). A pair whose impact at this size is 1% or more is listed under `thin`.

Output Schema

NameRequiredDescriptionDefault
thinNo
blockNo
chainNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
pairsNo
cachedNo
errorsNo
methodNo
licenceNo
small_usdNo
timestampNo
amount_usdNo
disclaimerNo
indicativeNo
exchange_gapsNo
exchange_noteNo
exchange_quotesNo
exchange_omittedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • removedInput schema / properties / amount_usd / default
      Removed value: -null
    • removedInput schema / properties / amount_usd / title
      Removed value: -"Amount Usd"
    • removedInput schema / properties / pairs / default
      Removed value: -null
    • removedInput schema / properties / pairs / title
      Removed value: -"Pairs"
    • removedInput schema / title
      Removed value: -"get_live_fx_ratesArguments"
    • removedOutput schema / properties / errors / items
      Removed value: -{
      -  "properties": {
      -    "code": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "message": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / exchange_gaps / items
      Removed value: -{
      -  "properties": {
      -    "exchange_age_s": {
      -      "maximum": 300,
      -      "minimum": 0,
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "exchange_as_of": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "exchange_mid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "exchange_stale": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "gap_pct": {
      -      "description": "(onchain_mid / exchange_mid - 1) * 100; not synchronized.",
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "onchain_mid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "onchain_timestamp": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / exchange_omitted / items
      Removed value: -{
      -  "properties": {
      -    "code": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "reason": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "spread_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / exchange_quotes / items
      Removed value: -{
      -  "properties": {
      -    "age_s": {
      -      "description": "Seconds since fetch, not venue quote age.",
      -      "maximum": 300,
      -      "minimum": 0,
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "as_of": {
      -      "description": "Fetch-window start, not a venue timestamp.",
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "ask": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "base": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "bid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "mid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "quote": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "source": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "spread_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "stale": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "venue_timestamp": {
      -      "description": "Null when not supplied by the ticker.",
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / pairs / items
      Removed value: -{
      -  "properties": {
      -    "ask": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "base": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "bid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "block": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "buy_leg_block": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "buy_leg_timestamp": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "deviation_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "ecb": {
      -      "properties": {
      -        "date": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "error": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "rate": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "stale": {
      -          "type": [
      -            "boolean",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "fee_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "fee_tier": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "mid": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pool": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pools_quoted": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "price_impact_buy_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "price_impact_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "price_impact_sell_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "quote": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "quoter": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "reference_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "small_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "spread_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "stablecoin": {
      -      "properties": {
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "decimals": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "symbol": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "timestamp": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "venue": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / thin / items
      Removed value: -{
      -  "properties": {
      -    "amount_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "pair": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "pool": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "price_impact_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "reason": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "researched": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "stablecoin": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "token": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "usdc_in_pool": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "venue": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
  2. Changed1 schema field changed
    • changedInput schema / properties / pairs / description
      Previous value: -"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair; USDJPY and AUDUSD return exchange quotes only. USDCAD is on-chain only, with no exchange quote. An unknown pair is a 422 that lists the supported ones."New value: +"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair. Exchange quotes cover EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, EURGBP and EURJPY. USDJPY, AUDUSD, USDCHF, EURGBP and EURJPY are exchange-only; EURUSD, GBPUSD and USDCAD also have configured on-chain pools. An unknown pair is a 422 that lists the supported ones."
  3. Changed8 schema fields changed
    • changedInput schema / properties / pairs / description
      Previous value: -"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair; USDJPY and AUDUSD return indicative exchange quotes only. An unknown pair is a 422 that lists the supported ones."New value: +"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair; USDJPY and AUDUSD return exchange quotes only. USDCAD is on-chain only, with no exchange quote. An unknown pair is a 422 that lists the supported ones."
    • addedOutput schema / properties / exchange_gaps
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "exchange_age_s": {
      +        "maximum": 300,
      +        "minimum": 0,
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "exchange_as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exchange_mid": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exchange_stale": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "gap_pct": {
      +        "description": "(onchain_mid / exchange_mid - 1) * 100; not synchronized.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "onchain_mid": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "onchain_timestamp": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pair": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": [
      +      "object",
      +      "null"
      +    ]
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / exchange_quotes / items / properties / age_s / description
      Added value: +"Seconds since fetch, not venue quote age."
    • addedOutput schema / properties / exchange_quotes / items / properties / age_s / maximum
      Added value: +300
    • addedOutput schema / properties / exchange_quotes / items / properties / age_s / minimum
      Added value: +0
    • addedOutput schema / properties / exchange_quotes / items / properties / as_of / description
      Added value: +"Fetch-window start, not a venue timestamp."
    • addedOutput schema / properties / exchange_quotes / items / properties / stale
      Added value: +{
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / exchange_quotes / items / properties / venue_timestamp
      Added value: +{
      +  "description": "Null when not supplied by the ticker.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  4. Changed4 schema fields changed
    • changedInput schema / properties / pairs / description
      Previous value: -"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair; an unknown pair is a 422 that lists the supported ones."New value: +"Pairs in market convention, for example EURUSD (USD per EUR) or USDMXN (MXN per USD). Omit for every supported pair; USDJPY and AUDUSD return indicative exchange quotes only. An unknown pair is a 422 that lists the supported ones."
    • addedOutput schema / properties / exchange_note
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / exchange_omitted
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pair": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "spread_pct": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": [
      +      "object",
      +      "null"
      +    ]
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / exchange_quotes
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "age_s": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "as_of": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "ask": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "base": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "bid": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "mid": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pair": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "quote": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "source": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "spread_pct": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": [
      +      "object",
      +      "null"
      +    ]
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
  5. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources