PaintSwap icon

PaintSwap

Interact with PaintSwap NFT marketplace

Actions5

Overview

The node interacts with the PaintSwap NFT marketplace to perform various operations related to NFT sales and market data. Specifically, the "Calculate Collection Floor Price" operation calculates the floor price of an NFT collection on Ethereum, considering a tolerance percentage above the floor price to define a price range. This is useful for users who want to understand the minimum market value of NFTs within a collection while allowing some flexibility above the absolute lowest price.

Practical examples:

  • An NFT trader wants to quickly find the floor price of a specific NFT collection to decide on buying or selling strategies.
  • A collector wants to monitor the floor price range of their favorite collection to track market trends.
  • A developer building an NFT analytics dashboard needs to display floor prices with configurable tolerance ranges.

Properties

Name Meaning
Collection Address Ethereum address of the NFT collection contract to analyze.
Tolerance Percentage The percentage above the floor price to include in the floor price range (default 20%).

Output

The output JSON contains the calculated floor price information for the specified NFT collection. It includes the floor price itself and a price range that extends above the floor price by the given tolerance percentage. This allows users to see not just the absolute lowest price but also a practical range reflecting slightly higher prices considered near-floor.

No binary data output is indicated for this operation.

Dependencies

  • Requires access to the PaintSwap NFT marketplace API.
  • Optionally requires an API key credential configured in n8n for PaintSwap, though it is marked as not strictly required.
  • The node depends on internal helper functions imported from a bundled actions module to perform the actual API calls and calculations.

Troubleshooting

  • Common issues:

    • Invalid or empty collection address input may cause errors or no results.
    • Network or API connectivity problems can lead to request failures.
    • If the collection has no sales data, the floor price calculation might return empty or zero values.

  • Error messages:

    • "The operation \"calculateFloorPrice\" is not supported!" — indicates a misconfiguration or unsupported operation selection.
    • API-related errors will be returned in the output JSON under an error field if "Continue On Fail" is enabled.

  • Resolutions:

    • Ensure the collection address is correctly formatted as an Ethereum address.
    • Verify network connectivity and API credentials if used.
    • Check if the collection actually has sales data on PaintSwap.

Links and References

Discussion