NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
CurrencyScoop connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 CurrencyScoop actions, such as "Get Currencies", "Get Historical Exchange Rates" and "Get Latest Exchange Rates". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against CurrencyScoop, with input parameters and output schema.
CURRENCYSCOOP_CONVERT_CURRENCY2Tool to convert any amount from one currency to another using real-time or historical exchange rates. Use when you need to convert a specific amount between two currencies, optionally specifying a date for historical rates.
Input parameters
The 3-letter currency code to convert to (e.g., EUR, USD, JPY).
Optional date for historical conversion in YYYY-MM-DD format. If omitted, uses current real-time rates.
The 3-letter currency code to convert from (e.g., USD, EUR, GBP).
The numeric amount to convert. Must be a positive number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The type of currencies to retrieve. Must be either 'fiat' for traditional currencies or 'crypto' for cryptocurrencies.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURRENCYSCOOP_GET_HISTORICAL_RATESTool to retrieve historical exchange rate data for past dates going back to 1996. Use when you need to access exchange rates for a specific historical date with a base currency.
Input parameters
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.
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.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
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.
Comma-separated list of target currency codes to filter results (e.g., GBP,JPY,EUR). If omitted, returns rates for all supported currencies.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURRENCYSCOOP_GET_TIMESERIES_RATESTool to retrieve historical exchange rates for a given time period between start and end dates. Use when you need exchange rates for multiple dates in a date range for trend analysis or historical comparisons.
Input parameters
The base currency code for exchange rates (e.g., USD, EUR, GBP). This is the currency that all other rates will be quoted against.
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.
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.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 CurrencyScoop actions on Nagent, including "Get Currencies", "Get Historical Exchange Rates" and "Get Latest Exchange Rates". Get Currencies: Retrieve all supported currencies including their names and countries. Each action is listed on this page with its input parameters and its output.
CurrencyScoop connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Currencies takes 1 required input: type. It returns data, error and successful.