Info Security

Method: GET
URL: https://api.gopluslabs.io/api/v1/token_security/{chain_id}?contract_addresses=​
Request Headers
Parameters
Type
Required
Description
Authorization
String
False
Carrying Token obtained through Get Access Token​
Response Parameters
​
Security items
Parameter
Description
Notice
Token Name
token_name
​
​
Token Symbol
token_symbol
​
​
Token holder number
holder_count
It describes the number of token holders.
Example:"holder_count": "4342"
​
Token Total Supply
total_supply
It describes the supply number of the token.
Example:"total_supply": 100000000
​
Top10 holders info
"holders":[{ "address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5", "locked": 1, "tag": "", "is_contract": 1, "balance": 10000000, "percent": 0.1 "locked_detail": [ {"amount": "99619.047369140000000000", "end_time": "2022-04-17T00:00:00+00:00", "opt_time": "2022-01-17T05:44:54+00:00" }]
It describes top10 holders info. The info includes:  
(1) "address" describes the holder address; 
(2) "locked." describes whether the tokens owned by the holder are locked "1" means true; "0" means false; 
(3) “tag” describes the address's public tag. Example:Burn Address/Deployer; 
(4) “is_contract” describes whether the holder is a contract "1" means true; "0" means false. 
(5) “balance” describes the balance of the holder. 
(6) "percent" describes the percentage of tokens held by this holder 
(7) "locked_detail" is an array, decribes lock position info of this holder, only shows when "locked": 1. This Array may contain multiple objects for multiple locking info. In every objetc, "amount" describes the number of token locked, "end_time" describes when the token will be unlocked, "opt_time" describes when the token was locked.
(1) About "locked": We only support the token lock addresses or black hole addresses that we have included. 
(2) When "locked":0, or lock address is a black hole address,  "locked_detail" will be no return.
(3) About "percent": 1 means 100% here.
Owner Balance
owner_balance
It describes the balance of the contract owner. 
Example: "owner_balance": "100000000". 
No return or return empty means there is no ownership or can't find ownership.
When "owner_address" returns empty, or no return, there will be no return.
Token Percentage of Owner
owner_percent
It describes the percentage of tokens held by the contract owner. 
Example:"owner_balance": "0.1". 
No return or return empty means there is no ownership or can't find ownership.
(1) 1 means 100% here.
(2) When "owner_address" returns empty, or no return, there will be no return.
Creator Address
creator_address
It describes this contract's owner address. 
Example: "creator_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5";
​
Creator Balance
creator_balance
It describes the balance of the contract owner. 
Example:"owner_balance": 100000000.
​
Token Percentage of Creator
creator_percent
It describes the percentage of tokens held by the contract owner. Example:"owner_balance": 0.1.
1 means 100% here.
LP token holder number
lp_holder_count
It describes the number of LP token holders.
Example:"lp_holder_count": "4342".
No return means no LP.
When "is_in_dex": "0", there will be no return.
LP Token Total Supply
lp_total_supply
It describes the supply number of the LP token.
Example:"lp_total_supply": "100000000".
No return means no LP.
(1) When "is_in_dex": "0", there will be no return. 
(2) It is LP token number, NOT token number
Top10 LP token holders info
"lp_holders":[{ "address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5", "locked": 1, "tag": "", "is_contract": 1, "balance": 10000000, "percent": 0.1 "locked_detail": [ {"amount": "99619.047369140000000000", "end_time": "2022-04-17T00:00:00+00:00", "opt_time": "2022-01-17T05:44:54+00:00" }] }] }]
It describes top10 LP holders info. The info includes:  
(1) "address" describes the holder address; 
(2) "locked" describes whether the tokens owned by the holder are locked. "1" means true; "0" means false; 
(3) “tag” describes the address's public tag. Example:Burn Address/Deployer; 
(4) “is_contract” describes whether the holder is a contract "1" means true; "0" means false. 
(5) “balance” describes the balance of the holder. 
(6) "percent" describes the percentage of tokens held by this holder 
(7) "locked_detail" is an array, decribes lock position info of this holder, only shows when "locked": "1". This Array may contain multiple objects for multiple locking info. In every objetc, "amount" describes the number of token locked, "end_time" describes when the token will be unlocked, "opt_time" describes when the token was locked.
No return means no LP.
(1) When "is_in_dex": "0", there will be no return. 
(2) About "locked": We only support the token lock addresses or black hole addresses that we have included. 
(3) About "percent": 1 means 100% here. 
(4) When "locked":"0", or lock address is a black hole address, "locked_detail" will be no return.
True/Fake Token
is_true_token
It describes whether the token is true or fake.
"1" means true token;
"0" means fake token;
None means no result (Because we did not find decisive information about the truth or falsity)
Only "is_true_token": "0" means it is a fake token.
Airdrop Scam
is_airdrop_scam
It describes whether the token is an airdrop scam.
"1" means true;
"0" means false;
None means no result (Because We did not find conclusive information on whether token is an airdrop scam).
Only "is_airdrop_scam": "1" means it is an airdrop scam.
Trust List
trust_list
It describes whether the token is a famous and trustworthy one. "1" means true; No return no result (Because We did not find conclusive information on whether token is a airdrop scam).
(1) Only "trust_list": "1" means it is a famous and trustworthy token. 
(2) No return doesn't mean it is risky.
Other Potential Risks
other_potential_risks
It describes whether the contract has other potential risks.
Example:
“other_potential_risks”: “Owner can set different transaction taxes for each user, which can trigger serious losses.”
(1) If we haven't found any other potential risk yet, there will be no return. 
(2) Type: string.
Note
note
It describes whether the contract has other things investors need to know. 
Example: 
"note”: “Contract owner is a multisign contract.”
(1) If we haven't found any other thing which is valuable yet, there will be no return. 
(2) Type: string.
​

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

Trading Security

Change Logs

Last modified 3mo ago

Security items	Parameter	Description	Notice
Token Name	token_name
Token Symbol	token_symbol
Token holder number	holder_count	It describes the number of token holders. Example:"holder_count": "4342"
Token Total Supply	total_supply	It describes the supply number of the token. Example:"total_supply": 100000000
Top10 holders info	"holders":[{ "address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5", "locked": 1, "tag": "", "is_contract": 1, "balance": 10000000, "percent": 0.1 "locked_detail": [ {"amount": "99619.047369140000000000", "end_time": "2022-04-17T00:00:00+00:00", "opt_time": "2022-01-17T05:44:54+00:00" }]	It describes top10 holders info. The info includes: (1) "address" describes the holder address; (2) "locked." describes whether the tokens owned by the holder are locked "1" means true; "0" means false; (3) “tag” describes the address's public tag. Example:Burn Address/Deployer; (4) “is_contract” describes whether the holder is a contract "1" means true; "0" means false. (5) “balance” describes the balance of the holder. (6) "percent" describes the percentage of tokens held by this holder (7) "locked_detail" is an array, decribes lock position info of this holder, only shows when "locked": 1. This Array may contain multiple objects for multiple locking info. In every objetc, "amount" describes the number of token locked, "end_time" describes when the token will be unlocked, "opt_time" describes when the token was locked.	(1) About "locked": We only support the token lock addresses or black hole addresses that we have included. (2) When "locked":0, or lock address is a black hole address, "locked_detail" will be no return. (3) About "percent": 1 means 100% here.
Owner Balance	owner_balance	It describes the balance of the contract owner. Example: "owner_balance": "100000000". No return or return empty means there is no ownership or can't find ownership.	When "owner_address" returns empty, or no return, there will be no return.
Token Percentage of Owner	owner_percent	It describes the percentage of tokens held by the contract owner. Example:"owner_balance": "0.1". No return or return empty means there is no ownership or can't find ownership.	(1) 1 means 100% here. (2) When "owner_address" returns empty, or no return, there will be no return.
Creator Address	creator_address	It describes this contract's owner address. Example: "creator_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5";
Creator Balance	creator_balance	It describes the balance of the contract owner. Example:"owner_balance": 100000000.
Token Percentage of Creator	creator_percent	It describes the percentage of tokens held by the contract owner. Example:"owner_balance": 0.1.	1 means 100% here.
LP token holder number	lp_holder_count	It describes the number of LP token holders. Example:"lp_holder_count": "4342". No return means no LP.	When "is_in_dex": "0", there will be no return.
LP Token Total Supply	lp_total_supply	It describes the supply number of the LP token. Example:"lp_total_supply": "100000000". No return means no LP.	(1) When "is_in_dex": "0", there will be no return. (2) It is LP token number, NOT token number
Top10 LP token holders info	"lp_holders":[{ "address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5", "locked": 1, "tag": "", "is_contract": 1, "balance": 10000000, "percent": 0.1 "locked_detail": [ {"amount": "99619.047369140000000000", "end_time": "2022-04-17T00:00:00+00:00", "opt_time": "2022-01-17T05:44:54+00:00" }] }] }]	It describes top10 LP holders info. The info includes: (1) "address" describes the holder address; (2) "locked" describes whether the tokens owned by the holder are locked. "1" means true; "0" means false; (3) “tag” describes the address's public tag. Example:Burn Address/Deployer; (4) “is_contract” describes whether the holder is a contract "1" means true; "0" means false. (5) “balance” describes the balance of the holder. (6) "percent" describes the percentage of tokens held by this holder (7) "locked_detail" is an array, decribes lock position info of this holder, only shows when "locked": "1". This Array may contain multiple objects for multiple locking info. In every objetc, "amount" describes the number of token locked, "end_time" describes when the token will be unlocked, "opt_time" describes when the token was locked. No return means no LP.	(1) When "is_in_dex": "0", there will be no return. (2) About "locked": We only support the token lock addresses or black hole addresses that we have included. (3) About "percent": 1 means 100% here. (4) When "locked":"0", or lock address is a black hole address, "locked_detail" will be no return.
True/Fake Token	is_true_token	It describes whether the token is true or fake. "1" means true token; "0" means fake token; None means no result (Because we did not find decisive information about the truth or falsity)	Only "is_true_token": "0" means it is a fake token.
Airdrop Scam	is_airdrop_scam	It describes whether the token is an airdrop scam. "1" means true; "0" means false; None means no result (Because We did not find conclusive information on whether token is an airdrop scam).	Only "is_airdrop_scam": "1" means it is an airdrop scam.
Trust List	trust_list	It describes whether the token is a famous and trustworthy one. "1" means true; No return no result (Because We did not find conclusive information on whether token is a airdrop scam).	(1) Only "trust_list": "1" means it is a famous and trustworthy token. (2) No return doesn't mean it is risky.
Other Potential Risks	other_potential_risks	It describes whether the contract has other potential risks. Example: “other_potential_risks”: “Owner can set different transaction taxes for each user, which can trigger serious losses.”	(1) If we haven't found any other potential risk yet, there will be no return. (2) Type: string.
Note	note	It describes whether the contract has other things investors need to know. Example: "note”: “Contract owner is a multisign contract.”	(1) If we haven't found any other thing which is valuable yet, there will be no return. (2) Type: string.