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.

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

get

/scores/overall/{protocol}

Authorizations

Path parameters

protocolstringrequired

the name of the protocol in lowercase

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alterscope.org/scores/overall/{protocol}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

404

505

200

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

OK

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.