---
updatedAt: 2025-06-25T21:54:36.000Z
agentTools:
  projectIndex: https://docs.nftgo.io/llms.txt
---

# Get royalty by NFT

Return NFT royalty given the nft contract address and token id.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "egg-swagger",
    "description": "swagger-ui for egg",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://data-api.nftgo.io"
    }
  ],
  "tags": [
    {
      "name": "NFT",
      "description": ""
    }
  ],
  "paths": {
    "/eth/v1/nft/{contract_address}/{token_id}/royalty": {
      "get": {
        "tags": [
          "NFT"
        ],
        "summary": "Get royalty by NFT ",
        "description": "Return NFT royalty given the nft contract address and token id. ",
        "operationId": "eth_v1_nft_{contract_address}_{token_id}_royalty",
        "parameters": [
          {
            "name": "contract_address",
            "in": "path",
            "description": "Address of the NFT contract ",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
          },
          {
            "name": "token_id",
            "in": "path",
            "description": "The token ID for this NFT. Each item in an NFT collection will be assigned a unique id. ",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "4096"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response ",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetRoyaltyByNftResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "GetRoyaltyByNftResponse": {
        "required": [
          "outstanding_royalty_income",
          "royalty_income",
          "theoretical_maximum_royalty_income"
        ],
        "type": "object",
        "properties": {
          "royalty_income": {
            "$ref": "#/components/schemas/eth_usd_value"
          },
          "theoretical_maximum_royalty_income": {
            "$ref": "#/components/schemas/eth_usd_value"
          },
          "outstanding_royalty_income": {
            "$ref": "#/components/schemas/eth_usd_value"
          }
        }
      },
      "eth_usd_value": {
        "required": [
          "eth",
          "usd"
        ],
        "type": "object",
        "properties": {
          "eth": {
            "type": "number",
            "description": "The value of ETH.",
            "example": 100
          },
          "usd": {
            "type": "number",
            "description": "The value of USD.",
            "example": 100
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}
```