OpenSea Marketplace Agent Tool (n8n Workflow) Guide

🚀 Workflow Overview

The OpenSea Marketplace Agent Tool is an AI-driven marketplace analytics system for NFT trading insights. This tool integrates with OpenSea's API to fetch and analyze NFT listings, offers, orders, and trait-specific data, helping traders and collectors make informed decisions.

🎯 Key Features:

• Retrieve active NFT listings for a collection.
• Fetch valid offers for individual NFTs or entire collections.
• Find the cheapest available NFT listings by collection or NFT.
• Track the highest offer made for an NFT or collection-wide offers.
• Access detailed order data based on order hash.
• Ensure API query compliance to prevent errors.

---

🔗 Nodes & Functions

1️⃣ Marketplace Agent Brain

• Type: AI Language Model (GPT-4o Mini)
• Purpose: Processes marketplace-related API requests and user queries.

2️⃣ Marketplace Agent Memory

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

3️⃣ OpenSea Get All Listings by Collection

• Type: API Request
• Endpoint: /api/v2/listings/collection/{collection_slug}/all
• Function: Retrieves all active listings for a given collection.

4️⃣ OpenSea Get All Offers by Collection

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

5️⃣ OpenSea Get Best Listing by NFT

• Type: API Request
• Endpoint: /api/v2/listings/collection/{collection_slug}/nfts/{identifier}/best
• Function: Retrieves the lowest-priced active listing for a specific NFT.

6️⃣ OpenSea Get Best Listings by Collection

• Type: API Request
• Endpoint: /api/v2/listings/collection/{collection_slug}/best
• Function: Fetches the cheapest listings for a given NFT collection.

7️⃣ OpenSea Get Best Offer by NFT

• Type: API Request
• Endpoint: /api/v2/offers/collection/{collection_slug}/nfts/{identifier}/best
• Function: Retrieves the highest offer made for a specific NFT.

8️⃣ OpenSea Get Collection Offers

• Type: API Request
• Endpoint: /api/v2/offers/collection/{collection_slug}
• Function: Retrieves all active collection-wide offers.

9️⃣ OpenSea Get Item Offers

• Type: API Request
• Endpoint: /api/v2/orders/{chain}/{protocol}/offers
• Function: Fetches individual active offers (excluding criteria-based offers).

🔟 OpenSea Get Listings by Chain & Protocol

• Type: API Request
• Endpoint: /api/v2/orders/{chain}/{protocol}/listings
• Function: Retrieves all active listings filtered by blockchain and protocol.

11️⃣ OpenSea Get Order by Hash

• Type: API Request
• Endpoint: /api/v2/orders/chain/{chain}/protocol/0x0000000000000068f116a894984e2db1123eb395/{order_hash}
• Function: Fetches a specific order (listing or offer) based on its order hash.

12️⃣ OpenSea Get Trait Offers

• Type: API Request
• Endpoint: /api/v2/offers/collection/{collection_slug}/traits
• Function: Retrieves active offers for specific traits in a collection.

---

📌 How to Use the Workflow

✅ Step 1: Input Data

• Provide required parameters such as collection_slug, identifier, chain, protocol, or order_hash.

✅ Step 2: Execute API Calls

• The system processes requests and fetches NFT marketplace data.

✅ Step 3: Analyze & Output Results

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

---

⚠️ Common API Queries & Examples

1️⃣ Get All Listings for a Collection

GET https://api.opensea.io/api/v2/listings/collection/boredapeyachtclub/all

2️⃣ Get All Offers for a Collection

GET https://api.opensea.io/api/v2/offers/collection/azuki/all

3️⃣ Get Best Listing for an NFT

GET https://api.opensea.io/api/v2/listings/collection/doodles/nfts/1234/best

4️⃣ Get Best Offer for an NFT

GET https://api.opensea.io/api/v2/offers/collection/moonbirds/nfts/5678/best

5️⃣ Get Order Details by Order Hash

GET https://api.opensea.io/api/v2/orders/chain/ethereum/protocol/0x0000000000000068f116a894984e2db1123eb395/0x123abc...

---

⚡ 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 collection slug and NFT identifier.
• Always use "matic" instead of "polygon" for chain input.
• Verify that the protocol is set to "seaport" where required.
• Order hash queries require the fixed protocol address: 0x0000000000000068f116a894984e2db1123eb395.
• Retry after some time if the OpenSea API is experiencing downtime.

---

🚀 Connect with Me for Support

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

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

OpenSea Marketplace Agent Tool

Purpose and structure

This folder contains the OpenSea Marketplace 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/1816_Stickynote_Executeworkflow_Automation_Webhook.json MIT; preserve source notices.