splitwise_get_currencies
List Splitwise-accepted currency codes and units, optionally filtered by a substring, to check a code or find it from a symbol before setting expenses or defaults.
Instructions
List the currency codes Splitwise accepts, optionally filtered by a substring.
Calls GET /get_currencies once and caches the answer in-process for 24 h (the list is
static); refresh: true refetches. Codes are mostly ISO 4217 plus a few colloquial ones
(e.g. BTC); each comes with its display unit ($, S/, €).
When to Use:
To check that a currency code is accepted before using it as
currency_codeon an expense or as a user'sdefault_currency.To find a code from its symbol (
query: "€").
When NOT to Use:
For balances per currency — use
splitwise_get_balances.For categories — use
splitwise_get_categories.
Returns:
A markdown table of Code | Unit (capped at 50 rows; narrow with query), or the raw
{"currencies": [{currency_code, unit}]} objects when response_format is json.
Examples: params = {} params = {"query": "pen"} params = {"query": "eur", "response_format": "json"}
Error Handling: A 401 means the API key is missing or was regenerated. A failed fetch is never cached; a query that matches nothing says so instead of returning an empty table.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |