Response Detail

Transaction Validation

ParameterTypeDescription
used_gasuintGas used. The data is represented in base-10 (decimal).
is_revertboolIf the Txn is reverted
revert_reasonstringRevert Reson
is_simulatedboolIf the simulation successed
simulate_failed_reasonstringWhy if simulation failed
suspicious_urlboolIf the user is integrating with suspicious URL
logsLogs[]Logs
native_balance_changesnative_balance_changes[]Change in the native token balance of the address before and after the transaction.
erc20_balance_changeserc20_balance_changes[]Details of ERC20 token changes before and after the transaction.
erc721_balance_changeserc721_balance_changes[]Details of ERC721 NFT changes before and after the transaction.
erc20_allowance_changeserc20_allowance_changes[]Details of token approval changes for the address before and after the transaction.
flaggedflagged[]Risk flag
suspicious_addressessuspicious_addresses[]List of suspicious addresses involved in the transaction.

Log Entry

ParameterTypeExampleDescription
addressstring0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095cThe contract address that emitted the event (i.e., the event source)
topicsArray["0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c","0x0000000000000000000000000000111122223333444455556666777788889999"]List of event topics.
datastring0x0000000000000000000000000000000000000000000000000100000000000000Log data.
LogEntry Example

{
    "logs": [
        {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "topics": [
                "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
                "0x0000000000000000000000000000111122223333444455556666777788889999"
            ],
            "data": "0x0000000000000000000000000000000000000000000000000100000000000000"
        }
    ]
}

Native Balance Changes

ParameterTypeExampleDescription
addressstring0x0000111122223333444455556666777788889999Address
beforestring0x1000000000000000000Balance before the transaction
afterstring0xffff00000000000000Balance after the transaction
changestring-0x100000000000000Balance change after the transaction; can be negative. A negative value indicates a decrease.
nativeBalanceChanges Example

{
    "native_balance_changes": [
        {
            "address": "0x0000111122223333444455556666777788889999",
            "native_change": {
                "change": "-0x100000000000000",
                "before": "0x1000000000000000000",
                "after": "0xffff00000000000000"
            }
        }
    ]
}

Erc20 Balance Changes

ParameterTypeExampleDescription
addressstring0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095cAddress
token_addressstring0x68ca006db91312cd60a2238ce775be5f9f738bbaToken Contract address
token_namestring$ USDCGift.comToken Name
token_symbolstring$ USDCGift.com \<- Visit to claim bonusToken Symbol
decimalsstring0x12Decimals
changestring0x100000000000000Tokne balance change after the transaction; can be negative. A negative value indicates a decrease.
erc20BalanceChanges Example 

{
    "erc20_balance_changes": [
        {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "erc20_change": [
              {
                  	"decimals":"0x12",
                  	"token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
                  	"token_name": "$ USDCGift.com",
                  	"token_symbol": "$ USDCGift.com \<- Visit to claim bonus",
                  	"change": "0x100000000000000"
              }
            ]
              }
    ]
}

Erc721 Balance Changes

ParameterTypeExampleDescription
addressstring0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095cAddress
token_addressstring0xc2c747e0f7004f9e8817db2ca4997657a7746928Erc721 Token addres
token_namestringHashmasksToken Name
token_symbolstringHMToken Symbol
token_idstring0x4783NFT ID
receivedboolfalseReceiving or sending NFT
erc721Changes Example 

{
    "erc721_changes": {
        "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
        "erc721Change": [
            {
                "token_aAddress": "0xc2c747e0f7004f9e8817db2ca4997657a7746928",
                "token_id": "0x4783",
                "token_name": "Hashmasks",
                "token_symbol": "HM",
                "received": false
            }
        ]
    }
}

Allowance Change

ParameterTypeExampleDescription
token_addressstring"0x68ca006db91312cd60a2238ce775be5f9f738bba”Token address
ownerstring"0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22”Owner address
spenderstring"0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22”Spender address
amountstring"0xffff00000000000000”Final approval amount
token_namestringHashmasksToken Name
token_symbolstringHMToken Symbol
decimalsstring0x12Decimals
AllowanceChange Example

{
    "erc20_allowance_changes": [
            {
                "token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
                "owner": "0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a",
                "spender": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
              	"amount": "0xffff00000000000000",
                "decimals":"0x12",
                "token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
               	"token_name": "$ USDCGift.com",
                "token_symbol": "$ USDCGift.com \<- Visit to claim bonus",

            }
        ]
}

Flag

ParameterTypeExampleDescription
typestringe.g. 'high_risk', 'medium_risk', 'potential_risk'Potential risk in this Txn.
messagestringe.g. e.g.
‘This transaction is likely to be a contract attack, which will cause a loss of $’,
From/TO address 0x… is related to honeypot tokens or has created scam tokens.
Risk detail

Flag Example

{
    "flagged": [
        {
            "type": "high_risk",
            "message": "From/TO address 0x… is related to honeypot tokens or has created scam tokens",
        },
        {
            "type": "high_risk",
            "message": "This transaction is likely to be a contract attack, which will cause a loss of $",
        }
    ]
}

Suspicious Address Integration

ParameterTypeExampleDescription
addressstring"0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22”Suspicious address integrated in this Txn.
labelsstring[]["contract_attack", "honeypot_related_address"…]Risk label
SuspiciousAddressIntegration Example

{
    "suspicious_addresses": [
        {
            "address": "0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22",
            "labels": ["honeypot_related_address"],
        },
        {
            "address": "0x632d35Cc6634C0532925a3b8D03A4bC0c0996776",
            "labels": ["contract_attack"],
        }
    ]
}