Actions10
Get Collection Sales
AI-generatedOverview
This node operation fetches sales data for NFTs within a specified collection on the PaintSwap marketplace. It allows users to retrieve detailed sales information filtered by collection address and optionally by specific token IDs. Users can control the number of sales fetched and the order direction (ascending or descending). This operation is useful for analyzing market activity, tracking sales trends, or monitoring specific NFTs within a collection.
Use Case Examples
- A user wants to analyze recent sales in a particular NFT collection to understand market trends.
- A collector wants to track sales of specific token IDs within a collection to monitor their value.
Properties
| Name | Meaning |
|---|---|
| Collection Address | Ethereum address of the NFT collection contract to fetch sales from. |
| Token IDs | Optional comma-separated list of token IDs to include in the sales results. |
| Number to Fetch | Number of sales records to retrieve, with a maximum of 1000. |
| Order Direction | Direction to order the sales data, either ascending or descending. |
| Options | Additional options such as whether to simplify the output to essential fields only. |
Output
JSON
json- The sales data for the specified NFT collection, potentially filtered and ordered as requested.
Dependencies
- Requires an Ethereum JSON-RPC provider URL and optionally a private key for authenticated operations if needed.
Troubleshooting
- Ensure the collection address is a valid Ethereum address; invalid addresses will cause errors.
- If token IDs are provided, ensure they are correctly formatted as a comma-separated string without spaces.
- The maximum number of sales to fetch is 1000; requesting more may result in errors or truncated data.
- If the node throws an error about unsupported operations, verify the operation parameter is set to 'getCollectionSales'.
- Network or RPC provider issues may cause failures; verify connectivity and credentials.