delegations_api

Module Group: Accounts
Parsing Order: 330
Database Size: 1.877 GB

The delegations_api provides access to vesting (STEEM POWER) delegation information including current and historical delegations.

---

Configuration

{
   "db_path": "~/sds_data1",
   "id": "delegations_api",
   "group_id": "accounts",
   "parsing_order": 330,
   "required_modules": ["chain_api"],
   "parse_reversible": true,
   "store_history": true,
   "parsed_ops": [
      "account_create_with_delegation",
      "delegate_vesting_shares"
   ]
}

---

Endpoints

getConfig

Returns this module's active configuration.

Endpoint

/delegations_api/getConfig

---

Current Delegations

getOutgoingDelegations

Returns delegations made by an account to others.

Endpoint

/delegations_api/getOutgoingDelegations/:account/:limit?/:offset?

Example

/delegations_api/getOutgoingDelegations/steemchiller

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"time": 0, "from": 1, "to": 2, "vests": 3},
      "rows": [
         [1751604930, "steemchiller", "nadriah", 41655.978549],
         [1761382662, "steemchiller", "misslaila", 165249.312854],
         [1765094307, "steemchiller", "burnup", 8236.931936]
      ]
   }
}

@steemchiller's Outgoing Delegations:

To	VESTS	STEEM Power (approx)
misslaila	165,249	~100 SP
nadriah	41,655	~25 SP
burnup	8,236	~5 SP
Total	215,142	~130 SP

---

getIncomingDelegations

Returns delegations received by an account from others.

Endpoint

/delegations_api/getIncomingDelegations/:account/:limit?/:offset?

Example

/delegations_api/getIncomingDelegations/steemchiller

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"time": 0, "from": 1, "to": 2, "vests": 3},
      "rows": [
         [1513374402, "alexvan", "steemchiller", 412113.874601],
         [1585680279, "drax", "steemchiller", 76336.407426],
         [1733141934, "dev.supporters", "steemchiller", 84645052.099474],
         [1746105690, "puss.coin", "steemchiller", 252237802.089317],
         [1741852704, "atego", "steemchiller", 6956888.772969],
         [1758299181, "realrobinhood", "steemchiller", 12472967.351969],
         [1753032192, "dhaka.witness", "steemchiller", 416051.126871],
         [1767466239, "remlaps-pb", "steemchiller", 241775.025783],
         [1765071981, "hardphotographer", "steemchiller", 217050.477342]
      ]
   }
}

@steemchiller's Top Incoming Delegations:

From	VESTS	STEEM Power (approx)
puss.coin	252,237,802	~153,400 SP
dev.supporters	84,645,052	~51,500 SP
realrobinhood	12,472,967	~7,600 SP
atego	6,956,888	~4,200 SP
Total (16 delegators)	357,736,916	~217,700 SP

Column Definitions:

Column	Description
time	When delegation was made (Unix timestamp)
from	Delegating account
to	Receiving account
vests	Amount of VESTS delegated

---

getExpiringDelegations

Returns delegations that are expiring (being returned after undelegation).

Endpoint

/delegations_api/getExpiringDelegations/:account/:limit?/:offset?

Example

/delegations_api/getExpiringDelegations/steemchiller

Example Response:

{
   "code": 0,
   "result": {
      "cols": {},
      "rows": []
   }
}

Empty result means no delegations are currently expiring.

---

Historic Delegations

getDelegationHistory

Returns historical delegation activity based on a query.

Endpoint

/delegations_api/getDelegationHistory/:query/:limit?/:offset?

Parameters

Name	Type	Optional	Description
:query	JSON	No	Query filter as JSON string
:limit	int	Yes	Maximum results
:offset	int	Yes	Result offset

Query Format:

{
   "from": "account_name",
   "to": "account_name",
   "fromTime": 1704067200,
   "toTime": 1767630000
}

Result: JSON Array of historical delegation records

---

Back to Main Index