Governance Score

Governance score for Protocols

Retrieves the governance score for the specified protocol

This endpoint fetches the governance score for the specified protocol for the last 7 days.

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

Authorization

BearerAuth

Path parameters

protocol*string

The name of the protocol for which governance score will be fetched (in lowercase)

Response

200404505

OK

Body

application/json

statusboolean

dataarray of DataItem (object)

Request

JavaScriptCurl

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

Response

{
  "status": false,
  "data": [
    {
      "score": 0,
      "timestamp": "2024-05-14T11:20:20.295Z"
    }
  ]
}

Sample Request

The sample request below retrieves governance score data for the aave protocol for last 7 days.

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

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

Sample Response

{
   "status":true,
   "data":[
      {
         "score":0.015205467198526291,
         "timestamp":"2023-12-20T12:00:42Z"
      },
      {
         "score":0.016252412969506184,
         "timestamp":"2023-12-19T12:00:42Z"
      },
      {
         "score":0.016809456212394425,
         "timestamp":"2023-12-18T12:00:44Z"
      },
      {
         "score":0.016592931593028024,
         "timestamp":"2023-12-17T12:00:49Z"
      },
      {
         "score":0.016739279667186028,
         "timestamp":"2023-12-16T12:00:46Z"
      },
      {
         "score":0.015475361813625903,
         "timestamp":"2023-12-15T12:01:05Z"
      },
      {
         "score":0.015475361813625903,
         "timestamp":"2023-12-15T11:20:18Z"
      },
      {
         "score":0.01705700377926672,
         "timestamp":"2023-12-14T12:00:40Z"
      }
   ]
}

Sample Response Description

score: See how Governance score is calculated here.

timestamp: Date and Time associated with the data.