Skip to main content

/api/v1/contracts/{contractIdOrAddress}/state REST API Endpoint

The contract state from a contract on the network

Updated on
Aug 23, 2024

/api/v1/contracts/{contractIdOrAddress}/state REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Path Parameters

contractIdOrAddress
string
REQUIRED
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract

Query Parameters

slot
string
The slot's numberx
limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)
timestamp
array
The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator

Returns

state
array
An array of objects, each representing a state resulting from a contract execution
address
string
The address of the contract where the state change occurred
contract_id
string
The unique identifier of the contract that caused the state change
slot
string
The specific storage slot in the contract's storage that was changed
timestamp
string
The timestamp when the state change occurred
value
string
The value written to the storage slot
links
object
An object containing pagination links
next
string
A URL to fetch the next set of result, if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/contracts/0.0.4651164/state'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free