OpenSea AI-Powered Insights System (n8n) - Full Integration Guide

🚀 System Overview

The OpenSea AI-Powered Insights System is a fully automated n8n workflow that connects multiple agent tools to deliver real-time NFT market insights via Telegram. This system consists of four interconnected workflows:

1. OpenSea AI-Powered Insights via Telegram (Main Supervisor)
2. OpenSea Analytics Agent Tool (Market Trends & Collection Stats)
3. OpenSea Marketplace Agent Tool (Live Listings, Offers, and Orders)
4. OpenSea NFT Agent Tool (Metadata, Ownership & Payment Tokens)

These agents work in sync under the Supervisor AI, which determines the appropriate agent(s) to use based on user queries. Responses are structured and sent back via Telegram for real-time insights.

---

🔗 System Architecture

🔹 Core Workflow: OpenSea AI-Powered Insights via Telegram

• Acts as the brain and command center.
• Receives queries from Telegram Chat.
• Determines which agent(s) should process the request.
• Aggregates and formats results.
• Sends structured responses back to the Telegram user.

🔹 Supporting Agent Tools

Each agent tool is a separate n8n workflow with a specific function:

1️⃣ OpenSea Analytics Agent → Retrieves market trends, sales history, transaction data.
2️⃣ OpenSea Marketplace Agent → Fetches NFT listings, offers, best prices, and order details.
3️⃣ OpenSea NFT Agent → Retrieves NFT metadata, ownership records, traits, and payment token data.

The Supervisor AI (Telegram Workflow) calls these agent workflows as needed.

---

🛠 Setup Instructions

1️⃣ Setting Up the Main Supervisor (Telegram Workflow)

1. Create a Telegram Bot using BotFather.
2. Copy the API Key and connect it to n8n’s Telegram Trigger Node.
3. Set up the Chat Message Received Node to capture user queries.
4. Configure the Session ID Node to track conversation history.
5. Link the AI Supervisor Brain (GPT-4o Mini) to process messages.
6. Connect it to the three agent tools using Tool Workflow Nodes.
7. Send output back to Telegram using the Telegram Node.

✅ This setup enables Telegram interaction with all OpenSea agents.

2️⃣ Configuring the OpenSea Agent Tools

Each agent tool must be linked to the main workflow:

A. OpenSea Analytics Agent

• Retrieves NFT market trends & transaction history.
• Requires collection slug, wallet address, or transaction filters.

B. OpenSea Marketplace Agent

• Fetches NFT listings, offers, and orders.
• Requires collection slug, token ID, or order hash.

C. OpenSea NFT Agent

• Retrieves NFT metadata, traits, and ownership data.
• Requires wallet address, contract address, or token ID.

3️⃣ Connecting the Agents to the Main Workflow

Each Tool Workflow Node inside the Telegram Supervisor Workflow must be configured to pass the query to the correct agent tool.

Example:

• User asks: “Find the cheapest listing for Bored Ape #1234” → Marketplace Agent is activated.
• User asks: “Retrieve all NFTs owned by 0xABC...” → NFT Agent is activated.
• User asks: “Compare last 3 months’ sales volume of Azuki and Moonbirds” → Analytics Agent is activated.

---

🔄 Data Flow & Execution Process

📩 Step 1: Receiving a Query

1. User sends a request via Telegram.
2. The Telegram Trigger captures the message.
3. The Session ID Node assigns a conversation ID.

📊 Step 2: Processing the Query

4. The AI Supervisor Brain (GPT-4o Mini) interprets the request.
5. It decides which agent tool should process the query.

🔗 Step 3: Activating the Correct Agent Tool

6. The appropriate Tool Workflow Node is triggered (Analytics, Marketplace, or NFT Agent).
7. The selected agent processes the query and fetches data from OpenSea’s API.

📤 Step 4: Sending the Response

8. The response is structured by the AI Supervisor.
9. The Telegram Node sends the formatted answer to the user.

✅ This ensures that all agents work together seamlessly.

---

🔥 Example Queries & Expected Outputs

🛒 OpenSea Marketplace Queries

| User Query | Agent Used | Expected Response | |--------------|--------------|----------------| | “Show me the 5 cheapest listings for Azuki.” | Marketplace Agent | List of Azuki NFTs with prices & links. | | “What’s the highest offer on Bored Ape #4567?” | Marketplace Agent | Highest active bid with buyer info. | | “Fetch the details of order 0x123abc...” | Marketplace Agent | Order breakdown (price, seller, expiration). |

📊 OpenSea Analytics Queries

| User Query | Agent Used | Expected Response | |--------------|--------------|----------------| | “Compare 7-day sales volume of BAYC & MAYC.” | Analytics Agent | Chart showing sales data. | | “List all transactions for CloneX in the last 24 hours.” | Analytics Agent | Table of sales & transfers. | | “Track all wallets that sold a Doodle in the last week.” | Analytics Agent | List of wallets & sold NFTs. |

🎭 OpenSea NFT Metadata Queries

| User Query | Agent Used | Expected Response | |--------------|--------------|----------------| | “Retrieve metadata for Cool Cat #7890.” | NFT Agent | NFT description, image, and attributes. | | “Which NFTs does 0x123... own on Ethereum?” | NFT Agent | List of NFTs held by the wallet. | | “Show me all NFTs from contract 0xABC...” | NFT Agent | All tokens linked to the contract. |

✅ This demonstrates how each agent provides unique insights.

---

⚠️ Critical Setup Notes & Troubleshooting

🔹 1. Ensure Correct API Credentials

• Each agent must be connected to OpenSea’s API.
• Use HTTP Header Authentication with an API Key.

🔹 2. Check for Invalid Chain Names

• ❌ "polygon" is not valid → Use "matic" instead.
• ✅ Only supported blockchains should be used.

🔹 3. Maintain Session Tracking

• Ensure sessionId is passed correctly between workflows.
• This prevents context loss in multi-step queries.

🔹 4. Use Pagination for Large Datasets

• For queries returning 100+ results, use the next parameter.

---

🚀 Final Thoughts

The OpenSea AI-Powered Insights System is designed for NFT investors, collectors, and analysts seeking real-time, structured market data through Telegram. By integrating multiple agent tools, it provides a powerful, automated way to analyze NFTs, transactions, and market trends.

Need Help?
🌐 Connect on LinkedIn:
🔗 http://linkedin.com/in/donjayamahajr

OpenSea AI-Powered Insights via Telegram

Purpose and structure

This folder contains the OpenSea AI-Powered Insights via Telegram workflow. Its executable nodes use agent, chatTrigger, lmChatOpenAi, memoryBufferWindow, set, telegram, telegramTrigger, toolWorkflow. The table and connection map below are derived from the JSON, not an inferred guarantee of behavior.

Setup

Import inactive. Configure your own credentials and replace REPLACE_WITH_* values. Review external destinations and Code nodes before running.

Entry points

When chat message received, Telegram Trigger

Verification

Sanitized source candidate; not runtime-tested. This overview is generated from node metadata. Read the folder README for the connection map, credential types, and license.

Attribution

https://github.com/Zie619/n8n-workflows/blob/94007c1445d9258a7da116646b79473e7c7c3282/workflows/Telegram/2004_Telegram_Stickynote_Automation_Triggered.json MIT; preserve source notices.