Skip to main content

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

The contract state from a contract on the network

Updated on
Dec 18, 2024

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 | null

A URL to fetch the next set of result, if available

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