DPOPS
Note zachys (atomic units) are 10^6 in X-Cash

Stats

This method gets the stats
Method: GET
Inputs: None.
Results:
  • mostTotalRoundsDelegateName - string; The delegate name that has participated in the most X-Cash DPOPS rounds.
  • mostTotalRounds - unsigned int; The most total rounds.
  • bestBlockVerifierOnlinePercentageDelegateName - string; The delegate with the best online percentage.
  • bestBlockVerifierOnlinePercentage - unsigned int; The best online percentage.
  • mostBlockProducerTotalRoundsDelegateName - string; The delegate will the most block producer rounds.
  • mostBlockProducerTotalRounds - unsigned int; Total most block producer rounds.
  • totalVotes - unsigned long long; Total votes in zachys (atomic units).
  • totalVoters - unsigned int; Total voters.
  • averageVote - unsigned int; Average vote amount in zachys (atomic units).
  • votePercentage - unsigned int; The percentage of the amount of xcash ciruclating compared to how much is being voted.
  • roundNumber - unsigned int; The round number of X-Cash DPOPS.
  • totalRegisteredDelegates - unsigned int; Total registered delegates.
  • totalOnlineDelegates - unsigned int; Total online delegates.
  • currentBlockVerifiersMaximumAmount - unsigned int; The current amount of delegates that the system will use.
  • currentBlockVerifiersValidAmount - unsigned int; The current amount of delegates that is needed for verification.
1
$ curl -X GET https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/stats/ -H 'Accept: application/json'
2
{
3
"mostTotalRoundsDelegateName": "europe3_xcash_foundation",
4
"mostTotalRounds": 121528,
5
"bestBlockVerifierOnlinePercentageDelegateName": "OnlyOne",
6
"bestBlockVerifierOnlinePercentage": 100,
7
"mostBlockProducerTotalRoundsDelegateName": "snakeway",
8
"mostBlockProducerTotalRounds": 2899,
9
"totalVotes": 38436931311445482,
10
"totalVoters": 1000,
11
"averageVote": 38436931311445,
12
"votePercentage": 57,
13
"roundNumber": 131677,
14
"totalRegisteredDelegates": 150,
15
"totalOnlineDelegates": 100,
16
"currentBlockVerifiersMaximumAmount": 50,
17
"currentBlockVerifiersValidAmount": 27
18
}
Copied!

Registered Delegates

This method gets all of the registered delegates
Method: GET
Inputs: None.
Results:
Array of objects with the following structure:
  • votes - unsigned long long; Total votes in zachys (atomic units).
  • voters - unsigned int; Total voters.
  • IPAdress - string; The IP address or domain name.
  • delegateName - string; The delegate name.
  • sharedDelegate - bool;
  • seedNode - bool;
  • online - bool;
  • fee - unsigned int; The fee.
  • totalRounds - unsigned int; Total rounds.
  • totalBlockProducerRounds - unsigned int; Total block producer rounds.
  • onlinePercentage - unsigned int; The online percentage.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/registered/ -H 'Accept: application/json'
2
[
3
{
4
"votes": 100000000,
5
"voters": 10,
6
"IPAdress": "us1.xcash.foundation",
7
"delegateName": "us1_xcash_foundation",
8
"sharedDelegate": false,
9
"seedNode": true,
10
"online": true,
11
"fee": 0,
12
"totalRounds": 100,
13
"totalBlockProducerRounds": 10,
14
"onlinePercentage": 67
15
},
16
{
17
"votes": 0,
18
"voters": 10,
19
"IPAdress": "europe1.xcash.foundation",
20
"delegateName": "europe1_xcash_foundation",
21
"sharedDelegate": true,
22
"seedNode": false,
23
"online": true,
24
"fee": 5,
25
"totalRounds": 100,
26
"totalBlockProducerRounds": 10,
27
"onlinePercentage": 99
28
}
29
]
Copied!

Online Delegates

This method gets all of the online delegates
Method: GET
Inputs: None.
Results:
Array of objects with the following structure:
  • votes - unsigned long long; Total votes in zachys (atomic units).
  • voters - unsigned int; Total voters.
  • IPAdress - string; The IP address or domain name.
  • delegateName - string; The delegate name.
  • sharedDelegate - bool;
  • seedNode - bool;
  • online - bool;
  • fee - unsigned int; The fee.
  • totalRounds - unsigned int; Total rounds.
  • totalBlockProducerRounds - unsigned int; Total block producer rounds.
  • onlinePercentage - unsigned int; The online percentage.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/online/ -H 'Accept: application/json'
2
[
3
{
4
"votes": 100000000,
5
"voters": 10,
6
"IPAdress": "us1.xcash.foundation",
7
"delegateName": "us1_xcash_foundation",
8
"sharedDelegate": false,
9
"seedNode": true,
10
"online": true,
11
"fee": 0,
12
"totalRounds": 100,
13
"totalBlockProducerRounds": 10,
14
"onlinePercentage": 67
15
},
16
{
17
"votes": 0,
18
"voters": 10,
19
"IPAdress": "europe1.xcash.foundation",
20
"delegateName": "europe1_xcash_foundation",
21
"sharedDelegate": true,
22
"seedNode": false,
23
"online": true,
24
"fee": 5,
25
"totalRounds": 100,
26
"totalBlockProducerRounds": 10,
27
"onlinePercentage": 99
28
}
29
]
Copied!

Active Delegates

This method gets the current active delegates (top 50) during the round
Method: GET
Inputs: None.
Results:
Array of objects with the following structure:
  • votes - unsigned long long; Total votes in zachys (atomic units).
  • voters - unsigned int; Total voters.
  • IPAdress - string; The IP address or domain name.
  • delegateName - string; The delegate name.
  • sharedDelegate - bool;
  • seedNode - bool;
  • online - bool;
  • fee - unsigned int; The fee.
  • totalRounds - unsigned int; Total rounds.
  • totalBlockProducerRounds - unsigned int; Total block producer rounds.
  • onlinePercentage - unsigned int; The online percentage.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/active/ -H 'Accept: application/json'
2
[
3
{
4
"votes": 100000000,
5
"voters": 10,
6
"IPAdress": "us1.xcash.foundation",
7
"delegateName": "us1_xcash_foundation",
8
"sharedDelegate": false,
9
"seedNode": true,
10
"online": true,
11
"fee": 0,
12
"totalRounds": 100,
13
"totalBlockProducerRounds": 10,
14
"onlinePercentage": 67
15
},
16
{
17
"votes": 0,
18
"voters": 10,
19
"IPAdress": "europe1.xcash.foundation",
20
"delegateName": "europe1_xcash_foundation",
21
"sharedDelegate": true,
22
"seedNode": false,
23
"online": true,
24
"fee": 5,
25
"totalRounds": 100,
26
"totalBlockProducerRounds": 10,
27
"onlinePercentage": 99
28
}
29
]
Copied!

Delegates

This method gets the delegates data
Method: GET
Resources:
  • delegateName - Required - The delegates name.
Inputs: None.
Results:
  • votes - unsigned long long; Total votes in zachys (atomic units).
  • voters - unsigned int; Total voters.
  • IPAdress - string; The IP address or domain name.
  • delegateName - string; The delegate name.
  • publicAddress - string; The public address.
  • about - string; about.
  • website - string; website.
  • team - string; team.
  • specifications - string; server Specifications.
  • sharedDelegate - bool;
  • seedNode - bool;
  • online - bool;
  • fee - unsigned int; The fee.
  • totalRounds - unsigned int; Total rounds.
  • totalBlockProducerRounds - unsigned int; Total block producer rounds.
  • onlinePercentage - unsigned int; The online percentage.
  • rank - unsigned int; The delegates current rank.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/us1_xcash_foundation/ -H 'Accept: application/json'
2
{
3
"votes": 100000000,
4
"voters": 10,
5
"IPAdress": "us1.xcash.foundation",
6
"delegateName": "us1_xcash_foundation",
7
"publicAddress": "XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf",
8
"about": "",
9
"website": "",
10
"team": "",
11
"specifications": "",
12
"sharedDelegate": false,
13
"seedNode": true,
14
"online": true,
15
"fee": 0,
16
"totalRounds": 100,
17
"totalBlockProducerRounds": 10,
18
"onlinePercentage": 67,
19
"rank": 1
20
}
Copied!

Delegate Rounds Stats

This method gets the stats about the blocks the delegate produced
Method: GET
Resources:
  • delegateName - Required - The delegate name.
Inputs: None.
Results:
  • totalBlocksProduced - unsigned int; The total blocks produced by the delegate
  • totalBlockRewards - unsigned long long; The total xcash from the blocks produced in zachys (atomic units).
  • averagePercentage - unsigned int; The average the delegate has produced a block. (100 is average, 200 is twice as good etc etc)
  • averageTime - unsigned int; The average time (in minutes) it takes for the delegate to produce a block.
  • blocksProduced - an arrray with the following structure:
    • blockHeight - unsigned int; The block height.
    • blockReward - unsigned long long; The block reward in zachys (atomic units).
    • time - unsigned int; The time stamp.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/rounds/us1_xcash_foundation/ -H 'Accept: application/json'
2
{
3
"totalBlocksProduced": 100,
4
"totalBlockRewards": 1000000000,
5
"averagePercentage": 100,
6
"averageTime": 500,
7
"blocksProduced": [
8
{
9
"blockHeight": 810000,
10
"blockReward": 100000000,
11
"time": 1654228489
12
},
13
{
14
"blockHeight": 811000,
15
"blockReward": 100000000,
16
"time": 1654228489
17
}
18
]
19
}
Copied!

Delegates Votes

This method gets the vote data for a delegate
Method: GET
Resources:
  • delegateName - Required - The delegate name.
  • start - Required - The start item to return data (0 is the first item).
  • limit - Required - The maximum amount of items to return (Maximum of 1000).
Inputs: None.
Results:
An array of objects with the following structure:
  • publicAddress - string; The public address who created the vote.
  • amount - unsigned long long; The vote amount in zachys (atomic units).
  • reserveProof - string; The reserve proof.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/delegates/votes/{delegateName}/1/2/ -H 'Accept: application/json'
2
[
3
{
4
"publicAddress": "XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf",
5
"amount": 1000000000,
6
"reserveProof": "ReserveProofV1"
7
},
8
{
9
"publicAddress": "XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf",
10
"amount": 1000000000,
11
"reserveProof": "ReserveProofV1"
12
}
13
]
Copied!

Vote Details

This method gets the vote data from a specific address
Method: GET
Resources:
  • address - Required - The public address.
Inputs: None.
Results:
  • delegateName - string; The delegate name voted for.
  • amount - unsigned long long; The vote amount in zachys (atomic units).
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/votes/XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf/ -H 'Accept: application/json'
2
{
3
"delegateName": "us1_xcash_foundation",
4
"amount": 1000000000
5
}
Copied!

Round Details

This method gets the round details
Method: GET
Resources:
  • blockHeight - Required - The block height for the round.
Inputs: None.
Results:
An array of delegate names that verified the block
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/rounds/810000/ -H 'Accept: application/json'
2
{
3
"delegates": [
4
"us1_xcash_foundation",
5
"europe1_xcash_foundation"
6
]
7
}
Copied!

Last Block Producer

This method gets the last block producer
Method: GET
Inputs: None.
Results:
  • lastBlockProducer - The last block producer.
1
$ curl -X GET https://api.xcash.foundation/v1/xcash/dpops/unauthorized/lastBlockProducer/ -H 'Accept: application/json'
2
{
3
"lastBlockProducer": "us1_xcash_foundation"
4
}
Copied!