omnia_checkApproval

Returns security details about the smart contracts for which the address issued ERC-20 approvals. Uses a proprietary, up-to-date collection of smart contracts. Can look for approvals issued for ERC-20/ERC-721/ERC-1155 tokens.

Parameters

1. DATA, 20 Bytes - address. The wallet address that is checked. REQUIRED

2. DATA, ["erc20" || "erc721" || "erc1155"] - contractType. The type of contracts for which the wallet address called the ERC-20 approval method. REQUIRED

Returns

Object with following details:

ERC-20 Token Approval Security API

Parameter	Description	Notice
token_address	It describes the token contract address which is approved.
chain_id	The chain_id of the blockchain. "1" means Ethereum; "56" means BSC.
token_name	token_name
token_symbol	token_symbol
decimals	It describes the token precision.
balance	It describes the token balance of the address.	The type of return value is string.
is_open_source	It describes whether this contract is open source. "1" means true; "0" means false.	Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items.
malicious_address	It describes whether this token has performed malicious behaviors. "1" means true; "0" means false.	Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk.
malicious_behavior:[]	It describes specific malicious behaviors. "honeypot_related_address" means that the address is related to honeypot tokens or has created scam tokens. "phishing_activities" means that this address has implemented phishing activities. "blackmail_activities" means that this address has implemented blackmail activities. "stealing_attack" means that this address has implemented stealing attacks. "fake_kyc" means that this address is involved in fake KYC. "malicious_mining_activities" means that this address is involved in malicious mining activities. "darkweb_transactions" means that this address is involved in darkweb transactions. "cybercrime" means that this address is involved in cybercrime. "money_laundering" means that this address is involved in money laundering. "financial_crime" means that this address is involved in financial crime. "blacklist_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted. "mixer" means this address is coin mixer address. "sanctioned" means this address is sanctioned. "gas_abuse" means this address is cheating other user's gas fee to mint other assets. "reinit" means this address/contract has been deployed more than onces, and can be deployed again. "fake_standard_interface" means this contract contains standard interfaces that do not conform the requirements of the standard protocol.	Returning an empty array means that no malicious behavior was found at that address.
approved_contract	It describes the approved contract.
initial_approval_time	It describes when is the first time owner approved allowance to the spender. The value is a timestamp.
initial_approval_hash	It describes the initially approved allowance hash of the contract.
approved_time	It describes the latest allowance changing time of the contract. The value is a timestamp.
hash	It describes the latest allowance changing hash of the contract.
approved_amount	It describes the approved amount of the contract.	The type of return value is string.
"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}	It describes the approved contract info. The info includes: (1) "contract_name" describes the approved contract name. (2) "tag" describes which dApp uses the contract. Example: "tag": "Compound". (3) "is_contract" describes whether the address is a contract. "1" means true; "0" means false. (4) "is_open_source" describes whether this contract is open source. "1" means true; "0" means false. (5) "trust_list" describes whether the address is a famous and trustworthy one. "1" means true; "0" means that we have not included this address in the trusted list. (6) "doubt_list" describes whether the address is a suspected malicious contract. "1" means true; "0" means that we have not found malicious behavior of this address. (7)"malicious_behavior" describes specific malicious behaviors. (8) "creator_address" describes the creator address of the contract. (9) "deployed_time" describes the deployed time of the contract. The value is presented as a timestamp.	When the address is not a contract ("is_contract"=0), "contract_name", "creator_address", and "deployed_time" will return "null". When no malicious behavior was found at that address, "malicious_behavior" will return an empty array.

ERC721 NFT Approval Security API

Parameter	Description	Notice
nft_address	It describes the NFT contract address which is approved.
chain_id	The chain_id of the blockchain. "1" means Ethereum; "56" means BSC.
nft_name	NFT name
nft_symbol	NFT symbol
is_open_source	It describes whether this contract is open source. "1" means true; "0" means false.	Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items.
is_verified	It describes whether the NFT is verified. "1" means that the NFT is verified; "0" means that we did not find any information about whether the NFT is verified.
malicious_address	It describes whether this token has performed malicious behaviors. "1" means true; "0" means false.	Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk.
malicious_behavior:[]	It describes specific malicious behaviors. "honeypot_related_address" means that the address is related to honeypot tokens or has created scam tokens. "phishing_activities" means that this address has implemented phishing activities. "blackmail_activities" means that this address has implemented blackmail activities. "stealing_attack" means that this address has implemented stealing attacks. "fake_kyc" means that this address is involved in fake KYC. "malicious_mining_activities" means that this address is involved in malicious mining activities. "darkweb_transactions" means that this address is involved in dark web transactions. "cybercrime" means that this address is involved in cybercrime. "money_laundering" means that this address is involved in money laundering. "financial_crime" means that this address is involved in financial crime. "blacklist_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted	Returning an empty array means that no malicious behavior was found at that address.
approved_contract	It describes the approved contract.
initial_approval_time	It describes when the first time owner approved allowance to the spender. The value is a timestamp.
initial_approval_hash	It describes the initially approved allowance hash of the contract.
approved_time	It describes the latest allowance changing time of the contract. The value is a timestamp.
hash	It describes the latest allowance changing hash of the contract.
approved_for_all	It describes the type approved. "1" means "approved for all"; "0" means "approved for single NFT".	The type of return value is bool. Note: Only the ERC721 NFTs have the two types of approved for all /approved for single. The ERC1155 NFTs have only one type - approved for all.
approved_token_id	It describes the token_id of the approved NFT if the approved type is "approved for single".	When the approved type is "approved for all" ("approved_for_all"=1), it will return "null".
"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}	It describes the approved contract info. The info includes: (1) "contract_name" describes the approved contract name. (2) "tag" describes which dApp uses the contract. Example: "tag": "Compound". (3) "is_contract" describes whether the address is a contract. "1" means true; "0" means false. (4) "is_open_source" describes whether this contract is open source. "1" means true; "0" means false. (5) "trust_list" describes whether the address is a famous and trustworthy one. "1" means true; "0" means that we have not included this address in the trusted list. (6) "doubt_list" describes whether the address is a suspected malicious contract. "1" means true; "0" means that we have not found malicious behavior of this address. (7)"malicious_behavior" describes specific malicious behaviors. (8) "creator_address" describes the creator address of the contract. (9) "deployed_time" describes the deployed time of the contract. The value is presented as a timestamp.	When the address is not a contract ("is_contract"=0), "contract_name", "creator_address", and "deployed_time" will return "null". When no malicious behavior was found at that address, "malicious_behavior" will return an empty array.

ERC1155 NFT Approval Security API

Parameter	Description	Notice
nft_address	It describes the NFT contract address which is approved.
chain_id	The chain_id of the blockchain. "1" means Ethereum; "56" means BSC.
nft_name	NFT name
nft_symbol	NFT symbol
is_open_source	It describes whether this contract is open source. "1" means true; "0" means false.	Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items.
is_verified	It describes whether the NFT is verified. "1" means that the NFT is verified; "0" means that we did not find any information about whether the NFT is verified.
malicious_address	It describes whether this token has performed malicious behaviors. "1" means true; "0" means false.	Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk.
malicious_behavior:[]	It describes specific malicious behaviors. "honeypot_related_address" means that the address is related to honeypot tokens or has created scam tokens. "phishing_activities" means that this address has implemented phishing activities. "blackmail_activities" means that this address has implemented blackmail activities. "stealing_attack" means that this address has implemented stealing attacks. "fake_kyc" means that this address is involved in fake KYC. "malicious_mining_activities" means that this address is involved in malicious mining activities. "darkweb_transactions" means that this address is involved in dark web transactions. "cybercrime" means that this address is involved in cybercrime. "money_laundering" means that this address is involved in money laundering. "financial_crime" means that this address is involved in financial crime. "blacklist_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted	Returning an empty array means that no malicious behavior was found at that address.
approved_contract	It describes the approved contract.
initial_approval_time	It describes when the first time owner approved allowance to the spender. The value is a timestamp.
initial_approval_hash	It describes the initially approved allowance hash of the contract.
approved_time	It describes the latest allowance changing time of the contract. The value is a timestamp.
hash	It describes the latest allowance changing hash of the contract.
"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}	It describes the approved contract info. The info includes: (1) "contract_name" describes the approved contract name. (2) "tag" describes which dApp uses the contract. Example: "tag": "Compound". (3) "is_contract" describes whether the address is a contract. "1" means true; "0" means false. (4) "is_open_source" describes whether this contract is open source. "1" means true; "0" means false. (5) "trust_list" describes whether the address is a famous and trustworthy one. "1" means true; "0" means that we have not included this address in the trusted list. (6) "doubt_list" describes whether the address is a suspected malicious contract. "1" means true; "0" means that we have not found malicious behavior of this address. (7)"malicious_behavior" describes specific malicious behaviors. (8) "creator_address" describes the creator address of the contract. (9) "deployed_time" describes the deployed time of the contract. The value is presented as a timestamp.	When the address is not a contract ("is_contract"=0), "contract_name", "creator_address", and "deployed_time" will return "null". When no malicious behavior was found at that address, "malicious_behavior" will return an empty array.

Example

Request

curl --request POST \
     --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "omnia_checkApproval",
    "params": [
        {
            "address": "0x684e1225fd9085582e061FF5154413be3C7EC9DF",
            "contractType": "erc20"
        }
    ]
}
'

Response

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": [
        {
            "token_address": "0x4d224452801aced8b2f0aebe155379bb5d594381",
            "chain_id": "1",
            "token_name": "ApeCoin",
            "token_symbol": "APE",
            "decimals": 18,
            "balance": "409.99999999999999999",
            "is_open_source": 1,
            "malicious_address": 0,
            "malicious_behavior": [],
            "approved_list": [
        {
            "token_address": "0xadf0ac3059400edfb6131b9fe65feea6ca83ad76",
            "chain_id": "1",
            "token_name": "SHELL",
            "token_symbol": "SHELL",
            "decimals": 18,
            "balance": "7511.292673611111111109",
            "is_open_source": 1,
            "malicious_address": 0,
            "malicious_behavior": [],
            "approved_list": [
                {
                    "approved_contract": "0x6576cfc5b0be296ed30d436c178d17cb59a4a3cd",
                    "approved_amount": "Unlimited",
                    "approved_time": 1662409086,
                    "initial_approval_time": 1662409057,
                    "initial_approval_hash": "0x5d683d9267bbb12de1467e5a22dc706b5c7b851e89e35928a2bf6a40ab37f588",
                    "hash": "0x8974cfcb4d374aa9a6d14fa35086548012dea1ee8dc091b342e2b166d5b8ff41",
                    "address_info": {
                        "contract_name": "CitizensInventory",
                        "tag": null,
                        "creator_address": "0xdcfbfc012a914758c4b62527a2770527b3279826",
                        "is_contract": 1,
                        "doubt_list": 0,
                        "malicious_behavior": [],
                        "deployed_time": 1662408079,
                        "trust_list": 0,
                        "is_open_source": 1
                    }
                }
            ]
        },
        {
            "token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "chain_id": "1",
            "token_name": "Wrapped Ether",
            "token_symbol": "WETH",
            "decimals": 18,
            "balance": "0.006",
            "is_open_source": 1,
            "malicious_address": 0,
            "malicious_behavior": [],
            "approved_list": [
                {
                    "approved_contract": "0x1e0049783f008a0085193e00003d00cd54003c71",
                    "approved_amount": "Unlimited",
                    "approved_time": 1671891851,
                    "initial_approval_time": 1671891851,
                    "initial_approval_hash": "0xe981c78057fbf7d31cac15073e221715d8e47ee75c022671432f39ebd9383bea",
                    "hash": "0xe981c78057fbf7d31cac15073e221715d8e47ee75c022671432f39ebd9383bea",
                    "address_info": {
                        "contract_name": "Conduit",
                        "tag": "OpenSea",
                        "creator_address": "0x939c8d89ebc11fa45e576215e2353673ad0ba18a",
                        "is_contract": 1,
                        "doubt_list": 0,
                        "malicious_behavior": [],
                        "deployed_time": 1654994918,
                        "trust_list": 1,
                        "is_open_source": 1
                    }
                }
            ]
        },
        {
            "token_address": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0",
            "chain_id": "1",
            "token_name": "Matic Token",
            "token_symbol": "MATIC",
            "decimals": 18,
            "balance": "0",
            "is_open_source": 1,
            "malicious_address": 0,
            "malicious_behavior": [],
            "approved_list": [
                {
                    "approved_contract": "0x401f6c983ea34274ec46f84d70b31c151321188b",
                    "approved_amount": "Unlimited",
                    "approved_time": 1666041575,
                    "initial_approval_time": 1666041047,
                    "initial_approval_hash": "0xdbd542db25a0de4a610cbcee2cbf769e8ef1c1ba0a0a0cee33ef6da951738cd4",
                    "hash": "0xb719e8cff686b25cf882a8e540586ccc66c0ed0342c67bcb55654aaabd22c282",
                    "address_info": {
                        "contract_name": "DepositManagerProxy",
                        "tag": null,
                        "creator_address": "0xa2d9846c352ca61dcb20d6aad40cec1d1b228a78",
                        "is_contract": 1,
                        "doubt_list": 0,
                        "malicious_behavior": [],
                        "deployed_time": 1590850640,
                        "trust_list": 0,
                        "is_open_source": 1
                    }
                }
            ]
        }
    ]
}