Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

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 deviation vs ECB; 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

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only cover safety/idempotency; the description goes far beyond them with cache TTLs (pools 15 s, exchange 60 s, stale kept to 300 s), latency (~2-4 s), pricing and the free tier, and error contracts (422 unknown pair, 503 exchange-only empty, neither charged). It also discloses the most important caveat an agent could get wrong: quotes are indicative, not dealable, and as_of/age_s measures fetch age rather than venue age.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the use case and the sibling exclusion, and every clause carries information — caching, pricing, errors, caveats. The style is telegraphic and heavily semicolon-packed, which makes it harder to scan than a lightly structured version would be, but there is no filler to cut.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite two optional params, this is a data-fetch tool with caching, dual sourcing, and edge-case errors, and all of those are covered, including degraded-state signaling (thin/errors, stale=true, venue_timestamp null). With an output schema present, the description correctly spends no words explaining return payload shape.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real routing meaning: it lists which pairs are exchange-only (USDCHF/EURGBP/EURJPY) versus also on-chain (USDCAD), and ties amount_usd to the `thin` designation. It stops short of restating the pair-format syntax, which the schema already handles.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (live on-chain FX rates) and immediately scopes it: EUR/GBP/MXN/BRL/CAD/SGD/ZAR/IDR vs USD plus exchange quotes, explicitly "not ECB". It names the sibling get_fx_rates as the different tool, so an agent can separate the two without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Use when an agent needs on-chain ... not ECB. For the ECB fix or a past date use get_fx_rates" gives both the selecting condition and the explicit alternative. It also warns that exchange-only pairs can return empty and how that surfaces (503 exchange_unavailable), which further narrows correct usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.