contracts

The contract state from a contract on the network

Changed on

Returns a list of all contract's slots. If no timestamp is provided, returns the current state.

get/api/v1/contracts/{contractIdOrAddress}/state

Request

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/contracts/{contractIdOrAddress}/state
  • Auth
    none declared

Path parameters

contractIdOrAddressstring required

Contract or account identifier in format shard.realm.num, realm.num, num or a 20-byte EVM address (with or without 0x prefix).

Query parameters

limitinteger

The maximum number of items to return

order'asc' | 'desc'

The order in which items are listed

slotstring

The slot's number

timestampstring[]

The consensus timestamp of the contract state as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Response

OK

Example response

{
  "state": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "timestamp": "1586567700.453054000",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}

Changes

  • v1b940acac6e1dRevision changes
    • info

      removed the non-success response with the status

  • v1db389f03b097Revision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      added the non-success response with the status