Governance Score

Governance score for Protocols

Retrieves the governance score for the specified protocol

get

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

Authorizations

Path parameters

protocolstringRequired

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

Responses

200

OK

application/json

404

There was an error retrieving the data.

505

Internal Server Error

get

HTTPcURLJavaScriptPython

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

{
  "status": true,
  "data": [
    {
      "score": 1,
      "timestamp": "2025-06-14T09:14:01.993Z"
    }
  ]
}

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.