Royalties Status by Address 💰 - /nft/royalty_status_address/{address}

🔍 Endpoint Summary

This endpoint retrieves the royalty status for a given address. It returns a dictionary containing the address and the royalty status for that address.

📝 API Path Parameters

ParameterTypeDescription

address

str

The address to retrieve the royalty status for.

💾 Response

The response is a dictionary containing the following information:

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

🔨 Example Usage

import requests

address = "abcdefg"

response = requests.get(f"https://api.example.com/nft/royalty_status_address/{address}")

print(response.json())

📈 Possible Use Cases

  • Retrieving the current royalty status for a specific address to ensure that all owed royalties have been paid.

  • Displaying the current royalty status for a specific address on a marketplace or portfolio website.

  • Keeping track of the total amount of royalties owed for a specific address over time.

Last updated