Skip to main content

Get Dynamic Fields by Version

Query dynamic fields at a specific object version

Updated on
Mar 24, 2026

Parameters

id
string
REQUIRED

Sui address of the object

v
integer
REQUIRED

Version number of the object (UInt53)

Returns

data
object

The data object containing object with dynamic fields at specific version

object
object

The object at the specified version

dynamicField
object

The dynamic field data at specified version

value
object

Dynamic field value

__typename
string

GraphQL typename (typically MoveValue)

json
object

JSON representation of the dynamic field value containing Sui system state information

epoch
string

Current epoch number

protocol_version
string

Current protocol version

system_state_version
string

System state version

reference_gas_price
string

Reference gas price for the epoch

safe_mode
boolean

Whether the system is in safe mode

epoch_start_timestamp_ms
string

Epoch start timestamp in milliseconds

validators
object

Validator information including active and inactive validators

total_stake
string

Total stake across all validators

active_validators
array

Array of active validator objects

pending_active_validators
integer

Number of pending active validators

pending_removals
array

Array of validators pending removal

inactive_validators
object

An object containing validators that are currently inactive and not participating in consensus

id
string

Unique identifier of the inactive validator set, typically represented as a hash or address

size
string

The total number of inactive validators in the set

validator_candidates
object

An object containing validators that are candidates to join the active validator set in upcoming epochs

id
string

Unique identifier of the validator candidate set, typically represented as a hash or address

size
string

The total number of validator candidates in the set

at_risk_validators
object

An object of validators at risk which contains the following field:

contents
array

An array of validators flagged as at risk, empty if no validators meet the risk criteria

staking_pool_mappings
object

Mappings of staking pool information

id
string

Unique identifier for staking pool mappings

size
string

Number of staking pool mappings

extra_fields
object

Additional validator fields

id
string

Unique identifier for extra fields

size
string

Number of extra fields

storage_fund
object

Storage fund information

total_object_storage_rebates
string

Total object storage rebates

non_refundable_balance
string

Non-refundable balance

parameters
object

System parameters

epoch_duration_ms
string

Duration of an epoch in milliseconds

stake_subsidy_start_epoch
string

Epoch when stake subsidy starts

min_validator_count
string

Minimum number of validators

max_validator_count
string

Maximum number of validators

min_validator_joining_stake
string

Minimum stake required for a validator to join

validator_low_stake_threshold
string

Threshold for low validator stake

validator_very_low_stake_threshold
string

Threshold for very low validator stake

validator_low_stake_grace_period
string

Grace period for validators with low stake

validator_report_records
object

An object containing validator report records mapped by validator identifier:

contents
array

An array of validator report entries

key
string

Unique identifier of the validator being reported

value
object

Object containing report details associated with the validator

contents
array

Array of validator addresses or identifiers that reported this validator

stake_subsidy
object

Stake subsidy information

balance
string

Current subsidy balance

distribution_counter
string

Distribution counter

current_distribution_amount
string

Current distribution amount

stake_subsidy_period_length
string

Length of stake subsidy period

stake_subsidy_decrease_rate
integer

Rate at which stake subsidy decreases

safe_mode_storage_rewards
string

Storage rewards accumulated during safe mode

safe_mode_computation_rewards
string

Computation rewards accumulated during safe mode

safe_mode_storage_rebates
string

Storage rebates accumulated during safe mode

safe_mode_non_refundable_storage_fee
string

Non-refundable storage fees accumulated during safe mode

extra_fields
object

Additional system state fields

id
string

Unique identifier for extra fields

size
string

Number of extra fields

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free