Hedera Agent Kit - Chainlink price Plugin

A plugin for Hedera Agent Kit JS that provides integration with Chainlink to get price feeds

The plugin in this repository is a reduced and simplified version (for educational purposes) of the original repository "Chainlink plugin" created by the LATAM Builders team during ETH Buenos Aires 2025

If you like it give thanks and credits the original authors:

• Daniela Malqui, Strategy & PM
• Matias Celiz, Frontend Developer
• Brian Paiba, Backend Developer
• Carla Alejo, UX-UI

You can read more about them and the plugin (including an example on how to use it as part of a full stack project) as their plugin presentation page

Overview

This plugin enables AI agents to interact with the Chainlink feed price contracts

Installation in the example index.js agent

1.- Install the plugin

npm install chainlink-pricefeed-plugin

2.- Import the plugin code in your index.js (Hedera Agent)

import { ChainlinkPriceFeedPlugin } from 'chainlink-pricefeed-plugin/plugin.js';

3.- Add this new plugin, in the plugins section of the agent

const hederaAgentToolkit = new HederaLangchainToolkit({
client,
configuration: {
    tools: [],
    plugins: [ChainlinkPriceFeedPlugin], // <---- Add the plugin here

6.- Use a prompt to ask for a price feed, for example like this:

const response = await agent.invoke(
{ messages: [{ role: 'user', content: "What's the price of Bitcoin?" }] },
{ configurable: { thread_id: '1' } }
);

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

node index.js

Tools

Get price feed from Chainlink

Get price feed for a given coin from Chainlink

JS Function

// Use the Chainlink API to get one price Feed from a given coin
export async function getPriceFeedFromChainlink(coinId) {...}

Input Parameters

Value	Type	Description
coinId	string	Identification of the coin we need the price feed for. Examples: "BTC", "ETH", "HBAR", ...

Output Values

Value	Type	Description
coinId	string	The coinId queried
address	string	The contract address used to query the price feed
price	string	Raw price value from the oracle
formattedPrice	string	Human-readable price with currency formatting
decimals	number	Number of decimal places in the raw price
roundId	string	The round ID of the price update
updatedAt	string	Timestamp when the price was last updated

Example Prompt

"What's the price of BTC?"

Optional: Plugin distribution, only needed to publish the npm package

npm login
npm publish