Holders Metrics

This endpoint retrieves historical data on the number of unique holders for different stablecoins. It provides information on how distributed the ownership of each stablecoin is, which can be an indicator of its decentralization and adoption. This data is valuable for assessing the long-term sustainability and potential network effects of different stablecoins.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

group_by

enum<string>

required

The parameter to group the holders points by. Options are 'asset', 'tokens', 'network', 'peggedCurrency', or 'jurisdictionCountry'.

Allowed values:

assettokensnetworkpeggedCurrencyjurisdictionCountry

Header Params

Authorization

string

optional

Responses

🟢200Successful response with Holders points

application/json

Body

data

array [object {2}]

optional

meta_info

object

optional

point

array [object {2}]

optional

Example

{
    "data": [
        {
            "meta_info": {
                "name": "USDT",
                "color": "#26A17B"
            },
            "point": [
                {
                    "x": "2023-01-01",
                    "y": 5000000
                },
                {
                    "x": "2023-02-01",
                    "y": 5200000
                },
                {
                    "x": "2023-03-01",
                    "y": 5400000
                },
                {
                    "x": "2023-04-01",
                    "y": 5600000
                }
            ]
        },
        {
            "meta_info": {
                "name": "USDC",
                "color": "#2775CA"
            },
            "point": [
                {
                    "x": "2023-01-01",
                    "y": 4000000
                },
                {
                    "x": "2023-02-01",
                    "y": 4150000
                },
                {
                    "x": "2023-03-01",
                    "y": 4300000
                },
                {
                    "x": "2023-04-01",
                    "y": 4450000
                }
            ]
        }
    ]
}

🟠400Bad request due to invalid query parameter

🔴500Internal server error

Request

Request samples

Responses