Skip to main content
GET
/
api
/
v1
/
contracts
/
{contractIdOrAddress}
/
results
/
{timestamp}
Get the contract result from a contract on the network executed at a given timestamp
curl --request GET \
  --url https://mainnet.mirrornode.hedera.com/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}
{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x0127",
  "contract_id": "0.0.2",
  "created_contract_ids": [
    "0.0.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_consumed": 35000,
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 80000,
  "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",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "contract_id": "0.0.2"
    }
  ]
}

Path Parameters

​
contractIdOrAddress
string
required

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

​
timestamp
string
required

The Unix timestamp in seconds.nanoseconds format, the timestamp at which the associated transaction reached consensus. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Response

OK

​
access_list
string | null

The hex encoded access_list of the wrapped ethereum transaction

Example:

"0xabcd"

​
address
string

The hex encoded evm address of contract

Example:

"0x25fe26adc577cc89172e6156c9e24f7b9751b762"

​
amount
integer | null

The number of tinybars sent to the function

Example:

10

​
block_gas_used
integer | null

The total amount of gas used in the block

Example:

2000

​
block_hash
string | null

The hex encoded block (record file chain) hash

Example:

"0x6ceecd8bb224da491"

​
block_number
integer | null

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

Example:

10

​
bloom
file | null

The hex encoded bloom filter of the contract result

​
call_result
string | null

The hex encoded result returned by the function

Example:

"0x2b048531b38d2882e86044bc972e940ee0a01938"

​
chain_id
string | null

The hex encoded chain_id of the wrapped ethereum transaction

Example:

"0x0127"

​
contract_id
string | null

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

Example:

"0.0.2"

​
created_contract_ids
(string | null)[] | null

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

​
error_message
string | null

The message when an error occurs during smart contract execution

Example:

"Out of gas"

​
failed_initcode
string

The hex encoded initcode of a failed contract create transaction

Example:

"0x856739"

​
from
file | null

A network entity encoded as an EVM address in hex.

​
function_parameters
string | null

The hex encoded parameters passed to the function

Example:

"0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"

​
gas_consumed
integer | null

The units of consumed gas by the EVM to execute contract

Example:

35000

​
gas_limit
integer

The maximum units of gas allowed for contract execution

Example:

100000

​
gas_price
string | null

The hex encoded gas_price of the wrapped ethereum transaction

Example:

"0x4a817c800"

​
gas_used
integer | null

The units of gas used to execute contract

Example:

80000

​
hash
string

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

Example:

"0x3531396130303866616264653464"

​
max_fee_per_gas
string | null

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

Example:

"0x5"

​
max_priority_fee_per_gas
string | null

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

Example:

"0x100"

​
nonce
integer | null

The nonce of the wrapped ethereum transaction

Example:

1

​
r
string | null

The hex encoded signature_r of the wrapped ethereum transaction

Example:

"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"

​
result
string

The result of the transaction

Example:

"SUCCESS"

​
s
string | null

The hex encoded signature_s of the wrapped ethereum transaction

Example:

"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"

​
status
string

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

Example:

1

​
timestamp
string

A Unix timestamp in seconds.nanoseconds format

Example:

"1586567700.453054000"

​
to
file | null

A network entity encoded as an EVM address in hex.

​
transaction_index
integer | null

The position of the transaction in the block

Example:

1

​
type
integer | null

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

Example:

2

​
v
integer | null

The recovery_id of the wrapped ethereum transaction

Example:

1

​
logs
object[]
​
state_changes
object[]