# 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
}
}
]
}
]
}
```