Skip to content

About

CoinCap Plugin for the Hedera Agent Kit Py

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

Repository files navigation

Hedera Agent Kit - CoinCap Plugin Python version

A plugin for Hedera Agent Kit PY that provides integration with the CoinCap API

In this plugin we use CoinCap to get the current price in USD of one HBAR and combine it with the power of the Hedera Agent Kit to get your current balance of HBAR in USD currency.

Overview

This plugin enables AI agents to interact with the CoinCap API

Installation in the example main.py agent

1.- Install the plugin

pip install coincap-hedera-agent-kit-plugin

2.- Add your CoinCap API Bearer token in the .env file ( You get it in the CoinCap website )

# Coincap API needed by coincap-hedera-plugin
COINCAP_BEARER_TOKEN=******************************

3.- Import the plugin code in your main.py (Hedera Agent)

from coincap_hedera_plugin import conincap_h_plugin

4.- Import the core_account_query_plugin plugin code

This core plugin is already provided by the Hedera, it is needed to query the account (read its balance)

from hedera_agent_kit.plugins import core_account_query_plugin

5.- Add the plugin in the plugins section of the agent

async def main():
        ...
        configuration=Configuration(
            tools=[],
            plugins=[
                core_account_query_plugin,
                conincap_h_plugin  # <---- add the plugin here

6.- Use a prompt to ask for your current balance and tell the agent to want it in USD currency, for example like this:

response = await agent.ainvoke(
    {"messages": [{"role": "user", "content": "Get my balance in HBAR and also convert it to USD please"}]},

Note

The previous prompt results in a multi-step tool invocation:

  • Fetch the HBAR balance.
  • Fetch the current HBAR price.
  • Convert the balance to USD.

It is important for developers to be aware of, as configurations that limit the agent to only one tool call per request will cause this prompt to fail or behave incorrectly.

7.- Now you can run the example agent and you should get your current HBAR balance converted to USD currency

python main.py

Tools

Get HBAR price in USD

Invoke the CoinCap API to get the current price in USD of one HBAR

Python Function

def get_hbar_price_from_coincap():

Input Parameters

None

Output Values

Value Type Description
Result float Value in USD currency of 1 HBAR according to CoinCap

Example Prompt

Get my balance in HBAR and also convert it to USD please

Optional - Code building, only needed when working on the source code

Use a code formatter, for example black

pip install black
black .

Optional - Distribution (only needed when creating your own python package) How to publish a PyPI package

1.- Read the instructions

2.- Create the distribution package

python setup.py sdist

3.- Install twine

pip install twine

4.- Upload package

twine upload dist/*

About

CoinCap Plugin for the Hedera Agent Kit Py

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages