Tokenomics Score

Tokenomics score for Protocols

Retrieves the aggregated Tokenomics Score of the protocols.

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

GEThttps://api.alterscope.org/scores/tokenomics/{protocol}

Authorization

bearerAuth

Path parameters

protocol*string

the name of the protocol in lowercase

Response

200404505

OK

Body

application/json

statusboolean

dataarray of ScoreData (object)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/scores/tokenomics/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

{
  "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.