Rug-pull Detection API Beta

This API is currently in beta, and we may make adjustments at any time.

Method: GET
URL: https//api.gopluslabs.io/api/v1/rugpull_detecting/{chain_id}?contract_addresses=​
PATH PARAM
Parameters
Type
Required
Description
chain_id
String
True
Chain id, (eth: 1, bsc: 56)
QUERY PARAM
Parameters
Type
Required
Description
contract_addresses
String
True
Defi protocol address
Request Headers
Parameters
Type
Required
Description
Authorization
String
False
Carrying Token obtained through Get Access Token​
Response Parameters
Security items
Parameter
Description
Notice
​
Contract owner
"owner": { "owner_name": "", "owner_address": "", "owner_type": "" }
(1) "owner_name": the function name of ownership. 
If there is no return, means unknown. 
(2) "owner_address":  owner address of the contract. 
No return means unknown.
(3) "owner_type":" blackhole" : the owner is a blackhole address.
"contract" : the owner is a contract.
"eoa" : the owner is a common address (eoa).
"multi-address": the owner is an array/list.
null: the address is not detected.
No return means unknown.
When there is no owner function, or the ownership is unreadable or private, it would return empty.
"owner": {  }
​
Privilege withdraw
privilege_withdraw
It descirbes whether the contract owner can withdraw all the assets in the contract, without uses' permission.
"1" means true;
"0" means false; 
"-1" means unknown.
​
​
Can not withdraw
withdraw_missing
It describes whether the contract lacks withdrawal method. If it is missing, users will be unable to withdraw the assets they have putted in.
"1" means true;
"0" means false; 
"-1" means unknown.
​
​
Contract verified
is_open_source
It describes whether this contract is open source. 
"1" means true; 
"0" means false.
​
​
Blacklist function
blacklist
It describes whether the contract has blacklist function that would block user from withdrawing their assets.
"1" means true;
"0" means false; 
"-1" means unknown.
​
​
Contract name
contract_name
Name of the contract.
​
​
Self-destruct
selfdestruct
It describes whether this contract can self destruct.
"1" means true; 
"0" means false;
“-1” means unknown.
​
​
Potential Approval abuse
approval_abuse
It describes whether the owner can spend the allowance that obtained by the contract. If so, this function could potentially be abused to steal user assets.
"1" means true; 
"0" means false;
“-1” means unknown.
​
​
Proxy contract
is_proxy
It describes whether this contract has a proxy contract. 
"1" means true; 
"0" means false;
“-1” means unknown.
​
​
Error Code
Code
API License Agreement
API License Agreement

Parameters	Type	Required	Description
chain_id	String	True	Chain id, (eth: 1, bsc: 56)

Parameters	Type	Required	Description
contract_addresses	String	True	Defi protocol address

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

Reference - Previous

Phishing Site Detection API

Next - Reference

Access Token

Last modified 11d ago

Security items	Parameter	Description	Notice
Contract owner	"owner": { "owner_name": "", "owner_address": "", "owner_type": "" }	(1) "owner_name": the function name of ownership. If there is no return, means unknown. (2) "owner_address": owner address of the contract. No return means unknown. (3) "owner_type":" blackhole" : the owner is a blackhole address. "contract" : the owner is a contract. "eoa" : the owner is a common address (eoa). "multi-address": the owner is an array/list. null: the address is not detected. No return means unknown.	When there is no owner function, or the ownership is unreadable or private, it would return empty. "owner": { }
Privilege withdraw	privilege_withdraw	It descirbes whether the contract owner can withdraw all the assets in the contract, without uses' permission. "1" means true; "0" means false; "-1" means unknown.
Can not withdraw	withdraw_missing	It describes whether the contract lacks withdrawal method. If it is missing, users will be unable to withdraw the assets they have putted in. "1" means true; "0" means false; "-1" means unknown.
Contract verified	is_open_source	It describes whether this contract is open source. "1" means true; "0" means false.
Blacklist function	blacklist	It describes whether the contract has blacklist function that would block user from withdrawing their assets. "1" means true; "0" means false; "-1" means unknown.
Contract name	contract_name	Name of the contract.
Self-destruct	selfdestruct	It describes whether this contract can self destruct. "1" means true; "0" means false; “-1” means unknown.
Potential Approval abuse	approval_abuse	It describes whether the owner can spend the allowance that obtained by the contract. If so, this function could potentially be abused to steal user assets. "1" means true; "0" means false; “-1” means unknown.
Proxy contract	is_proxy	It describes whether this contract has a proxy contract. "1" means true; "0" means false; “-1” means unknown.