sifting/io
Community node · Low-code

n8n.

Add SiftingIO to your n8n workflows with the community node. One node exposes live prices, historical bars, fundamentals, and SEC filings across stocks, forex, crypto, DEX, and commodities, with no code. Use it in any workflow or as a tool for an n8n AI Agent.

View on GitHub

What it does

The n8n-nodes-siftingio community node brings SiftingIO into n8n. A single SiftingIO node groups every operation by resource, so one credential reaches live prices, historical bars, fundamentals, SEC filings, and on-chain data across stocks, forex, crypto, DEX, and commodities. Use it in any workflow, with no code, or attach it as a tool to an n8n AI Agent.

AI Agent ready
The node is AI-tool compatible. Connect it to an AI Agent and the model can call SiftingIO operations, for example pulling a live quote or a company’s latest filing, as part of its reasoning.

What you'll need

The node runs inside your n8n instance. Before you start, line up:

  • An n8n instance that allows community nodes (self-hosted, or cloud with community nodes enabled).
  • A SiftingIO API key. Create one from your dashboard.
  • For self-hosting, Node 20 LTS is recommended for the smoothest install.
Step 1

Install the community node

In n8n, open Settings → Community Nodes → Install, enter n8n-nodes-siftingio, and confirm. On self-hosted n8n you can install it with npm instead:

install
# Self-hosted n8n, from your n8n root:
npm install n8n-nodes-siftingio
Node version
Community nodes run in your n8n runtime. On self-hosted setups, Node 20 LTS avoids the isolated-vm issues seen on newer Node releases. Restart n8n after installing so it picks up the node.
Step 2

Add your SiftingIO API credential

Create a new SiftingIO API credential and paste your API key (it looks like sft_...). n8n stores it and sends it as the X-API-Key header on every request the node makes, so the key never appears in a workflow.

Step 3

Add the SiftingIO node and pick a resource

Drop the SiftingIO node into a workflow, select your credential, then choose a resource and one of its operations. The node covers:

Resource
Live
Last trade, top-of-book quote, snapshot, DEX TVL
Historical
OHLCV bars for stocks, forex, crypto, DEX, and commodities
Convert
Currency conversion across forex and crypto
Market
Markets, status, trading hours, and holiday calendars
Discovery
Search tickers and companies, company profile
Financials (XBRL)
Full bundle, single concept, ratios, cross-sectional screener
SEC Filing
List and fetch filings, material events, ownership, earnings history
Filing Text
Extract sections and diff risk factors year over year
Holdings
Insider transactions and institutional (13F) holdings
Economic Calendar
Upcoming US economic events
DEX Wallet
On-chain wallet portfolio

That is over thirty operations in one node. See the repository for the full operation list and the parameters each one takes.

Step 4

Configure the operation parameters

Each operation exposes just the fields it needs. Common ones across the node:

  • Symbol or ticker, in USD-quoted form for markets such as BTCUSD and EURUSD.
  • Venue to select the asset class, plus a timeframe and date range for historical bars.
  • For fundamentals and filings, an accession number or concept name.
Pagination
List operations support cursor-based pagination with a Return All toggle. Leave it off and set a limit to control volume; responses are gzip-compressed automatically.

Use it as an AI Agent tool

Because the node is AI-tool compatible, you can wire it onto an n8n AI Agent so the model fetches market data while it reasons.

  • Add an AI Agent node and connect the SiftingIO node to its tool input.
  • The agent can then answer prompts like “what is the latest price of Bitcoin” or “summarize this company’s most recent filing” by calling the right operation itself.
  • Scope the agent to the operations you want it to reach, and keep an eye on usage since each call counts against your plan.

Workflow ideas

A few patterns the node makes quick to build:

  • Poll a live quote on a schedule and alert when it crosses a level.
  • Pull daily historical bars and append them to a sheet or database.
  • Watch for a company’s new SEC filings and post a summary to chat.
  • Screen financial ratios across tickers and route the results downstream.
  • Notify a channel ahead of upcoming economic-calendar events.
  • Snapshot an on-chain wallet portfolio on a timer.

Notes and limits

  • Every operation calls the SiftingIO API and counts against your plan. Schedule and limit high-frequency workflows.
  • Self-hosting is recommended on Node 20 LTS for install compatibility.
  • Prices are an aggregated fair-price reference computed across sources, consistent with the REST, WebSocket, and FIX products.
  • The package is an open-source community node under the MIT license, not built by n8n.

FAQ

  • Which n8n versions does the node support?

    It is built against the current community-node interface (n8n nodes API version 1, n8n-workflow 2.x). It runs on self-hosted n8n and on instances that allow community nodes.

  • Can I use it on n8n Cloud?

    Community nodes install on self-hosted n8n and on cloud instances that permit them. Self-hosting also lets you pin the Node.js version, with Node 20 LTS recommended.

  • Do I need to write any code?

    No. The node is configured entirely in the n8n UI: pick a resource and operation, then set parameters such as symbol, venue, and timeframe.

  • Can an AI Agent use the node?

    Yes. The node is AI-tool compatible, so you can attach it to an n8n AI Agent and let the model pull quotes, bars, or filings on demand.

  • How do I page through large result sets?

    List operations use cursor-based pagination with a Return All toggle. Leave it off and set a limit to cap how much each execution pulls. Responses are gzip-compressed automatically.

  • Does every execution use my API quota?

    Yes. Each operation calls the SiftingIO API and counts against your plan, so schedule and limit workflows that run often.

Get started

Automate market data in n8n

Install the node, add your key, and you are building market-data workflows in minutes. The repository has the full operation list and examples.

Get an API keyView the node on GitHubAPI reference