Jump to
Ctrl
+
/

Simulate Ethereum Transactions

POST
/simulate-transactions/evm/ethereum/{network}

Through this endpoint the customer can Simulate transactions and know in advance how they will behave onchain without paying a on chain fee.

Path Parameters

network string Required

Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "sepolia" are test networks.

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

Request Body Schema application/json

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

data object Required
item object Required
amount string Required

String representation of the amount being transferred in ETH

gasLimit integer Required

String representation of the gas limit for the transactions

gasPrice string Optional

String representation of the gas price for LEGACY transactions in WEI

inputData string Optional

String representation of hex data for contract interactions

maxFeePerGas string Optional

String representation of the max fee per gas for EIP-1559 transactions in WEI

maxPriorityFeePerGas string Optional

String representation of the max priority fee for EIP-1559 transactions in WEI

recipient string Required

String representation of the to address

sender string Required

String representation of the from address

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2024-12-12
requestId string Required

Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
item object Required
contract string Optional

String representation of contract address of the token that was transfered

0x534bD102153EF199abAe8296a2FaE4599fC44Cdc
gasLimit integer Required

String representation of the transaction gas limit

21000
gasUsed integer Optional

String representation of the transaction used gas

21000
hash string Required

String representation of the transaction hash

0xbedfba55a8ef9342d1fe70e1e9adefad20aca7c164b072a648b1bb95d5a6b631
inputData string Optional

Hex data for contract interaction

0xa9059cbb000000000000000000000000392214d9de6aaafe32f8ce1e166c2b3ac8ce04c700000000000000000000000000000000000000000000000000000000000001F4
internalTransactions array Items (object) Optional

Internal transactions executed by transaction

depth integer Required

This simply shows how far we are looking into the transactions. Each Call has a "Depth" value that indicates how far it is away from the original transaction. A depth of 1 means it's a direct call, while Calls higher than 1 shows nested calls.

1
operationType string Required

String representation of internal transaction type

CALL
recipient string Required

String representation of the internal transaction recipient

0xc946cb236481c159f460b212b34ab246dac37fcd
sender string Required

String representation of the internal transaction sender

0xadf10d7f6a7069c11fc5f3c6c9b4f419b326bcbc
value object Required
amount string Required

String representation of the amount that was transacted

0.0123
unit string Optional
ETH
nonce integer Required

Numeric representation of the transaction nonce

123
positionInBlock integer Required

Numeric representation of the transaction index

1
status string Required

Status of the transaction

0x1
timestamp integer Required

Numeric representation of the timestamp in seconds since epoch

1669627454
tokenTransfers array Items (object) Optional

Token transfers executed by transaction

recipient string Required

Defines the address to which the recipient receives the transferred tokens.

0xc6d46aba0c6e2eb6358c4e24804158cc4d847922
sender string Required

Defines the address from which the sender transfers tokens.

0xc6d46aba0c6e2eb6358c4e24804158cc4d847922
tokenData object Required
contractAddress string Required

String representation of contract address of the token that was transfered

0xece01807f7d9b93529174533e997e5de168b0b39
fungibleValues object Optional
amount string Optional

Amount of the transferred token

0.123
decimals integer Optional

Decimals of the token (for fungible tokens)

18
name string Optional

String representation of the token name

Tether
nonFungibleValues object Optional
tokenId string Optional

Token ID of the token (for non-fungible tokens)

73424079983647210902572285069973579475843508985221180214989723113099915952129
standard string Required

Defines the specific token type.

ERC-20
symbol string Optional

String representation of the token symbol

USDT
fee object Required
amount string Required

Fee spent for transaction

0.0001
unit string Required

Unit in which amount is calculated

ETH
gasPrice object Required
amount integer Required

String representation of the transaction gas price

1234567
unit string Required

String representation of the transaction price unit

WEI
maxFeePerGas object Optional
amount string Optional

Max fee per gas for EIP-1559 transactions

3558974297
unit string Required
WEI
maxPriorityFeePerGas object Optional
amount string Optional

Max priority fee for EIP-1559 transactions

21000
unit string Required
WEI
minedInBlock object Required
hash string Required

String representation of the block hash

0xbedfba55a8ef9342d1fe70e1e9adefad20aca7c164b072a648b1bb95d5a6b631
height integer Required

Numeric representation of the block height

2408785
value object Required
amount string Required

String representation of the amount

0.123
unit string Required
ETH

Credits Cost : 0 Credits for 1 Results

Was this page helpful?
Yes
No
Powered by
Language
URL

{
    "apiVersion": "2024-12-12",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "item": {
            "contract": "0x534bD102153EF199abAe8296a2FaE4599fC44Cdc",
            "gasLimit": 21000,
            "gasUsed": 21000,
            "hash": "0xbedfba55a8ef9342d1fe70e1e9adefad20aca7c164b072a648b1bb95d5a6b631",
            "inputData": "0xa9059cbb000000000000000000000000392214d9de6aaafe32f8ce1e166c2b3ac8ce04c700000000000000000000000000000000000000000000000000000000000001F4",
            "internalTransactions": [
                {
                    "depth": 1,
                    "operationType": "CALL",
                    "recipient": "0xc946cb236481c159f460b212b34ab246dac37fcd",
                    "sender": "0xadf10d7f6a7069c11fc5f3c6c9b4f419b326bcbc",
                    "value": {
                        "amount": "0.0123",
                        "unit": "ETH"
                    }
                }
            ],
            "nonce": 123,
            "positionInBlock": 1,
            "status": "0x1",
            "timestamp": 1669627454,
            "tokenTransfers": [
                {
                    "recipient": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922",
                    "sender": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922",
                    "tokenData": {
                        "contractAddress": "0xece01807f7d9b93529174533e997e5de168b0b39",
                        "fungibleValues": {
                            "amount": "0.123",
                            "decimals": 18
                        },
                        "name": "Tether",
                        "nonFungibleValues": {
                            "tokenId": "73424079983647210902572285069973579475843508985221180214989723113099915952129"
                        },
                        "standard": "ERC-20",
                        "symbol": "USDT"
                    }
                }
            ],
            "fee": {
                "amount": "0.0001",
                "unit": "ETH"
            },
            "gasPrice": {
                "amount": 1234567,
                "unit": "WEI"
            },
            "maxFeePerGas": {
                "amount": "3558974297",
                "unit": "WEI"
            },
            "maxPriorityFeePerGas": {
                "amount": "21000",
                "unit": "WEI"
            },
            "minedInBlock": {
                "hash": "0xbedfba55a8ef9342d1fe70e1e9adefad20aca7c164b072a648b1bb95d5a6b631",
                "height": 2408785
            },
            "value": {
                "amount": "0.123",
                "unit": "ETH"
            }
        }
    }
}