Token Approval Security API

API: https://api.gopluslabs.io/api/v2/token_approval_security/56?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:
https://api.gopluslabs.io/api/v2/token_approval_security/56?addresses=0xd018e2b543a2669410537f96293590138cacedf3
Request Headers:
Parameters
Type
Required
Description
Authorization
String
False
Carrying Token obtained through Get Access Token​
Response ：
Security items
Parameter
Description
Notice
Token Contract
token_address
It describes the token contract address which is approved.


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


Token Name
token_name
token_name


Token Symbol
token_symbol
token_symbol


Token Precision
decimals
It describes the token precision.


Token Holdings
balance
It describes the token balance of the address.
The type of return value is string.
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.
Malicious Token

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 Amount
approved_amount
It describes the approved amount of the contract.
The type of return value is string.

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": [
    {
      "token_address": "0x55d398326f99059ff775485246999027b3197955",
      "chain_id": "56",
      "token_name": "Tether USD",
      "token_symbol": "USDT",
      "decimals": 18,
      "balance": "244.312991926161305209",
      "is_open_source": 1,
      "malicious_address": 0,
      "malicious_behavior":["phishing_activities"],
      "approved_list": [
        {
          "approved_contract": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
          "approved_amount": "Unlimited",
          "approved_time": 1619498864,
          "hash": "0x9568d7fa18d3a23562dc61ff0a0457b177fea1e61b6661aa7729ee4bdf62c0b9",
          "address_info": {
            "contract_name": "PancakeRouter",
            "tag": "Pancakeswap",
            "creator_address": "0xdb6f5fb9311ae8885620ee893887c3d85c8293d6",
            "is_contract": 1,
            "doubt_list": 0,
            "malicious_behavior":[],
            "deployed_time": 1619165545,
            "trust_list": 1,
            "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

Last modified 10d ago

Security items	Parameter	Description	Notice
Token Contract	token_address	It describes the token contract address which is approved.
Chain	chain_id	The `chain_id` of the blockchain. "1" means Ethereum; "56" means BSC.
Token Name	token_name	token_name
Token Symbol	token_symbol	token_symbol
Token Precision	decimals	It describes the token precision.
Token Holdings	balance	It describes the token balance of the address.	The type of return value is string.
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.
Malicious Token	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 Amount	approved_amount	It describes the approved amount of the contract.	The type of return value is string.
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.