Global Locale · atomic

Live foreign-exchange rates for a base currency with optional amount conversion

GET /v1/live-fx-rates on geo.caelaralabs.com

$0.005USDC per call
GETatomic tier
0 / 3Required params
Parameters

Request parameters

NameInTypeRequiredDescription
basequerystringnoBase currency ISO 4217 (default USD)
symbolsquerystringnoComma list of target currencies (default major set)
amountquerynumbernoAmount of the base currency to convert
cURL

Call it with an API key

Send your key as X-Caelara-Key. Responses are JSON; when an upstream source is unavailable the API still answers HTTP 200 with "partial": true instead of a server error.

curl -s "https://geo.caelaralabs.com/v1/live-fx-rates" \ -H "X-Caelara-Key: $CAELARA_KEY"
MCP

Use it as an MCP tool

Tool name live_fx_rates on the remote server https://geo.caelaralabs.com/mcp (registry ID com.caelaralabs/geo). MCP tool calls need an X-Caelara-Key API key; to pay per call in USDC, use the direct HTTP route in the x402 section below.

{ "mcpServers": { "caelara-geo": { "type": "http", "url": "https://geo.caelaralabs.com/mcp", "headers": { "X-Caelara-Key": "${CAELARA_KEY}" } } } }
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "live_fx_rates", "arguments": {} } }
x402

Pay per call in USDC on Base

No account needed. An unauthenticated request returns HTTP 402 with an X-Payment-Required: x402 header and a JSON body whose accepts entry carries scheme exact, network base, maxAmountRequired 5000 (0.005 USDC, 6 decimals), the USDC asset and the payTo address. Settlement happens only after a successful response.

# 1. Unpaid call: HTTP 402 with header X-Payment-Required: x402 curl -si "https://geo.caelaralabs.com/v1/live-fx-rates" # 2. Pay 0.005 USDC (5000 atomic units) on Base mainnet # asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 # payTo see the 402 response: accepts[0].payTo # 3. Retry with the signed payment payload curl -s "https://geo.caelaralabs.com/v1/live-fx-rates" \ -H "X-PAYMENT: $X402_PAYMENT_B64"