English Français العربية

Currency Converter API

السجل الرسمي المالية والمدفوعات

Fiat and crypto currency conversion — ECB + CoinGecko rates. x402 micropayment.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (sse)
Claude Code 
claude mcp add --transport sse currency-converter-api 'https://currency-converter.api.klymax402.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "currency-converter-api": {
            "type": "sse",
            "url": "https://currency-converter.api.klymax402.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Currency Converter API
  2. Quickstart -- MCP
  3. Quickstart -- HTTP (x402)
  4. Tools
  5. Example agent prompts
  6. Payment
  7. Part of klymax402
  8. License

Currency Converter API

Fiat and crypto currency converter -- ECB rates for fiat, CoinGecko for crypto. Instant cross-rate lookup. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "currency-converter": {
      "url": "https://currency-converter.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl -X POST "https://currency-converter.api.klymax402.com/api/convert" \
  -H "Content-Type: application/json" \
  -d '{"amount":"1","from":"...","to":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
finance_convert_currencyPOST/api/convert$0.003Convert between fiat currencies and cryptocurrencies
finance_convert_currency

Use this when you need to convert between any currencies -- both fiat (USD, EUR, GBP, JPY) and crypto (BTC, ETH, SOL). Returns conversion result in JSON.

Parameters

NameTypeRequiredDescription
amountnumberyesAmount to convert
fromstringyesSource currency code (e.g., USD, EUR, BTC, ETH)
tostringyesTarget currency code (e.g., EUR, GBP, USD, BTC)

Returns

  • convertedAmount -- the resulting amount in target currency
  • exchangeRate -- the rate used for conversion
  • from -- source currency code
  • to -- target currency code
  • amount -- original amount provided
  • rateSource -- data source used (ECB for fiat, CoinGecko for crypto)
  • timestamp -- when the rate was fetched

Example response:

{"convertedAmount":2815.40,"exchangeRate":0.9218,"from":"USD","to":"EUR","amount":3054.00,"rateSource":"ECB","timestamp":"2026-04-13T12:00:00Z"}

When to use: price conversions across fiat and crypto in a single call. Essential for international pricing, invoice generation, and portfolio valuation in local currency.

Not for: market data or charts (use finance_get_token_price), DeFi swap quotes (use dex_get_swap_quote), wallet balances (use wallet_get_portfolio).

Example agent prompts

  • "Convert between any currencies -- both fiat (USD, EUR, GBP, JPY) and crypto (BTC, ETH, SOL)"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

الأسئلة الشائعة

ما هو Currency Converter API؟

Fiat and crypto currency conversion — ECB + CoinGecko rates. x402 micropayment.

كيف أثبّت Currency Converter API؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse currency-converter-api 'https://currency-converter.api.klymax402.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Currency Converter API إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Currency Converter API مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Currency Converter API؟

ينشره Br0ski777. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.