Skip to main content
CurrencyScoop logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: CURRENCYSCOOP
  • Version: 20261101_00

Tools

Slug: CURRENCYSCOOP_CONVERT_CURRENCY2Convert a positive amount from one currency to another using real-time or historical exchange rates, optionally specifying a date for historical rates.

Input Parameters

string
required
The 3-letter currency code to convert to (e.g., EUR, USD, JPY).
string
Optional date for historical conversion in YYYY-MM-DD format. If omitted, uses current real-time rates.
string
required
The 3-letter currency code to convert from (e.g., USD, EUR, GBP).
string
required
The numeric amount to convert. Must be a positive number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENCYSCOOP_GET_CURRENCIESTool to retrieve all supported currencies including their names and countries. Use when you need information about available currencies, either fiat or crypto.

Input Parameters

string ("fiat" | "crypto")
required
The type of currencies to retrieve. Must be either ‘fiat’ for traditional currencies or ‘crypto’ for cryptocurrencies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENCYSCOOP_GET_HISTORICAL_RATESRetrieve historical exchange rates for a specified date and base currency, with data available back to January 1, 1996. Optionally filter the results to selected target currencies using comma-separated currency codes; useful for accounting, auditing, and trend analysis.

Input Parameters

string
required
The base currency code for exchange rates (e.g., USD, EUR, GBP). Returned rates are expressed as units of target currency per 1 unit of base currency.
string
required
The historical date for rate retrieval in YYYY-MM-DD format. Dates available from 1996 onwards. Other formats are rejected. Future dates or dates before 1996 return empty/missing data rather than an error.
string
Comma-separated list of target currency codes to retrieve rates for. If omitted, returns all available currencies. Omitting produces large responses; specify only needed currencies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENCYSCOOP_GET_LATEST_RATESTool to retrieve real-time exchange rate data for all available currencies. Use when you need current exchange rates updated based on subscription plan frequency (e.g., every 60 seconds). Returns only current rates, not historical values; use CURRENCYSCOOP_GET_HISTORICAL_RATES for rates on a specific past date.

Input Parameters

string
Three-letter currency code for the base currency (e.g., USD, EUR, GBP). Defaults to USD if omitted. This is the currency that all other rates will be quoted against.
string
Comma-separated list of target currency codes to filter results (e.g., GBP,JPY,EUR). If omitted, returns rates for all supported currencies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENCYSCOOP_GET_TIMESERIES_RATESRetrieve daily historical exchange rates for a date range for trend analysis or historical comparisons. Time-series access and the maximum date range depend on the subscription plan.

Input Parameters

string
required
The base currency code for exchange rates (e.g., USD, EUR, GBP). This is the currency that all other rates will be quoted against.
string
Comma-separated list of target currency codes to retrieve rates for. If omitted, returns rates for all available currencies. Omitting this significantly inflates payload size and processing time; specify only needed codes when possible.
string
required
End date for the time series in YYYY-MM-DD format. This is the end of the time period for which you want historical rates.
string
required
Start date for the time series in YYYY-MM-DD format. This is the beginning of the time period for which you want historical rates. Must fall within CurrencyScoop’s supported historical range; out-of-range dates return empty or partial data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not