As requested on GitLab, I have added a new plug to Plug & Play, that brings endpoints for vesting delegations. This complements the current API condenser_api.get_vesting_delegations, which only returns outgoing delegations. Now you can get data about incoming delegations, plus historical delegation data, both incoming and outgoing, for a specified account.
I have deployed the API here: https://deleg.hpp.freebeings.io
Anyone can run a server with the same API by installing HAF Plug & Play and running the service with the deleg plug enabled. I will post a detailed tutorial shortly on how to use Plug & Play to run available plugs and also how to write code to add new plugs that process specific Hive operations.
The following endpoints are avaialble on the server.
This returns a summary of vesting delegation balances for an account, incoming and outgoing, at the time of request.
It takes one parameter: account; which is the name of the Hive account you want to lookup.
Example request:
curl -X 'GET' \
'https://deleg.hpp.freebeings.io/api/deleg/account?account=imwatsi' \
-H 'accept: application/json'
Or
https://deleg.hpp.freebeings.io/api/deleg/account?account=imwatsi
Example response body:
{
"account": "imwatsi",
"balances": {
"in": 0,
"out": 303499.927927
}
}
Get a list of delegations that are currently given to an account.
Paramaters:
accountlimitExample request:
curl -X 'GET' \
'https://deleg.hpp.freebeings.io/api/deleg/in?account=imwatsi.test&limit=100' \
-H 'accept: application/json'
Or
https://deleg.hpp.freebeings.io/api/deleg/in?account=imwatsi.test&limit=100
Example response body:
[
{
"id": 1261821,
"delegator": "imwatsi",
"amount": 39451.307672
}
]
Get a list of outgoing delegations from an account.
Paramaters:
accountlimitExample request:
curl -X 'GET' \
'https://deleg.hpp.freebeings.io/api/deleg/out?account=imwatsi&limit=100' \
-H 'accept: application/json'
Or
https://deleg.hpp.freebeings.io/api/deleg/out?account=imwatsi&limit=100
Example response body:
[
{
"id": 1261821,
"delegator": "imwatsi.test",
"amount": 39451.307672
},
{
"id": 1311023,
"delegator": "billz-00",
"amount": 9664.017574
},
{
"id": 1335826,
"delegator": "hichem.test",
"amount": 18908.004815
}
...
]
Get a list of historical incoming delegations to an account.
Paramaters:
accountlimit: default 100descending: default trueExample request:
curl -X 'GET' \
'https://deleg.hpp.freebeings.io/api/deleg/history/in?account=imwatsi&limit=100&descending=true' \
-H 'accept: application/json'
Or
https://deleg.hpp.freebeings.io/api/deleg/history/in?account=imwatsi&limit=100&descending=true
Example response body:
[
{
"id": 8435728,
"created": "2022-08-19T21:46:48",
"delegator": "blocktrades.com",
"amount": 160335.403108
},
{
"id": 8435518,
"created": "2022-08-19T19:36:36",
"delegator": "blocktrades.com",
"amount": 500870.91407
},
...
]
Get a list of historical outgoing delegations to an account.
Paramaters:
accountlimit: default 100descending: default trueExample request:
curl -X 'GET' \
'https://deleg.hpp.freebeings.io/api/deleg/history/out?account=imwatsi&limit=100&descending=true' \
-H 'accept: application/json'
Or
https://deleg.hpp.freebeings.io/api/deleg/history/out?account=imwatsi&limit=100&descending=true
Example response body:
[
{
"id": 8547257,
"created": "2022-08-23T12:20:00",
"delegator": "nicolemokhethi",
"amount": 30000
},
{
"id": 8286482,
"created": "2022-07-02T15:12:33",
"delegator": "freebeings",
"amount": 54695.297887
},
{
"id": 7850258,
"created": "2022-04-24T16:36:45",
"delegator": "squigglez",
"amount": 30000
},
...
]
Since it is a new release, I will wait for community feedback to determine what new features/modifications I should work on. Feel free to test it out and give feedback.
by
Witness Name:
We're glad to be building on Hive.
Follow the 