Tokenomics Score

Tokenomics score for Protocols

Retrieves the aggregated Tokenomics Score of the protocols.

get

This endpoint returns the aggregated Tokenomics Score of the protocols from the last 7 days.

Authorizations

Path parameters

protocolstringRequired

the name of the protocol in lowercase

Responses

200

OK

application/json

404

There is no data for the provided `protocol`

505

Internal Server Error

get

HTTPcURLJavaScriptPython

GET /scores/tokenomics/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": true,
  "data": [
    {
      "score": 0.22448096615490729,
      "timestamp": "2023-09-11T12:00:06Z"
    }
  ]
}

Sample Request

The sample request below retrieves tokenomics score data of compound protocol for past 7 days.

curl https://api.alterscope.org/scores/tokenomics/compound -H "Authorization: Bearer <your_access_token>"

For a comprehensive list of protocols whose tokenomics score data can be requested please refer to supported protocols page.

Sample Response

The sample response below will display tokenomics score data of corresponding protocol for the past 7 days with their timestamps.

{
   "status":true,
   "data":[
      {
         "score":0.19823561395656625,
         "timestamp":"2023-12-20T12:00:13Z"
      },
      {
         "score":0.20864943572484346,
         "timestamp":"2023-12-19T12:00:13Z"
      },
      {
         "score":0.20827442006524954,
         "timestamp":"2023-12-18T12:00:13Z"
      },
      {
         "score":0.1719019210056321,
         "timestamp":"2023-12-17T12:00:16Z"
      },
      {
         "score":0.1342998127316335,
         "timestamp":"2023-12-16T12:00:11Z"
      },
      {
         "score":0.15483719450749484,
         "timestamp":"2023-12-15T12:00:13Z"
      },
      {
         "score":0.1515722655789392,
         "timestamp":"2023-12-15T11:12:07Z"
      },
      {
         "score":0.2182787022894574,
         "timestamp":"2023-12-15T07:46:04Z"
      },
      {
         "score":0.20376767733292686,
         "timestamp":"2023-12-14T12:01:10Z"
      }
   ]
}

Sample Response Description

score: See how tokenomics score is calculated here. timestamp: Date and Time associated with the data.