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

# Get royalty chart by contract

Return a chart displaying the historical royalty volumes of an NFT contract over a given time range, indexed by time. The time interval is fixed to daily.

# 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": "Chart",
      "description": ""
    }
  ],
  "paths": {
    "/eth/v1/chart/{contract_address}/royalty": {
      "get": {
        "tags": [
          "Chart"
        ],
        "summary": "Get royalty chart by contract ",
        "description": "Return a chart displaying the historical royalty volumes of an NFT contract over a given time range, indexed by time. The time interval is fixed to daily. ",
        "operationId": "eth_v1_chart_{contract_address}_royalty",
        "parameters": [
          {
            "name": "contract_address",
            "in": "path",
            "description": "Address of the NFT contract ",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
          },
          {
            "name": "start_time",
            "in": "query",
            "description": "Queries can be bounded by a Start Time and End Time. Start Time is the earliest timestamp to include in the transaction query, formatted as an UTC timestamp in seconds, such as 1655683200. ",
            "required": true,
            "schema": {
              "type": "number"
            },
            "example": 1655683200
          },
          {
            "name": "end_time",
            "in": "query",
            "description": "Where an End Time is specified, transaction queries will fetch all transactions up to but excluding the End Time, which is formatted as an UTC timestamp in seconds. The query window varies according to the plan. ",
            "required": true,
            "schema": {
              "type": "number"
            },
            "example": 1655783200
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response ",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetRoyaltyChartByCollectionResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "contract_daily_royalty_metrics": {
        "required": [
          "payer_num",
          "royalty_income"
        ],
        "type": "object",
        "properties": {
          "payer_num": {
            "type": "number",
            "description": "Number of royalty payers",
            "example": 1
          },
          "royalty_income": {
            "$ref": "#/components/schemas/eth_usd_value"
          }
        }
      },
      "GetRoyaltyChartByCollectionResponse": {
        "required": [
          "x",
          "y"
        ],
        "type": "object",
        "properties": {
          "x": {
            "type": "array",
            "description": "List of timestamps in seconds",
            "items": {
              "type": "number"
            }
          },
          "y": {
            "type": "array",
            "description": "The royalty income of each time point",
            "items": {
              "$ref": "#/components/schemas/contract_daily_royalty_metrics"
            }
          }
        }
      },
      "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": []
    }
  ]
}
```