Actions5
Overview
This node integrates with the PaintSwap NFT marketplace to retrieve and analyze NFT sales data. Specifically, the "Get NFT Sales By Seller" operation fetches all NFT sales made by a particular seller address within a specified NFT collection. This is useful for tracking a seller's activity, analyzing their sales history, or monitoring market trends related to specific sellers.
Practical examples include:
- Monitoring a known seller’s recent NFT sales to evaluate their market behavior.
- Aggregating sales data for analytics or reporting purposes.
- Integrating seller sales data into broader NFT portfolio management workflows.
Properties
| Name | Meaning |
|---|---|
| Seller Address | Ethereum address of the seller whose NFT sales you want to retrieve. |
| Collection Address | Ethereum address of the NFT collection contract to filter sales within that collection. |
| Number to Fetch | Number of sales records to fetch, up to a maximum of 1000. |
| Order Direction | Direction to order the retrieved sales: either Ascending (oldest first) or Descending (newest first). |
| Options | Additional options: • Simplify Output: Boolean flag to return a simplified response containing only essential fields. |
Output
The output is an array of JSON objects representing individual NFT sales by the specified seller in the given collection. Each object contains detailed information about a sale, such as token details, sale price, timestamp, and buyer information.
If the "Simplify Output" option is enabled, the response includes only key fields to reduce complexity and focus on essential data.
No binary data is output by this operation.
Dependencies
- Requires access to the PaintSwap NFT marketplace API.
- An optional API authentication token or API key credential may be configured in n8n to enable authenticated requests.
- The node depends on internal helper functions imported from bundled actions to perform API calls and data processing.
Troubleshooting
Common Issues:
- Invalid or incorrectly formatted Ethereum addresses for seller or collection will cause errors.
- Requesting more than 1000 sales may result in truncated results or API errors.
- Network connectivity issues can prevent successful API calls.
Error Messages:
"The operation \"getNftSalesBySeller\" is not supported!"— indicates an unsupported operation was requested; ensure the correct operation name is selected.- API errors related to invalid credentials or rate limits may occur if authentication is misconfigured or usage exceeds allowed quotas.
Resolutions:
- Verify Ethereum addresses are valid and correctly input.
- Limit the number of sales fetched to 1000 or fewer.
- Configure proper API authentication credentials in n8n if required.
- Check network connectivity and retry failed requests.