v1

latestOpenAPI 3.0.3Apache-2.02026-07-1348142206.6 KB

contracts

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.

get/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}

Path parameters

contractIdOrAddressstring required

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

timestampstring 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.

Query parameters

hbarboolean

Controls the unit used for monetary fields (amount, gas_price, max_fee_per_gas, max_priority_fee_per_gas). When true (default), values are returned in tinybars. When false, values are returned in weibars (the native Ethereum unit, where 1 tinybar = 10,000,000,000 weibars).

Response

access_liststring nullable

The hex encoded access_list of the wrapped ethereum transaction

addressstring

The hex encoded evm address of contract

amountinteger nullable

The amount sent to the function. When hbar=true (default), the value is in tinybars. When hbar=false, the value is in weibars.

block_gas_usedinteger nullable

The total amount of gas used in the block

block_hashstring nullable

The hex encoded block (record file chain) hash

block_numberinteger nullable

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

bloomstring binary nullable

The hex encoded bloom filter of the contract result

call_resultstring nullable

The hex encoded result returned by the function

chain_idstring nullable

The hex encoded chain_id of the wrapped ethereum transaction

contract_idstring nullable

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

created_contract_idsEntityId[] nullable

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

error_messagestring nullable

The message when an error occurs during smart contract execution

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

fromstring binary nullable

A network entity encoded as an EVM address in hex.

function_parametersstring nullable

The hex encoded parameters passed to the function

gas_consumedinteger nullable

The units of consumed gas by the EVM to execute contract

gas_limitinteger

The maximum units of gas allowed for contract execution

gas_pricestring nullable

The hex encoded gas_price of the wrapped ethereum transaction

gas_usedinteger nullable

The units of gas used to execute contract

hashstring

The hex encoded transaction hash

max_fee_per_gasstring nullable

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

max_priority_fee_per_gasstring nullable

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

nonceinteger nullable

The nonce of the wrapped ethereum transaction

rstring nullable

The hex encoded signature_r of the wrapped ethereum transaction

resultstring

The result of the transaction

sstring nullable

The hex encoded signature_s of the wrapped ethereum transaction

statusstring

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

timestampstring

A Unix timestamp in seconds.nanoseconds format

tostring binary nullable

A network entity encoded as an EVM address in hex.

transaction_indexinteger nullable

The position of the transaction in the block

typeinteger nullable

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

vinteger nullable

The recovery_id of the wrapped ethereum transaction

Example response

{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398",
  "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",
  "from": "0x0000000000000000000000000000000000001f41",
  "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",
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398",
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}