> For the complete documentation index, see [llms.txt](https://docs.omniatech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omniatech.io/rpc-api-docs/chains/ethereum/custom-json-rpc-api/omnia_checkapproval.md).
# 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
}
}
]
}
]
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.omniatech.io/rpc-api-docs/chains/ethereum/custom-json-rpc-api/omnia_checkapproval.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.