Overall Score

Overall score based on weighted formula of aggregation. Liquidity, Security, Decentralization, Tokenomics, Development, Social Score components are aggregated to calculate overall score.

Retrieves the aggregated Overall Score of the protocols.

get

This endpoint returns the aggregated Overall 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/overall/{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 the aggregated overall score of the protocols. For a comprehensive list of protocols whose data can be requested please refer to supported protocols page.

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

Sample Response

{
   "status":true,
   "data":[
      {
         "score":0.4708198194015,
         "timestamp":"2023-12-18T12:00:04Z"
      },
      {
         "score":0.46655607131899995,
         "timestamp":"2023-12-17T12:00:02Z"
      },
      {
         "score":0.47012516788075,
         "timestamp":"2023-12-16T12:00:07Z"
      },
      {
         "score":0.47001089536724994,
         "timestamp":"2023-12-15T12:00:03Z"
      },
      {
         "score":0.47107155475749996,
         "timestamp":"2023-12-14T12:00:07Z"
      },
      {
         "score":0.47139366365249996,
         "timestamp":"2023-12-13T14:02:01Z"
      },
      {
         "score":0.46844405028974995,
         "timestamp":"2023-12-12T12:00:02Z"
      }
   ]
}

Sample Response Description

score: Alterscope calculates an overall score for a cryptocurrency or blockchain project by considering various factors that contribute to its performance and viability. These factors include decentralization, social engagement, development activity, tokenomics, liquidity, and security. Know more about Alterscope score here.

timestamp: Represents the point in time when the data was recorded.