witnesses_api

Module Group: Accounts
Parsing Order: 380
Database Size: 0.031 GB

The witnesses_api provides comprehensive information about Steem witnesses including rankings, votes, proxies, and missed blocks.

---

Configuration

{
   "id": "witnesses_api",
   "group_id": "accounts",
   "parsing_order": 380,
   "required_modules": ["chain_api", "accounts_api"],
   "data_source_contents": ["witnesses"],
   "parse_reversible": true,
   "parsed_ops": [
      "witness_update",
      "account_witness_vote",
      "account_witness_proxy"
   ],
   "available_events": ["onSyncWitness"],
   "event_handlers": ["accounts_api.onSyncAccount"]
}

---

Endpoints

getConfig

Returns this module's active configuration.

Endpoint

/witnesses_api/getConfig

---

Witnesses

getWitness

Returns detailed witness information.

Endpoint

/witnesses_api/getWitness/:witness/:observer?

Example

/witnesses_api/getWitness/steemchiller

Example Response:

{
   "code": 0,
   "result": {
      "name": "steemchiller",
      "rank": 2,
      "created": 1584795897,
      "last_sync": 1767643453,
      "last_price_report": 1767643206,
      "received_votes": 200538971816112580,
      "produced_blocks": 2865576,
      "missed_blocks": 326,
      "running_version": "0.23.1",
      "hardfork_version_vote": "0.23.0",
      "hardfork_time_vote": 1589983200,
      "last_confirmed_block": 102349392,
      "signing_key": "STM8Qgeyq7HXcssom2KbtiXLBgWAG5oDcSvStqV11gEuwgi1RdQsM",
      "url": "https://steemit.com/witness-category/@steemchiller/steemchiller-goes-witness...",
      "props": {
         "account_creation_fee": "3.000 STEEM",
         "maximum_block_size": 65536,
         "sbd_interest_rate": 0,
         "account_subsidy_budget": 797,
         "account_subsidy_decay": 347321
      },
      "reported_price": {
         "base": "0.073 SBD",
         "quote": "1.000 STEEM"
      }
   }
}

@steemchiller Witness Stats:

Metric	Value
Rank	#2
Produced Blocks	2,865,576
Missed Blocks	326
Running Version	0.23.1
Price Feed	0.073 SBD/STEEM

---

getWitnessRank

Returns the current rank of a witness.

Endpoint

/witnesses_api/getWitnessRank/:witness

Example Response: {"code": 0, "result": 2}

---

getWitnessStats

Returns witness statistics.

Endpoint

/witnesses_api/getWitnessStats/:witness

---

getWitnessesByRank

Returns witnesses ordered by rank.

Endpoint

/witnesses_api/getWitnessesByRank/:observer?/:limit?/:offset?

Example

/witnesses_api/getWitnessesByRank/steemchiller/10

Top 10 Witnesses (Live):

Rank	Witness	Produced Blocks	Missed Blocks
1	justyy	2,910,273	1,468
2	steemchiller	2,865,576	326
3	symbionts	2,847,746	1,690
4	steem-agora	2,796,153	16,117
5	dev.supporters	2,885,603	4,730
6	bangla.witness	1,645,894	366
7	upvu.witness	2,155,228	6,888
8	steem.history	2,667,665	6,565
9	h4lab.witness	756,777	922
10	rnt1	2,817,315	250

---

Witness Proxies

getWitnessProxyByAccount

Returns the witness voting proxy for an account.

Endpoint

/witnesses_api/getWitnessProxyByAccount/:account

---

getAccountsByWitnessProxy

Returns accounts using a specific proxy for witness voting.

Endpoint

/witnesses_api/getAccountsByWitnessProxy/:proxy/:limit?/:offset?

---

getWitnessProxyChainForwards

Returns the forward proxy chain for an account.

Endpoint

/witnesses_api/getWitnessProxyChainForwards/:account

---

getWitnessProxyChainBackwards

Returns the backward proxy chain for a proxy account.

Endpoint

/witnesses_api/getWitnessProxyChainBackwards/:proxy

---

Witness Votes

getWitnessVotesByAccount

Returns all witness votes cast by an account.

Endpoint

/witnesses_api/getWitnessVotesByAccount/:account

Example

/witnesses_api/getWitnessVotesByAccount/steemchiller

@steemchiller votes for 30 witnesses:

justyy, steemchiller, faisalamin, jianan, ayogom, starlord28, moecki, 
exnihilo.witness, steem-agora, bountyking5, steem.history, visionaer3003, 
boylikegirl.wit, jswit, time.foundation, alexmove.witness, stmpak.wit, 
bangla.witness, jrcornel.wit, yasu.witness, pennsif.witness, seven.wit, 
steemgoon.witnez, h4lab.witness, dhaka.witness, steemfy, kafio.wit, 
wakucat, blaze.apps, cur8.witness

---

getWitnessVotesByWitness

Returns accounts voting for a specific witness.

Endpoint

/witnesses_api/getWitnessVotesByWitness/:witness/:limit?/:offset?

---

getWitnessVotesSummary

Returns detailed voter breakdown with VESTS for a witness.

Endpoint

/witnesses_api/getWitnessVotesSummary/:witness

@steemchiller Top Voters:

Account	Own VESTS	Proxied VESTS
dev365	98K	64.4B (proxy)
rme	24.4B	2.2B
upvu.proxy	6.9M	20.4B (proxy)
hungry-griffin	10.9B	-
zzan.witnesses	2.3M	8.5B (proxy)

---

Missed Blocks

getRecentlyMissedBlocks

Returns recently missed blocks across all witnesses.

Endpoint

/witnesses_api/getRecentlyMissedBlocks/:limit?/:offset?

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"time": 0, "witness": 1},
      "rows": [
         [1767642951, "adsactly-witness"],
         [1767641910, "gtg"],
         [1767640571, "paintingclub"],
         [1767640139, "aggroed"],
         [1767638859, "steemgoon.witnez"]
      ]
   }
}

---

getRecentlyMissedBlocksSummary

Returns missed block counts by witness.

Endpoint

/witnesses_api/getRecentlyMissedBlocksSummary

Top Witnesses by Missed Blocks (Recent):

Witness	Missed Count
xpilar.witness	393
newsteem.witness	225
aggroed	106
gtg	89
thecryptodrive	84
abit	79

---

getRecentlyMissedCountByWitnessTime

Returns missed block count for a specific witness.

Endpoint

/witnesses_api/getRecentlyMissedCountByWitnessTime/:witness/:fromTime?

Example

/witnesses_api/getRecentlyMissedCountByWitnessTime/steemchiller

Result: 0 (steemchiller has no recent missed blocks)

---

Back to Main Index