Currency Exchange Monitor using Fetch.ai's uAgent

Description

The currency exchange monitor agent using Fetch.AI's uAgent is a agent that can be used to monitor the exchange rate between two currencies and notify the client agent when the rate exceeds a certain limit. This can be useful for investors, traders, and anyone else who needs to keep track of currency exchange rates.

The currency exchange monitor agent works by first the agent on the client sending a message to the agent on the server side to setup a base currency, target currency and a limit for target currerncy on startup. Then the server agent connects to the exchangerates API and fetches the currency value on a interval of 10 seconds. The agent then compares the exchange rate to the limit that the user has set. If the exchange rate exceeds the limit, the agent sends a notification to the client agent.

Here is an example of how the currency exchange monitor agent could be used:

• A user sets the currency exchange monitor agent to monitor the exchange rate between USD and INR, and the limit to 100 INR per USD.
• The currency exchange monitor agent connects to a currency exchange API every 10 seconds and fetches the exchange rate between USD and INR.
• The currency exchange monitor agent compares the exchange rate to the limit that the user has set.
• The exchange rate is currently 99 INR per USD.
• The exchange rate has not exceeded the limit, so the currency exchange monitor agent does not send a notification to the client agent.
• The currency exchange monitor agent continues to monitor the exchange rate between USD and INR at regular intervals.
• If the exchange rate exceeds the limit, the currency exchange monitor agent will send a notification to the client agent.
• The currency exchange monitor agent is a valuable tool for anyone who needs to keep track of currency exchange rates. The agent is easy to use and can be configured to meet the specific needs of each user.

Instructions To Run The Project

Step 1: Prerequisites

Before starting, you'll need the following:

• Python (3.8+ is recommended)
• Poetry (a packaging and dependency management tool for Python)

Step 2: Set up .env file

To run the demo, you need API keys from:

• exchangeratesapi.io

Exchangerates API Key

• Visit exchangeratesapi.io .
• Sign up or log in.
• Obtain your API key.

Note that if you’ve run out of exchangeratesapi credits, you will not be able to get results.

Once you have key, create a .env file in the ./src directory.

CURRENCY_API_KEY="{GET THE API KEY}"

To use the environment variables from .env and install the project:

cd src
poetry intall

Step 3: Run the main script

To run the project and its agents:

poetry run python main.py

You need to look for the following output in the logs:

Adding currency exchange agent to Bureau: {exchange_currency_address}

Copy the {exchange_currency_address} value and paste it somewhere safe. You will need it in the next step.

Step 4: Set up the client

Now that we have set up the server, let’s run the client script. To do this, replace the address in ctx.send with the value you received in the previous step in ./src/currency_exchange_client.py.

This code sends a request on startup to set the base currency, target currency and the limit for target currency which on exceeding, the client will be sent an alert. To do this, the agent on the server side sends a request to the exchange rates api every 10 seconds and when the target currency value exceeds limit, it sends a alert mesage to the agent on the client side.

Step 5: Run the client script

Open a new terminal (let the previous one be as is), and navigate to the src folder to run the client.

cd src
poetry run python top_dest_client.py

Once you hit enter, a request will be sent to the top destinations agent every 10 seconds, and you will be able to see your results in the console!

Refrences

• https://github.com/fetchai/uAgents/tree/main/integrations/fetch-holiday
• https://docs.fetch.ai/uAgents/
• https://fetch.ai/docs/guides