Get Contract Result at Timestamp

Returns a single ContractResult for a contract's function executions at a specific timestamp.

This method will use 15 Compute Units.

---

Get the contract result from a contract on the network executed at a given timestamp

Returns a single ContractResult for a contract's function executions at a specific timestamp.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}

Path parameters

contractIdOrAddress*string

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

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

timestamp*string

The timestamp at which the associated transaction reached consensus

Example: 1234567890.0000007

Pattern: ^\d{1,10}(.\d{1,9})?$

Response

200206400404

OK

Body

application/json

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

Example: "0xabcd"

addressstring

The hex encoded evm address of contract

Example: "0x25fe26adc577cc89172e6156c9e24f7b9751b762"

amountnullable integer (int64)

The number of tinybars sent to the function

Example: 10

block_gas_usednullable integer (int64)

The total amount of gas used in the block

Example: 2000

block_hashnullable string

The hex encoded block (record file chain) hash

Example: "0x6ceecd8bb224da491"

block_numbernullable integer (int64)

The block height calculated as the number of record files starting from zero since network start.

Example: 10

bloomall of

call_resultnullable string

The hex encoded result returned by the function

Example: "0x2b048531b38d2882e86044bc972e940ee0a01938"

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

Example: "0x0127"

contract_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

created_contract_idsnullable array of nullable EntityId (string)

The list of smart contracts that were created by the function call.

error_messagenullable string

The message when an error occurs during smart contract execution

Example: "Out of gas"

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

Example: "0x856739"

fromEvmAddress (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

function_parametersnullable string

The hex encoded parameters passed to the function

Example: "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"

gas_limitinteger (int64)

The maximum units of gas allowed for contract execution

Example: 100000

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

Example: "0x4a817c800"

gas_usednullable integer (int64)

The units of gas used to execute contract

Example: 1000

hashstring

A hex encoded 32 byte hash and it is only populated for Ethereum transaction case

Example: "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

Example: "0x5"

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

Example: "0x100"

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

Example: 1

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

Example: "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"

resultstring

The result of the transaction

Example: "SUCCESS"

snullable string

The hex encoded signature_s of the wrapped ethereum transaction

Example: "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"

statusstring

The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else

Example: 1

timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

tonullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0x0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

transaction_indexnullable integer (int64)

The position of the transaction in the block

Example: 1

typenullable integer

The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)

Example: 2

vnullable integer

The recovery_id of the wrapped ethereum transaction

Example: 1

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

Example: "0xabcd"

addressstring

The hex encoded evm address of contract

Example: "0x25fe26adc577cc89172e6156c9e24f7b9751b762"

block_gas_usednullable integer (int64)

The total amount of gas used in the block

Example: 2000

block_hashnullable string

The hex encoded block (record file chain) hash

Example: "0x6ceecd8bb224da491"

block_numbernullable integer (int64)

The block height calculated as the number of record files starting from zero since network start.

Example: 10

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

Example: "0x0127"

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

Example: "0x856739"

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

Example: "0x4a817c800"

hashstring

The hex encoded transaction hash

Example: "0x3531396130303866616264653464"

logsContractResultLogs (array of ContractResultLog (object))

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

Example: "0x5"

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

Example: "0x100"

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

Example: 1

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

Example: "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"

snullable string

The hex encoded signature_s of the wrapped ethereum transaction

Example: "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"

state_changesContractResultStateChanges (array of ContractResultStateChange (object))

transaction_indexnullable integer (int64)

The position of the transaction in the block

Example: 1

typenullable integer

The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)

Example: 2

vnullable integer

The recovery_id of the wrapped ethereum transaction

Example: 1

Request

JavaScriptCurlPython

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200206400404

{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": {},
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x0127",
  "contract_id": "0.1.2",
  "created_contract_ids": [
    "0.1.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "from": "0000000000000000000000000000000000001f41",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 1000,
  "hash": "0x3531396130303866616264653464",
  "max_fee_per_gas": "0x5",
  "max_priority_fee_per_gas": "0x100",
  "nonce": 1,
  "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
  "result": "SUCCESS",
  "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
  "status": 1,
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": {},
      "contract_id": "0.1.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.1.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}