Déclarez, suivez et analysez chaque incident avec des workflows automatisés. Notifiez les responsables, programmez les actions correctives et centralisez le suivi pour limiter les risques.
Déclarez, suivez et analysez chaque incident avec des workflows automatisés. Notifiez les responsables, programmez les actions correctives et centralisez le suivi pour limiter les risques.
{
"id": "brRSLvIkYp3mLq0K",
"meta": {
"instanceId": "a5283507e1917a33cc3ae615b2e7d5ad2c1e50955e6f831272ddd5ab816f3fb6"
},
"name": "OpenSea Marketplace Agent Tool",
"tags": [],
"nodes": [
{
"id": "13579b30-83df-4da6-b0de-90eeaf3252e7",
"name": "Marketplace Agent Brain",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"position": [
-300,
-260
],
"parameters": {
"model": {
"__rl": true,
"mode": "list",
"value": "gpt-4o-mini"
},
"options": {}
},
"credentials": {
"openAiApi": {
"id": "yUizd8t0sD5wMYVG",
"name": "OpenAi account"
}
},
"typeVersion": 1.2
},
{
"id": "9f979fae-49c6-4a50-b96b-92de5a49ba14",
"name": "Marketplace Agent Memory",
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"position": [
-120,
-260
],
"parameters": {},
"typeVersion": 1.3
},
{
"id": "202ca463-f038-46df-99ea-84fbda70a933",
"name": "OpenSea Marketplace Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"position": [
420,
-540
],
"parameters": {
"text": "={{ $json.message }}",
"options": {
"systemMessage": "### **ud83duded2 OpenSea Marketplace Agent Overview**nThis agent interacts with the OpenSea marketplace API to retrieve marketplace data, including NFT listings, offers, orders, and trait-specific data. The system follows strict input requirements to ensure compatibility with OpenSea API rules.nn---nn## **u26a1 Available Tools & Usage Guidelines**nThe OpenSea Marketplace Agent has access to the following marketplace-related tools:nn---nn### **1ufe0fu20e3 Get All Listings (by Collection)**nud83dudccd **Endpoint**: `/api/v2/listings/collection/{collection_slug}/all` nud83dudd39 **Description**: Retrieves all active, valid listings for a given collection. nud83dudd39 **Required Parameter**: n - `collection_slug` u2192 The unique collection identifier from OpenSea. nud83dudd39 **Optional Query Parameters**: n - `limit` u2192 Number of listings to return (1-100, default: 100). n - `next` u2192 Cursor for pagination. nud83dudd39 **Example Query**: n - _"Retrieve all active listings for the 'boredapeyachtclub' collection."_ nn---nn### **2ufe0fu20e3 Get All Offers (by Collection)**nud83dudccd **Endpoint**: `/api/v2/offers/collection/{collection_slug}/all` nud83dudd39 **Description**: Retrieves all valid offers for a given NFT collection, including individual and criteria-based offers. nud83dudd39 **Required Parameter**: n - `collection_slug` u2192 The unique collection identifier from OpenSea. nud83dudd39 **Optional Query Parameters**: n - `limit` u2192 Number of offers to return (1-100, default: 100). n - `next` u2192 Cursor for pagination. nud83dudd39 **Example Query**: n - _"Fetch all current offers for 'azuki' collection."_ nn---nn### **3ufe0fu20e3 Get Best Listing (by NFT)** nud83dudccd **Endpoint**: `/api/v2/listings/collection/{collection_slug}/nfts/{identifier}/best` nud83dudd39 **Description**: Retrieves the best (cheapest) active listing for a specific NFT. nud83dudd39 **Required Parameters**: n - `collection_slug` u2192 The collection identifier. n - `identifier` u2192 The NFT token ID. nud83dudd39 **Optional Query Parameters**: n - `include_private_listings` u2192 Boolean (default: `false`). nud83dudd39 **Example Query**: n - _"Find the lowest-priced listing for NFT #1234 in 'doodles' collection."_ nn---nn### **4ufe0fu20e3 Get Best Listings (by Collection)** nud83dudccd **Endpoint**: `/api/v2/listings/collection/{collection_slug}/best` nud83dudd39 **Description**: Retrieves the lowest-priced active listings for a specific collection. nud83dudd39 **Required Parameter**: n - `collection_slug` u2192 The collection identifier. nud83dudd39 **Optional Query Parameters**: n - `include_private_listings` u2192 Boolean (default: `false`). n - `limit` u2192 Number of listings to return (1-100, default: 100). n - `next` u2192 Cursor for pagination. nud83dudd39 **Example Query**: n - _"Get the 10 cheapest listings for 'mutantapeyachtclub'."_ nn---nn### **5ufe0fu20e3 Get Best Offer (by NFT)** nud83dudccd **Endpoint**: `/api/v2/offers/collection/{collection_slug}/nfts/{identifier}/best` nud83dudd39 **Description**: Retrieves the highest offer made for a specific NFT. nud83dudd39 **Required Parameters**: n - `collection_slug` u2192 The collection identifier. n - `identifier` u2192 The NFT token ID. nud83dudd39 **Example Query**: n - _"Find the highest offer for NFT #5678 in 'moonbirds' collection."_ nn---nn### **6ufe0fu20e3 Get Collection Offers** nud83dudccd **Endpoint**: `/api/v2/offers/collection/{collection_slug}` nud83dudd39 **Description**: Retrieves all active collection-wide offers for a specific NFT collection. nud83dudd39 **Required Parameter**: n - `collection_slug` u2192 The collection identifier. nud83dudd39 **Example Query**: n - _"List all collection offers for 'clonex'."_ nn---nn### **7ufe0fu20e3 Get Item Offers** nud83dudccd **Endpoint**: `/api/v2/orders/{chain}/{protocol}/offers` nud83dudd39 **Description**: Retrieves all valid **individual** offers (excluding criteria-based offers). nud83dudd39 **Required Parameters**: n - `chain` u2192 The blockchain network (must use an **allowed chain**, see below). n - `protocol` u2192 The token settlement protocol (only `"seaport"` is supported). nud83dudd39 **Optional Query Parameters**: n - `asset_contract_address`, `cursor`, `limit`, `listed_after`, `listed_before`, `maker`, `order_by`, `order_direction`, `payment_token_address`, `taker`, `token_ids`. nud83dudd39 **Example Query**: n - _"Fetch all active item offers for NFTs on Ethereum using Seaport protocol."_ nn---nn### **8ufe0fu20e3 Get Listings (by Chain & Protocol)** nud83dudccd **Endpoint**: `/api/v2/orders/{chain}/{protocol}/listings` nud83dudd39 **Description**: Retrieves all active listings filtered by blockchain and protocol. nud83dudd39 **Required Parameters**: n - `chain` u2192 The blockchain network (**must be an allowed chain**). n - `protocol` u2192 `"seaport"` protocol. nud83dudd39 **Optional Query Parameters**: n - `asset_contract_address`, `cursor`, `limit`, `listed_after`, `listed_before`, `maker`, `order_by`, `order_direction`, `payment_token_address`, `taker`, `token_ids`. nud83dudd39 **Example Query**: n - _"Retrieve all active listings for Ethereum Seaport orders."_ nn---nn### **9ufe0fu20e3 Get Order (Single Order by Hash)** nud83dudccd **Endpoint**: `/api/v2/orders/chain/{chain}/protocol/{protocol_address}/{order_hash}` nud83dudd39 **Description**: Retrieves a specific order (offer or listing) based on its hash. nud83dudd39 **Required Parameters**: n - `chain` u2192 The blockchain network (**must be an allowed chain**). n - `protocol_address` u2192 **Always set to** `0x0000000000000068f116a894984e2db1123eb395`. n - `order_hash` u2192 The hash of the order. nud83dudd39 **Example Query**: n - _"Fetch details for order `0x123abc...` on Ethereum."_ nn---nn### **ud83dudd1f Get Trait Offers** nud83dudccd **Endpoint**: `/api/v2/offers/collection/{collection_slug}/traits` nud83dudd39 **Description**: Retrieves all active offers made for a specific trait in a collection. nud83dudd39 **Required Parameter**: n - `collection_slug` u2192 The collection identifier. nud83dudd39 **Optional Query Parameters**: n - `float_value`, `int_value`, `type`, `value`. nud83dudd39 **Example Query**: n - _"Find all offers for 'Background: Blue' in the 'azuki' collection."_ nn---nn## **u26a0ufe0f Critical Notes & Restrictions**n1. **Only Allowed Blockchains Can Be Used** n - u2705 Supported Chains: n - `amoy`, `ape_chain`, `ape_curtis`, `arbitrum`, `arbitrum_nova`, `arbitrum_sepolia`, `avalanche`, `avalanche_fuji`, `b3`, `b3_sepolia`, `baobab`, `base`, `base_sepolia`, `bera_chain`, `blast`, `blast_sepolia`, `ethereum`, `flow`, `flow_testnet`, `klaytn`, `matic`, `monad_testnet`, `mumbai`, `optimism`, `optimism_sepolia`, `sei_testnet`, `sepolia`, `shape`, `solana`, `soldev`, `soneium`, `soneium_minato`, `unichain`, `zora`, `zora_sepolia`. n - u274c **Incorrect Chain Inputs Will Cause Errors** n - `"polygon"` u274c **will fail**. Use `"matic"` instead.nn2. **Protocol Must Be `"seaport"` for Item & Listing Queries** n - The `"protocol"` field must always be set to `"seaport"`.nn3. **Fixed Protocol Address for Get Order** n - **For retrieving a specific order**, the `protocol_address` **must always be**: n - `0x0000000000000068f116a894984e2db1123eb395`.nn---nn## **u2705 Example Queries**n- _"Fetch all best listings for Ethereum NFTs."_ n- _"Find the highest offer for a Bored Ape #456."_ n- _"Get details for a specific order hash."_ nnud83dude80 **Follow these rules to ensure successful API queries!**"
},
"promptType": "define"
},
"typeVersion": 1.8
},
{
"id": "c055762a-8fe7-4141-a639-df2372f30060",
"name": "Workflow Input Trigger",
"type": "n8n-nodes-base.executeWorkflowTrigger",
"position": [
-60,
-540
],
"parameters": {
"workflowInputs": {
"values": [
{
"name": "message"
},
{
"name": "sessionId"
}
]
}
},
"typeVersion": 1.1
},
{
"id": "e25c62f0-1047-4fbb-815c-caeaa22d2fe1",
"name": "OpenSea Get All Listings by Collection",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
60,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/listings/collection/{collection_slug}/all",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "limit",
"valueProvider": "modelOptional"
},
{
"name": "next",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves all active, valid listings for a single NFT collection on OpenSea, allowing pagination and limit options.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "d568d5de-82e4-4be1-b9e9-9ec56ca9d872",
"name": "OpenSea Get All Offers by Collection",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
240,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/offers/collection/{collection_slug}/all",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "limit",
"valueProvider": "modelOptional"
},
{
"name": "next",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves all active, valid offers for a specified NFT collection on OpenSea, including individual and criteria offers.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "1b591b2d-787f-4519-9dfc-fc0489bc0725",
"name": "OpenSea Get Best Listing by NFT",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
440,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/listings/collection/{collection_slug}/nfts/{identifier}/best",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "include_private_listings",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves the best available listing for a specific NFT from OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "33222cfb-17c7-4507-8d09-fa0a7ba1beae",
"name": "OpenSea Get Best Listings by Collection",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
640,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/listings/collection/{collection_slug}/best",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "include_private_listings",
"valueProvider": "modelOptional"
},
{
"name": "limit",
"valueProvider": "modelOptional"
},
{
"name": "next",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves the cheapest active and valid listings for a specific NFT collection on OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "7fd0ddd6-96eb-487d-b7a2-b8fcb29b4e22",
"name": "OpenSea Get Best Offer by NFT",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
860,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/offers/collection/{collection_slug}/nfts/{identifier}/best",
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"toolDescription": "This tool retrieves the best offers for a specific NFT on OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "7047b8bc-ea5e-4b9b-9230-0fc46c46c58f",
"name": "OpenSea Get Collection Offers",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
1080,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/offers/collection/{collection_slug}",
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"toolDescription": "This tool retrieves the active, valid collection offers for a specified NFT collection on OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "cab63cc4-96b4-4e14-8eb7-9fca08791040",
"name": "OpenSea Get Item Offers",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
1300,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/orders/{chain}/{protocol}/offers",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "asset_contract_address",
"valueProvider": "modelOptional"
},
{
"name": "cursor",
"valueProvider": "modelOptional"
},
{
"name": "limit",
"valueProvider": "modelOptional"
},
{
"name": "listed_after",
"valueProvider": "modelOptional"
},
{
"name": "listed_before",
"valueProvider": "modelOptional"
},
{
"name": "maker",
"valueProvider": "modelOptional"
},
{
"name": "order_by",
"valueProvider": "modelOptional"
},
{
"name": "order_direction",
"valueProvider": "modelOptional"
},
{
"name": "payment_token_address",
"valueProvider": "modelOptional"
},
{
"name": "taker",
"valueProvider": "modelOptional"
},
{
"name": "token_ids",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves active, valid individual offers for NFTs on OpenSea. It does not include criteria offers.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "63760966-bbec-466d-83dc-a52b235df43a",
"name": "OpenSea Get Listings",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
1500,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/orders/{chain}/{protocol}/listings",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "asset_contract_address",
"valueProvider": "modelOptional"
},
{
"name": "cursor",
"valueProvider": "modelOptional"
},
{
"name": "limit",
"valueProvider": "modelOptional"
},
{
"name": "listed_after",
"valueProvider": "modelOptional"
},
{
"name": "listed_before",
"valueProvider": "modelOptional"
},
{
"name": "maker",
"valueProvider": "modelOptional"
},
{
"name": "order_by",
"valueProvider": "modelOptional"
},
{
"name": "order_direction",
"valueProvider": "modelOptional"
},
{
"name": "payment_token_address",
"valueProvider": "modelOptional"
},
{
"name": "taker",
"valueProvider": "modelOptional"
},
{
"name": "token_ids",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves the complete set of active, valid listings for NFTs on OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "d0365a8a-dfd4-4a86-88cf-4e8ccbdf6c36",
"name": "OpenSea Get Trait Offers",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
1900,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/offers/collection/{collection_slug}/traits",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "float_value",
"valueProvider": "modelOptional"
},
{
"name": "int_value",
"valueProvider": "modelOptional"
},
{
"name": "type",
"valueProvider": "modelOptional"
},
{
"name": "value",
"valueProvider": "modelOptional"
}
]
},
"toolDescription": "This tool retrieves the active, valid trait offers for a specified collection on OpenSea.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "148a00a5-d8f4-4708-9afd-b1111f7d71bd",
"name": "OpenSea Get Order",
"type": "@n8n/n8n-nodes-langchain.toolHttpRequest",
"position": [
1700,
-260
],
"parameters": {
"url": "https://api.opensea.io/api/v2/orders/chain/{chain}/protocol/0x0000000000000068f116a894984e2db1123eb395/{order_hash}",
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"parametersQuery": {
"values": [
{
"name": "chain"
},
{
"name": "order_hash"
}
]
},
"toolDescription": "This tool retrieves a single order (offer or listing) from OpenSea using its order hash. Protocol and Chain are required to prevent hash collisions. The protocol address is always set to 0x0000000000000068f116a894984e2db1123eb395.",
"parametersHeaders": {
"values": [
{
"name": "Accept",
"value": "application/json",
"valueProvider": "fieldValue"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "3v99GVMGF4tKP5nM",
"name": "OpenSea"
}
},
"typeVersion": 1.1
},
{
"id": "2b616d18-f719-42dd-a616-d91ae11be009",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"position": [
-2080,
-1840
],
"parameters": {
"color": 2,
"width": 1380,
"height": 1860,
"content": "# OpenSea Marketplace Agent Tool (n8n Workflow) Guidenn## ud83dude80 Workflow OverviewnThe **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.nn### ud83cudfaf **Key Features**:n- Retrieve **active NFT listings** for a collection.n- Fetch **valid offers** for individual NFTs or entire collections.n- Find the **cheapest available NFT listings** by collection or NFT.n- Track **the highest offer** made for an NFT or collection-wide offers.n- Access **detailed order data** based on order hash.n- Ensure **API query compliance** to prevent errors.nn---nn## ud83dudd17 **Nodes & Functions**n### **1ufe0fu20e3 Marketplace Agent Brain**n- **Type**: AI Language Model (GPT-4o Mini)n- **Purpose**: Processes marketplace-related API requests and user queries.nn### **2ufe0fu20e3 Marketplace Agent Memory**n- **Type**: AI Memory Buffern- **Purpose**: Stores session data to maintain context across multiple queries.nn### **3ufe0fu20e3 OpenSea Get All Listings by Collection**n- **Type**: API Requestn- **Endpoint**: `/api/v2/listings/collection/{collection_slug}/all`n- **Function**: Retrieves all active listings for a given collection.nn### **4ufe0fu20e3 OpenSea Get All Offers by Collection**n- **Type**: API Requestn- **Endpoint**: `/api/v2/offers/collection/{collection_slug}/all`n- **Function**: Fetches all active offers made for NFTs in a collection.nn### **5ufe0fu20e3 OpenSea Get Best Listing by NFT**n- **Type**: API Requestn- **Endpoint**: `/api/v2/listings/collection/{collection_slug}/nfts/{identifier}/best`n- **Function**: Retrieves the **lowest-priced** active listing for a specific NFT.nn### **6ufe0fu20e3 OpenSea Get Best Listings by Collection**n- **Type**: API Requestn- **Endpoint**: `/api/v2/listings/collection/{collection_slug}/best`n- **Function**: Fetches the **cheapest listings** for a given NFT collection.nn### **7ufe0fu20e3 OpenSea Get Best Offer by NFT**n- **Type**: API Requestn- **Endpoint**: `/api/v2/offers/collection/{collection_slug}/nfts/{identifier}/best`n- **Function**: Retrieves the **highest offer** made for a specific NFT.nn### **8ufe0fu20e3 OpenSea Get Collection Offers**n- **Type**: API Requestn- **Endpoint**: `/api/v2/offers/collection/{collection_slug}`n- **Function**: Retrieves all **active collection-wide offers**.nn### **9ufe0fu20e3 OpenSea Get Item Offers**n- **Type**: API Requestn- **Endpoint**: `/api/v2/orders/{chain}/{protocol}/offers`n- **Function**: Fetches **individual active offers** (excluding criteria-based offers).nn### **ud83dudd1f OpenSea Get Listings by Chain & Protocol**n- **Type**: API Requestn- **Endpoint**: `/api/v2/orders/{chain}/{protocol}/listings`n- **Function**: Retrieves all active **listings filtered by blockchain and protocol**.nn### **11ufe0fu20e3 OpenSea Get Order by Hash**n- **Type**: API Requestn- **Endpoint**: `/api/v2/orders/chain/{chain}/protocol/0x0000000000000068f116a894984e2db1123eb395/{order_hash}`n- **Function**: Fetches **a specific order (listing or offer)** based on its order hash.nn### **12ufe0fu20e3 OpenSea Get Trait Offers**n- **Type**: API Requestn- **Endpoint**: `/api/v2/offers/collection/{collection_slug}/traits`n- **Function**: Retrieves **active offers** for specific traits in a collection.nn---nn"
},
"typeVersion": 1
},
{
"id": "f483a29b-626d-4c15-84a9-ac9937aea302",
"name": "Sticky Note1",
"type": "n8n-nodes-base.stickyNote",
"position": [
-600,
-1840
],
"parameters": {
"color": 5,
"width": 1500,
"height": 1080,
"content": "n## ud83dudccc **How to Use the Workflow**nn### u2705 **Step 1: Input Data**n- Provide required parameters such as `collection_slug`, `identifier`, `chain`, `protocol`, or `order_hash`.nn### u2705 **Step 2: Execute API Calls**n- The system processes requests and fetches NFT marketplace data.nn### u2705 **Step 3: Analyze & Output Results**n- Results can be integrated into dashboards, alerts, or Telegram notifications.nn---nn## u26a0ufe0f **Common API Queries & Examples**nn### **1ufe0fu20e3 Get All Listings for a Collection**n```plaintextnGET https://api.opensea.io/api/v2/listings/collection/boredapeyachtclub/alln```nn### **2ufe0fu20e3 Get All Offers for a Collection**n```plaintextnGET https://api.opensea.io/api/v2/offers/collection/azuki/alln```nn### **3ufe0fu20e3 Get Best Listing for an NFT**n```plaintextnGET https://api.opensea.io/api/v2/listings/collection/doodles/nfts/1234/bestn```nn### **4ufe0fu20e3 Get Best Offer for an NFT**n```plaintextnGET https://api.opensea.io/api/v2/offers/collection/moonbirds/nfts/5678/bestn```nn### **5ufe0fu20e3 Get Order Details by Order Hash**n```plaintextnGET https://api.opensea.io/api/v2/orders/chain/ethereum/protocol/0x0000000000000068f116a894984e2db1123eb395/0x123abc...n```nn---nn"
},
"typeVersion": 1
},
{
"id": "6c111fd9-0076-438e-8516-3a0e03e63510",
"name": "Sticky Note2",
"type": "n8n-nodes-base.stickyNote",
"position": [
1040,
-1840
],
"parameters": {
"color": 3,
"width": 1060,
"height": 520,
"content": "## u26a1 **Error Handling & Troubleshooting**n| **Error Code** | **Description** |n|--------------|----------------|n| `200` | Success |n| `400` | Bad Request (Invalid input) |n| `404` | Not Found (Incorrect slug, address, or identifier) |n| `500` | Server Error (OpenSea API issue) |nn### ud83dudd39 **Fixing Common Errors**n- Ensure correct **collection slug** and **NFT identifier**.n- Always use `"matic"` instead of `"polygon"` for chain input.n- Verify that the **protocol is set to `"seaport"`** where required.n- **Order hash queries require the fixed protocol address:** `0x0000000000000068f116a894984e2db1123eb395`.n- Retry after some time if the OpenSea API is experiencing downtime.nn---nn## ud83dude80 **Connect with Me for Support**nIf you need assistance, custom OpenSea marketplace insights, or automation support, feel free to connect with me on LinkedIn:nnud83cudf10 **Don Jayamaha u2013 LinkedIn** nud83dudd17 [http://linkedin.com/in/donjayamahajr](http://linkedin.com/in/donjayamahajr)n"
},
"typeVersion": 1
}
],
"active": false,
"pinData": {},
"settings": {
"executionOrder": "v1"
},
"versionId": "f82ae6e7-43e0-4c9d-ae7e-0ddacc93a92a",
"connections": {
"OpenSea Get Order": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get Listings": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Workflow Input Trigger": {
"main": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "main",
"index": 0
}
]
]
},
"Marketplace Agent Brain": {
"ai_languageModel": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"OpenSea Get Item Offers": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Marketplace Agent Memory": {
"ai_memory": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_memory",
"index": 0
}
]
]
},
"OpenSea Get Trait Offers": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get Best Offer by NFT": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get Collection Offers": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get Best Listing by NFT": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get All Offers by Collection": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get All Listings by Collection": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenSea Get Best Listings by Collection": {
"ai_tool": [
[
{
"node": "OpenSea Marketplace Agent",
"type": "ai_tool",
"index": 0
}
]
]
}
}
}