Royalties Status of Multiple NFTs 💰 - /nft/royalty_status_multiple_nfts

🔍 Endpoint Summary

This endpoint retrieves the royalty status for multiple NFTs in a single request. It returns a list of dictionaries, each containing the royalty status information for a specific NFT.

📝 API Body Parameters

Parameter	Type	Description
mints	list[str]	The list of mints (i.e., unique identifiers) of the NFTs to retrieve the royalty status for.

💾 Response

The response is a list of dictionaries, each containing the following information:

[
    {
        "royalty_status": {
            "nft_mint": "abcdefg",
            "total_royalties_owed": 1000,
            "transactions": [
                {
                    "tx_id": "abcdefg",
                    "timestamp": "2022-01-01T00:00:00Z",
                    "amount": 100
                },
                ...
            ]
        }
    },
    ...
]

🔨 Example Usage

import requests

mints = ["abcdefg", "hijklmn"]

response = requests.post("https://api.example.com/nft/royalty_status_multiple_nfts", json={"mints": mints})

print(response.json())

📈 Possible Use Cases

• Retrieving the current royalty status of multiple NFTs to ensure that all owed royalties have been paid.

• Displaying the current royalty status of multiple NFTs on a marketplace or portfolio website.

• Keeping track of the total amount of royalties owed for multiple NFTs over time.