Skip to main content

Statistics

tokenviewAbout 3 min

Statistics

Get daily transfers, active accounts and new accounts by collection

GET https://services.tokenview.io/nft/{chain_abbreviation_lowercase}/blockdata/statistics/trends/{collection_address}/{time}/{data_type}?apikey={apikey}

Parameters

  • {lowercase-coin-abbr}}: eth,bsc
  • {collection_address}: the collection address you inquired
  • {time}:1m/3m/1y (Query time span: 1 month, 3 months, 1 year)
  • {date_type}: all/activeAddress/newAddress/txCount
  • {apikey}: Get your activated apikey from the API system: https://services.tokenview.ioopen in new window
Be sure to convert uppercase letters in address hashes or transaction hashes to lowercase.

Request

curl --location https://services.tokenview.io/nft/eth/blockdata/statistics/trends/0xa342f5d851e866e18ff98f351f2c6637f4478db5/1m/all?apikey={apikey}

Response

{
    "code": 1,
    "msg": "成功",
    "data": {
        "activeAddress": [
            {
                "2022-07-10": 143
            },
            {
                "2022-07-11": 128
            },
            {
                "2022-07-12": 137
            },
            {
                "2022-07-13": 124
            },
            {
                "2022-07-14": 166
            },
            {
                "2022-07-15": 200
            },
            {
                "2022-07-16": 187
            },
            {
                "2022-07-17": 212
            },
            {
                "2022-07-18": 172
            },
            {
                "2022-07-19": 114
            },
            {
                "2022-07-20": 148
            },
            {
                "2022-07-21": 207
            },
            {
                "2022-07-22": 336
            },
            {
                "2022-07-23": 274
            },
            {
                "2022-07-24": 267
            },
            {
                "2022-07-25": 298
            },
            {
                "2022-07-26": 187
            },
            {
                "2022-07-27": 239
            },
            {
                "2022-07-28": 181
            },
            {
                "2022-07-29": 401
            },
            {
                "2022-07-30": 343
            },
            {
                "2022-07-31": 183
            },
            {
                "2022-08-01": 197
            },
            {
                "2022-08-02": 170
            },
            {
                "2022-08-03": 234
            },
            {
                "2022-08-04": 140
            },
            {
                "2022-08-05": 798
            },
            {
                "2022-08-06": 145
            },
            {
                "2022-08-07": 157
            },
            {
                "2022-08-08": 145
            },
            {
                "2022-08-09": 251
            },
            {
                "2022-08-10": 86
            }
        ],
        "newAddress": [
            {
                "2022-07-10": 38
            },
            {
                "2022-07-11": 26
            },
            {
                "2022-07-12": 20
            },
            {
                "2022-07-13": 25
            },
            {
                "2022-07-14": 27
            },
            {
                "2022-07-15": 36
            },
            {
                "2022-07-16": 38
            },
            {
                "2022-07-17": 28
            },
            {
                "2022-07-18": 38
            },
            {
                "2022-07-19": 20
            },
            {
                "2022-07-20": 36
            },
            {
                "2022-07-21": 46
            },
            {
                "2022-07-22": 117
            },
            {
                "2022-07-23": 85
            },
            {
                "2022-07-24": 105
            },
            {
                "2022-07-25": 172
            },
            {
                "2022-07-26": 66
            },
            {
                "2022-07-27": 51
            },
            {
                "2022-07-28": 44
            },
            {
                "2022-07-29": 128
            },
            {
                "2022-07-30": 140
            },
            {
                "2022-07-31": 47
            },
            {
                "2022-08-01": 47
            },
            {
                "2022-08-02": 51
            },
            {
                "2022-08-03": 109
            },
            {
                "2022-08-04": 32
            },
            {
                "2022-08-05": 616
            },
            {
                "2022-08-06": 18
            },
            {
                "2022-08-07": 24
            },
            {
                "2022-08-08": 39
            },
            {
                "2022-08-09": 113
            },
            {
                "2022-08-10": 56
            }
        ],
        "txCount": [
            {
                "2022-07-10": 258
            },
            {
                "2022-07-11": 187
            },
            {
                "2022-07-12": 212
            },
            {
                "2022-07-13": 133
            },
            {
                "2022-07-14": 170
            },
            {
                "2022-07-15": 242
            },
            {
                "2022-07-16": 205
            },
            {
                "2022-07-17": 293
            },
            {
                "2022-07-18": 172
            },
            {
                "2022-07-19": 161
            },
            {
                "2022-07-20": 187
            },
            {
                "2022-07-21": 271
            },
            {
                "2022-07-22": 679
            },
            {
                "2022-07-23": 382
            },
            {
                "2022-07-24": 355
            },
            {
                "2022-07-25": 328
            },
            {
                "2022-07-26": 303
            },
            {
                "2022-07-27": 370
            },
            {
                "2022-07-28": 278
            },
            {
                "2022-07-29": 670
            },
            {
                "2022-07-30": 493
            },
            {
                "2022-07-31": 206
            },
            {
                "2022-08-01": 232
            },
            {
                "2022-08-02": 192
            },
            {
                "2022-08-03": 255
            },
            {
                "2022-08-04": 185
            },
            {
                "2022-08-05": 829
            },
            {
                "2022-08-06": 183
            },
            {
                "2022-08-07": 237
            },
            {
                "2022-08-08": 161
            },
            {
                "2022-08-09": 224
            },
            {
                "2022-08-10": 77
            }
        ]
    }
}

Response Description

  • activeAddress: daily active accounts
  • newAddress:number of new accounts added daily
  • txCount: daily trading volume

Get top 1000 collections by the number of transfers in 24 hours

GET https://services.tokenview.io/nft/{lowercase-coin-abbr}/blockdata/statistics/tokens/{type}/{page}/{page_size}?apikey={apikey}

Parameters

This interface allows to query the latest 1000 pieces of data

Be sure to convert uppercase letters in address hashes or transaction hashes to lowercase.

Request

curl --location https://services.tokenview.io/nft/eth/blockdata/statistics/tokens/all/1/10?apikey={apikey}

Response

{
    "code": 1,
    "msg": "成功",
    "data": [
        {
            "tokenAddress": "0xda4c9ffb9a96ef44865114be4af25004f0ee385d",
            "tokenName": "",
            "volume24hours": 18479,
            "volume7days": 18481,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
            "tokenName": "Ethereum Name Service",
            "volume24hours": 14793,
            "volume7days": 124268,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0x3667eeac761f764ff7d57fa869138f1f2183be69",
            "tokenName": "",
            "volume24hours": 13543,
            "volume7days": 13545,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0xe22d6d84e048f08687c087561a350a33d8af7cc1",
            "tokenName": "",
            "volume24hours": 12804,
            "volume7days": 12804,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0xd6f75a20aa64634743d40fafa88473020302c530",
            "tokenName": "Onigiri Pepes",
            "volume24hours": 12228,
            "volume7days": 12235,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0x4627fc272748b73cea8915f2f908548b593524f9",
            "tokenName": "",
            "volume24hours": 11266,
            "volume7days": 11266,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0x1cecfdba1aebc9f400fcbe1a16c02de29024ae1c",
            "tokenName": "",
            "volume24hours": 10080,
            "volume7days": 10080,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0xd493c2d5dc1315b80ea9ee210971c15f04161027",
            "tokenName": "",
            "volume24hours": 10073,
            "volume7days": 10074,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0xe7ce9069063e738d3bca9990bf09894ab907c48e",
            "tokenName": "",
            "volume24hours": 10050,
            "volume7days": 10050,
            "contractType": "RC721"
        },
        {
            "tokenAddress": "0x181350fc69826a6afe168cc6411c767fe04e1642",
            "tokenName": "",
            "volume24hours": 9777,
            "volume7days": 9777,
            "contractType": "RC721"
        }
    ]
}

Response Description

  • tokenAddress: collection contract address
  • volume24hours:24-hour transfer count
  • volume7days: 7-day transfer count
  • tokenName:collection contract name
  • contractType: RC721/RC1155

Get holders distribution by collection

GET https://services.tokenview.io/nft/{lowercase-coin-abbr}/blockdata/statistics/holders/{collection_address}/{page}/{page_size}?apikey={apikey}

Parameters

  • {lowercase-coin-abbr}: eth,bsc
  • {collection_address}: the collection address you inquired
  • {page}: page number
  • {page_size}: amount of data returned on one page
  • {apikey}: Get your activated apikey from the API system: https://services.tokenview.ioopen in new window
Be sure to convert uppercase letters in address hashes or transaction hashes to lowercase.

Request

curl --location https://services.tokenview.io/nft/eth/blockdata/statistics/holders/0xce6e3a14b5f8ce2b05af0f117dc922769779aa3b/1/10?apikey={apikey}

Response

{
    "code": 1,
    "msg": "成功",
    "data": {
        "page": 1,
        "size": 10,
        "total": 3944,
        "data": [
            {
                "quantity": 103,
                "address": "0x2306d49377bb3af4947113725ba656c816eab496",
                "ratio": 1.1588658865886587
            },
            {
                "quantity": 95,
                "address": "0x37cc41ff7f1569365216d9e01231de1b656bbbfd",
                "ratio": 1.0688568856885687
            },
            {
                "quantity": 90,
                "address": "0xe5b9dca2e82492cd97b5e26950c4cd58f33c2cc1",
                "ratio": 1.0126012601260126
            },
            {
                "quantity": 85,
                "address": "0xae9a29cfd38292de2dc7b805e505a635d9f69212",
                "ratio": 0.9563456345634564
            },
            {
                "quantity": 70,
                "address": "0x01a367d575c418ebe6e847dcfa4e09cafdb04466",
                "ratio": 0.7875787578757876
            },
            {
                "quantity": 67,
                "address": "0xfbe7a5085e0f85906f41c1bbe5e29ef8c4ca3183",
                "ratio": 0.7538253825382538
            },
            {
                "quantity": 61,
                "address": "0xee0201e07db325a5d732aeb9b9fba7b5b8e92c2a",
                "ratio": 0.6863186318631863
            },
            {
                "quantity": 53,
                "address": "0x41e3faab16624921d2b43f2c82acfac0e6240a15",
                "ratio": 0.5963096309630963
            },
            {
                "quantity": 46,
                "address": "0x71deb5a24f1a2d67d173666c46c03649252228e6",
                "ratio": 0.5175517551755175
            },
            {
                "quantity": 44,
                "address": "0xe5179c7cc6a3ca5e1c2aabd63a93499eb6d41c40",
                "ratio": 0.49504950495049505
            }
        ]
    }
}

Response Description

  • page: page number
  • size: amount of data returned on one page
  • total: total number of data
  • data: holder info
    • quantity: number of holding nftids
    • address: holder address
    • ratio: holding percentage of total supply

Get total holder count by collection

GET https://services.tokenview.io/nft/{lowercase-coin-abbr}/blockdata/statistics/holders/{collection_address}/holderscount?apikey={apikey}

Parameters

Be sure to convert uppercase letters in address hashes or transaction hashes to lowercase.

Request

curl --location https://services.tokenview.io/nft/eth/blockdata/statistics/holders/0x36b8b2763350a2fc7bc583466f15cb8325004a15/holderscount?apikey={apikey}

Response

{
    "code": 1,
    "msg": "成功",
    "data": 1149
}

Response Description

  • data: total number of holders
Last update: