OpenSea NFT Agent Tool (n8n Workflow) Guide

🚀 Workflow Overview

The OpenSea NFT Agent Tool is a specialized AI-powered assistant designed to interact with OpenSea's API to fetch, analyze, and process NFT-related data. It helps users access NFT ownership, metadata, traits, collections, contracts, and payment tokens efficiently.

🎯 Key Features:

• Retrieve OpenSea user profiles by wallet address or username.
• Fetch NFT collections, metadata, contracts, and smart contract details.
• Access individual NFT details, including rarity and ownership.
• Track NFTs owned by an account, collections, and smart contracts.
• Retrieve payment tokens and NFT traits.
• Ensure API request validity and structured responses.

---

🔗 Nodes & Functions

1️⃣ NFT Agent Brain

• Type: AI Language Model (GPT-4o Mini)
• Purpose: Processes NFT-related API requests and interprets OpenSea data queries.

2️⃣ NFT Agent Memory

• Type: AI Memory Buffer
• Purpose: Stores session data to maintain context across multiple queries.

3️⃣ OpenSea Get Account

• Type: API Request
• Endpoint: /api/v2/accounts/{address_or_username}
• Function: Fetches an OpenSea user profile, including bio, social links, and profile image.

4️⃣ OpenSea Get Collection

• Type: API Request
• Endpoint: /api/v2/collections/{collection_slug}
• Function: Retrieves collection metadata, fees, and traits.

5️⃣ OpenSea Get Collections

• Type: API Request
• Endpoint: /api/v2/collections
• Function: Fetches a list of NFT collections, filtered by chain, creator, visibility, or ranking.

6️⃣ OpenSea Get Contract

• Type: API Request
• Endpoint: /api/v2/chain/{chain}/contract/{address}
• Function: Retrieves NFT collection smart contract details.

7️⃣ OpenSea Get NFT

• Type: API Request
• Endpoint: /api/v2/chain/{chain}/contract/{address}/nfts/{identifier}
• Function: Fetches metadata, traits, rarity, and ownership of a single NFT.

8️⃣ OpenSea Get NFTs by Account

• Type: API Request
• Endpoint: /api/v2/chain/{chain}/account/{address}/nfts
• Function: Retrieves all NFTs owned by a wallet address.

9️⃣ OpenSea Get NFTs by Collection

• Type: API Request
• Endpoint: /api/v2/collection/{collection_slug}/nfts
• Function: Fetches all NFTs in a collection.

🔟 OpenSea Get NFTs by Contract

• Type: API Request
• Endpoint: /api/v2/chain/{chain}/contract/{address}/nfts
• Function: Retrieves NFTs linked to a smart contract.

11️⃣ OpenSea Get Payment Token

• Type: API Request
• Endpoint: /api/v2/chain/{chain}/payment_token/{address}
• Function: Fetches details of a cryptocurrency/token used for NFT transactions.

12️⃣ OpenSea Get Traits

• Type: API Request
• Endpoint: /api/v2/traits/{collection_slug}
• Function: Retrieves trait categories and attributes for a given collection.

---

📌 How to Use the Workflow

✅ Step 1: Input Data

• Provide the necessary parameters like collection_slug, chain, address, or identifier.

✅ Step 2: Execute API Calls

• The workflow retrieves and structures NFT ownership, metadata, and analytics.

✅ Step 3: Analyze & Output Results

• Results can be integrated into dashboards, alerts, or Telegram notifications.

---

⚠️ Common API Queries & Examples

1️⃣ Get OpenSea User Profile

GET https://api.opensea.io/api/v2/accounts/0xA5f49655E6814d9262fb656d92f17D7874d5Ac7E

2️⃣ Get Collection Details

GET https://api.opensea.io/api/v2/collections/boredapeyachtclub

3️⃣ Get NFT Metadata

GET https://api.opensea.io/api/v2/chain/ethereum/contract/0xABCDEF.../nfts/1234

4️⃣ Get All NFTs Owned by a Wallet

GET https://api.opensea.io/api/v2/chain/ethereum/account/0x123.../nfts

5️⃣ Get Payment Token Details

GET https://api.opensea.io/api/v2/chain/ethereum/payment_token/0xABC...DEF

---

⚡ Error Handling & Troubleshooting

| Error Code | Description | |--------------|----------------| | 200 | Success | | 400 | Bad Request (Invalid input) | | 404 | Not Found (Incorrect slug, address, or identifier) | | 500 | Server Error (OpenSea API issue) |

🔹 Fixing Common Errors

• Ensure correct wallet address, NFT identifier, or collection slug.
• Always use "matic" instead of "polygon" for chain input.
• If OpenSea API is down, retry after some time.

---

🚀 Connect with Me for Support

If you need assistance, custom OpenSea NFT insights, or automation support, feel free to connect with me on LinkedIn:

🌐 Don Jayamaha – LinkedIn
🔗 http://linkedin.com/in/donjayamahajr

OpenSea NFT Agent Tool

Purpose and structure

This folder contains the OpenSea NFT Agent Tool workflow. Its executable nodes use agent, executeWorkflowTrigger, lmChatOpenAi, memoryBufferWindow, toolHttpRequest. 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

Workflow Input 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/Stickynote/1779_Stickynote_Executeworkflow_Automation_Webhook.json MIT; preserve source notices.