Delegator Summary
curl --request GET \
--url https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"aggregateEffectiveness": 0.98865,
"aprGross": 0.05,
"aprNet": 0.05,
"blendedCommissionRate": 0.05125,
"delegations": [
{
"stakePercentage": 0.1,
"validatorId": 103,
"validatorName": "Stake Capital"
},
{
"stakePercentage": 0.1,
"validatorId": 104,
"validatorName": "Coinbase Cloud"
}
],
"delegatorAddress": "0x00000",
"networkPenetration": 0.1,
"timeWindow": "30d",
"totalCommissionPaid": 112722.21532,
"totalDelegatorStake": 400995914.00753,
"totalGrossRewards": 1859026.3456,
"totalNetRewards": 1746304.13028
}{
"detail": [
{
"msg": "<string>",
"type": "<string>",
"loc": [
"<string>"
]
}
]
}Delegators
Delegator Summary
GET
/
v0
/
polygon
/
delegators
/
{delegator_address}
/
summary
Delegator Summary
curl --request GET \
--url https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"aggregateEffectiveness": 0.98865,
"aprGross": 0.05,
"aprNet": 0.05,
"blendedCommissionRate": 0.05125,
"delegations": [
{
"stakePercentage": 0.1,
"validatorId": 103,
"validatorName": "Stake Capital"
},
{
"stakePercentage": 0.1,
"validatorId": 104,
"validatorName": "Coinbase Cloud"
}
],
"delegatorAddress": "0x00000",
"networkPenetration": 0.1,
"timeWindow": "30d",
"totalCommissionPaid": 112722.21532,
"totalDelegatorStake": 400995914.00753,
"totalGrossRewards": 1859026.3456,
"totalNetRewards": 1746304.13028
}{
"detail": [
{
"msg": "<string>",
"type": "<string>",
"loc": [
"<string>"
]
}
]
}This endpoint returns high level information about a delegator over the time period such as their network penetration, rewards, annual percentage rate (APR), paid commissions, and the aggregate effectiveness of their validator delegates.
Here’s how to interpret the inputs required to operate it
| Parameter | Context |
|---|---|
| window | Window of the aggregation, with 1d, 7d, 30d and all being the supported values |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Available options:
1d, 7d, 30d, all Response
Successful Response
Available options:
1d, 7d, 30d, all Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Show child attributes
Show child attributes
Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Pattern:
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$