getBlockCommitment

POSTBlocksAll plans

Returns the stake-weighted vote commitment history for a specific block.

Try itSends a real request from your browser to the selected region.
POST
/

getBlockCommitment returns how much stake, bucketed by confirmation depth, voted on a given slot, plus the cluster's total active stake.

Most applications rely on the higher-level confirmationStatus field from getSignatureStatuses instead of this lower-level, per-slot view.

Plans & rate limitsAll plans
Free2/s
Operator5/s
Blade Runner50/s
Nexus100/s

Parameters

params is a JSON array, with values in this order: slot.

1slotintegerrequired

Slot number to check commitment for.

Result

resultobject

Commitment info for the slot. Not wrapped in a context/value envelope.

Show propertiesProperties
commitmentinteger[] | nullrequired

Null once the slot has fallen out of the node's recent-vote tracking window (typically because it's already finalized and aged out) — see Notes.

Show one ofOne of
Option 1integer[]

A 32-element array: index N is the amount of stake, in lamports, that has voted on this slot with N confirmations.

Option 2null
totalStakeintegerrequired

Total active stake on the network, in lamports, at the time of the response.

Notes

  • commitment is null for almost every real call: the node only keeps per-confirmation-depth data for recent, unrooted slots, and reverts to null once a slot finalizes and ages out (though totalStake keeps being reported). A populated array is only observable within seconds of the slot being produced.
  • This is a per-slot view; getSignatureStatuses reports a specific transaction's confirmation progress instead.