ERC721 NFT Approval Security API

API: http://api.gopluslabs.io/api/v2/nft721_approval_security/1?addresses=​
METHOD: GET
PATH PARAM:
Parameters
required
description
chain_id
True
Chain id, (eth:1, bsc:56 )
QUERY PARAM
Parameters
Required
Description
addresses
True
EOA address
EXAMPLE:
​http://api.gopluslabs.io/api/v2/nft721_approval_security/1?addresses=0xd95dbdab08a9fed2d71ac9c3028aac40905d8cf3​
Request Headers:
Parameters
Type
Required
Description
Authorization
String
False
Carrying Token obtained through Get Access Token​
Response ：
Security items
Parameter
Description
Notice
Token Contract
nft_address
It describes the NFT contract address which is approved.


Chain
chain_id
The chain_id of the blockchain. 
"1" means Ethereum; 
"56" means BSC.


NFT Name
nft_name
token_name


NFT Symbol
nft_symbol
token_symbol


Open Source
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.
The NFT verified
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 NFT

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.
Specific Malicious Behavior
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
Returning an empty array means that no malicious behavior was found at that address.
Approved Contract
approved_contract
It describes the approved contract.


Initial Approval Time
initial_approval_time
It describes when is the first time owner approved allowance to the spender.
The value is timestamp.
​
Initial Approval Hash
initial_approval_hash
It describes the initial approved allowance hash of the contract.
​
Latest Approved Time
approved_time
It describes the latest allowance changeing time of the contract.
The value is timestamp.
​
Latest Approved Hash
hash
It describes the latest allowance changeing hash of the contract.


Approved Type(Approved for all /Approved for single NFT)
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.
The Token_id of Approved NFT
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
"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", "deployed_time" will return "null".

When no malicious behavior was found at that address, "malicious_behavior" will return an empty array.
Response Example:
{
  "code": 1,
  "message": "ok",
  "result": [
    {
      "nft_address": "0xb045248a632907df9565a5b8d4df4eaa0e81e7ca",
      "chain_id": "56",
      "nft_name": "WitchMagicBox721",
      "nft_symbol": "WitchMagicBox721",
      "is_open_source": 0,
      "is_verified": 1,
      "malicious_address": 0,
      "malicious_behavior":["phishing_activities"],
      "approved_list": [
        {
          "approved_contract": "0x1ccc54b5f38a758a1c922c3dbe374e2f41c45409",
          "approved_for_all": 1,
          "approved_token_id": null,
          "approved_time": 1641319315,
          "hash": "0x7134e533e4f0ebd4b0c14c8d0000f986a073d3b1fd84ccedf1c2fb89db743692",
          "address_info": {
            "contract_name": "NormalMarket",
            "tag": null,
            "creator_address": "0x615759d8519dc77f7b2a42a90a9512cd015197a7",
            "is_contract": 1,
            "doubt_list": 0,            
            "malicious_behavior":[],
            "deployed_time": 1624961887,
            "trust_list": 0,
            "is_open_source": 1
          }
        }
      ]
    },
    {
      "nft_address": "0x0000f22ffe0866ffb8834600dad9259cf4956853",
      "chain_id": "56",
      "nft_name": "BSC Name Service (.bnb)",
      "nft_symbol": "TD",
      "is_open_source": 1,
      "is_verified": 0,
      "malicious_address": 0,
      "malicious_behavior":[],
      "approved_list": [
        {
          "approved_contract": "0x1ccc54b5f38a758a1c922c3dbe374e2f41c45409",
          "approved_for_all": 1,
          "approved_token_id": null,
          "approved_time": 1628015932,
          "hash": "0x6149242cd0e44d7fae3663841cb872aedc3b6b0b26a98dbfb0553a44d73d93f5",
          "address_info": {
            "contract_name": "NormalMarket",
            "tag": null,
            "creator_address": "0x615759d8519dc77f7b2a42a90a9512cd015197a7",
            "is_contract": 1,
            "doubt_list": 0,
            "malicious_behavior":[],
            "deployed_time": 1624961887,
            "trust_list": 0,
            "is_open_source": 1
          }
        }
      ]
    }
  ]
}
​
​
​

Parameters	required	description
chain_id	True	Chain id, (eth:1, bsc:56 )

Parameters	Required	Description
addresses	True	EOA address

Parameters	Type	Required	Description
Authorization	String	False	Carrying Token obtained through Get Access Token

Token Approval Security API

ERC1155 NFT Approval Security API

Last modified 10d ago

Security items	Parameter	Description	Notice
Token Contract	nft_address	It describes the NFT contract address which is approved.
Chain	chain_id	The `chain_id` of the blockchain. "1" means Ethereum; "56" means BSC.
NFT Name	nft_name	token_name
NFT Symbol	nft_symbol	token_symbol
Open Source	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.
The NFT verified	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 NFT	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.
Specific Malicious Behavior	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	Returning an empty array means that no malicious behavior was found at that address.
Approved Contract	approved_contract	It describes the approved contract.
Initial Approval Time	initial_approval_time	It describes when is the first time owner approved allowance to the spender. The value is timestamp.
Initial Approval Hash	initial_approval_hash	It describes the initial approved allowance hash of the contract.
Latest Approved Time	approved_time	It describes the latest allowance changeing time of the contract. The value is timestamp.
Latest Approved Hash	hash	It describes the latest allowance changeing hash of the contract.
Approved Type(Approved for all /Approved for single NFT)	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.
The Token_id of Approved NFT	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	"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", "deployed_time" will return "null". When no malicious behavior was found at that address, "malicious_behavior" will return an empty array.