nc://financial-datasets

Financial Datasets: stock-market data from Financial Datasets' API as 28 read-only tools. A Nodecode rewrite of financial-datasets/hermes-plugin by financial-datasets.

Get it

Tell the agent "add the financial-datasets cell", or run nodecode add nc://financial-datasets.

Set it up

One member is the step left: a key. Create one at financialdatasets.ai, then paste it into /settings or put it in the config:

{
  "financial-datasets": { "api_key": "your key" }
}

Or name the variable that holds it and leave api_key unset, as the original did:

{
  "financial-datasets": { "api_key_env": "FINANCIAL_DATASETS_API_KEY" }
}

Then (restart-cells "nodecode-financial-datasets"). /financial says which service the cell talks to, whether a key answers, and what it registered; /financial AAPL answers that stock's price snapshot.

The key is read from the section or the variable it names, sent to the host you named and nowhere else, and a refusal never prints it back. Without either, the cell still starts: the 28 tools are there, and the first call refuses naming the member to write. Every call is billed to that key on the Financial Datasets account: see its pricing.

config.example.jsonc beside this file is the whole section, commented.

Use it

Ask about a company, a price, a filing, an owner, the macro picture or a screen. The tools are on the model from the first turn, so "Apple's revenue and net income over the last four quarters" reaches them without being told to.

Each answers JSON text, and one call reaches one dataset. A null figure means the API has no value for that period, not zero. Paging is the cell's: a list longer than one page comes back whole, up to 100 pages.

The same calls are in the financial-datasets package, for a prompt you would rather type in eval:

(financial-datasets:fetch "fd_get_income_statement" :ticker "AAPL" :period "annual" :limit 4)
(financial-datasets:fetch "fd_get_news" :ticker "NVDA" :limit 5)
(financial-datasets:fetch "fd_screen_stocks" :filters (list (list :field "pe_ratio" :operator "lt" :value 20)))

Each answers the text the tool answers. (help :financial-datasets) has the same map of tools in the manual.

What is in it

Nothing is installed and no dependency is added: nlk:http is the one seam that reaches outside, and it reaches one host.

Licence

MIT. The original plugin is Copyright (c) 2026 Financial Datasets, Inc.: see LICENSE and NOTICE.