KosmoKrator

data

ExchangeRate CLI for AI Agents

Use the ExchangeRate CLI from KosmoKrator to call ExchangeRate tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

ExchangeRate CLI Setup

ExchangeRate can be configured headlessly with `kosmokrator integrations:configure exchangerate`.

Install, configure, and verify 
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure exchangerate --enable --read allow --write ask --json
kosmokrator integrations:doctor exchangerate --json
kosmokrator integrations:status --json

Credentials

Authentication type: No credentials none. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

No credentials are required.

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call 
kosmo integrations:call exchangerate.exchangerate_list_currencies '{"query":"example_query"}' --json
Provider shortcut 
kosmo integrations:exchangerate exchangerate_list_currencies '{"query":"example_query"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands 
kosmo integrations:docs exchangerate --json
kosmo integrations:docs exchangerate.exchangerate_list_currencies --json
kosmo integrations:schema exchangerate.exchangerate_list_currencies --json
kosmo integrations:search "ExchangeRate" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

exchangerate.exchangerate_list_currencies

List all available currencies (fiat, crypto, precious metals, stablecoins). Supports 340+ assets. Optionally filter by name or code.

Read read
Parameters
query
Generic call 
kosmo integrations:call exchangerate.exchangerate_list_currencies '{"query":"example_query"}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_list_currencies '{"query":"example_query"}' --json

exchangerate.exchangerate_popular_currencies

Show the most commonly used currency codes (no API call needed). Use these codes directly with exchangerate_convert_currency. Popular codes: {$popular}

Read read
Parameters
none
Generic call 
kosmo integrations:call exchangerate.exchangerate_popular_currencies '{}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_popular_currencies '{}' --json

exchangerate.exchangerate_convert_currency

Convert an amount from one currency to another. Supports 340 fiat currencies, cryptocurrencies, and precious metals. Common codes: usd, eur, gbp, jpy, cny, chf, cad, aud, btc, eth, sol, xau, xag.

Read read
Parameters
from, to, amount, date
Generic call 
kosmo integrations:call exchangerate.exchangerate_convert_currency '{"from":"example_from","to":"example_to","amount":"example_amount","date":"example_date"}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_convert_currency '{"from":"example_from","to":"example_to","amount":"example_amount","date":"example_date"}' --json

exchangerate.exchangerate_pair_rate

Get the direct exchange rate for one currency pair using the upstream pair endpoint. Supports latest and historical dates.

Read read
Parameters
from, to, date
Generic call 
kosmo integrations:call exchangerate.exchangerate_pair_rate '{"from":"example_from","to":"example_to","date":"example_date"}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_pair_rate '{"from":"example_from","to":"example_to","date":"example_date"}' --json

exchangerate.exchangerate_rates

Get all exchange rates for a base currency. Optionally filter to specific target currencies. Supports 340 fiat currencies, cryptocurrencies, and precious metals.

Read read
Parameters
base, date, currencies
Generic call 
kosmo integrations:call exchangerate.exchangerate_rates '{"base":"example_base","date":"example_date","currencies":"example_currencies"}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_rates '{"base":"example_base","date":"example_date","currencies":"example_currencies"}' --json

exchangerate.exchangerate_history

Compare a currency pair across multiple dates to see rate changes over time. Returns each date's rate and the overall change.

Read read
Parameters
from, to, dates
Generic call 
kosmo integrations:call exchangerate.exchangerate_history '{"from":"example_from","to":"example_to","dates":"example_dates"}' --json
Shortcut 
kosmo integrations:exchangerate exchangerate_history '{"from":"example_from","to":"example_to","dates":"example_dates"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

exchangerate.exchangerate_list_currencies 1 parameters
Schema command 
kosmo integrations:schema exchangerate.exchangerate_list_currencies --json
ParameterTypeRequiredDescription
query string no Filter currencies by code or name (e.g. "dollar", "btc", "gold").
exchangerate.exchangerate_convert_currency 4 parameters
Schema command 
kosmo integrations:schema exchangerate.exchangerate_convert_currency --json
ParameterTypeRequiredDescription
from string yes Source currency code (e.g. "usd", "btc", "xau").
to string yes Target currency code (e.g. "eur", "jpy").
amount string no Amount to convert (default: "1").
date string no Date for the rate (default: "latest"). Format: "YYYY-MM-DD" or "latest".
exchangerate.exchangerate_pair_rate 3 parameters
Schema command 
kosmo integrations:schema exchangerate.exchangerate_pair_rate --json
ParameterTypeRequiredDescription
from string yes Source currency code (e.g. "usd", "btc", "xau").
to string yes Target currency code (e.g. "eur", "jpy").
date string no Date for the rate (default: "latest"). Format: "YYYY-MM-DD" or "latest".
exchangerate.exchangerate_rates 3 parameters
Schema command 
kosmo integrations:schema exchangerate.exchangerate_rates --json
ParameterTypeRequiredDescription
base string yes Base currency code (e.g. "usd", "btc").
date string no Date for rates (default: "latest"). Format: "YYYY-MM-DD" or "latest".
currencies string no Comma-separated currency codes to filter (e.g. "eur,gbp,jpy"). Shows popular currencies if omitted.
exchangerate.exchangerate_history 3 parameters
Schema command 
kosmo integrations:schema exchangerate.exchangerate_history --json
ParameterTypeRequiredDescription
from string yes Source currency code (e.g. "usd", "btc", "xau").
to string yes Target currency code (e.g. "eur", "jpy").
dates string yes Comma-separated dates to compare (e.g. "2026-01-01,2026-02-01,2026-02-20").

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.