NFT Security API

​
get
https://api.gopluslabs.io/api/v1/nft_security/{chain_id}?contract_addresses=
 
Method: GET 
URL: https://api.gopluslabs.io/api/v1/nft_security/{chain_id}?contract_addresses=​
PATH PARAM
Parameters
Type
Required
Description
chain_id
String
True
Chain id, (eth: 1, bsc: 56, Polygon:137 )
FORM PARAM
Parameters
Type
Required
Description
contract_addresses
String
True
NFT contract address
Request Headers
Parameters
Type
Required
Description
Authorization
String
False
Carrying Token obtained through Get Access Token​
Response Parameters
Security items
Parameter
Description
Notice
NFT Name
nft_name
​
​
NFT Symbol
nft_symbol
​
​
NFT Description
nft_description
It describes the introduction of the NFT.
Return “null” means there is no description of the NFT.
​
NFT ERC
nft_erc
It describes the ERC protocol of the NFT.
Example: "nft_erc": "erc721"
​
Creator Address
creator_address
It describes the creator address of the NFT.
Example: "creator_address": "0x1ee0af784b96bb55ece98c9b15675726b0da1b6b";
Return “null” means that we didn't find the creator address.
​
The number of blocks created
create_block_number
It describes the number of blocks created for the NFT.
Return “null” means that we didn't find the number of blocks created for the NFT.
​
Website URL
website_url
It describes the website url of the NFT.
Return “null” means there is no website url or didn't find the website url.
​
Discord URL
discord_url
It describes the discord url of the NFT.
Return “null” means there is no discord url or didn't find the discord url.
​
Github URL
github_url
It describes the github url of the NFT.
Return “null” means there is no github url or didn't find the github url.
​
Twitter URL
twitter_url
It describes the twitter url of the NFT.
Return “null” means there is no twitter url or didn't find the twitter url.
​
Medium URL
medium_url
It describes the medium url of the NFT.
Return “null” means there is no medium url or didn't find the medium url.
​
Telegram URL
telegram_url
It describes the telegram url of the NFT.
Return “null” means there is no telegram url or didn't find the telegram url.
​
NFT Items
nft_items
It describes the numbers of the NFT.
​
NFT Holders
nft_owner_number
It describes the holders of the NFT.
​
The average price in 24h
average_price_24h
It describes the average price of the NFT in 24h.
​
The lowest price in 24h
lowest_price_24h
It describes the lowest price of the NFT in 24h.
​
The sales in 24h
sales_24h
It describes the sales of the NFT in 24h.
​
The trading volume in 24h
traded_volume_24h
It describes the trading volume of the NFT in 24h.
​
The total volume
total_volume
It describes the total volume of the NFT.
​
The highest price
highest_price
It describes the highest price of the NFT.
​
The NFT is verified
nft_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.
​
The info of duplicate name NFTs
"same_nfts":[{"nft_name":"Landbox Club","nft_symbol":"Land","nft_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5","nft_owner_number": "1111","create_block_number": "1111"},{"nft_name":"Landbox Club", "nft_symbol":"Land","nft_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5","nft_owner_number": "1111"}]
It describes the info of other NFTs with duplicate name and symbol.
The info includes:
(1) "nft_name" describes the name of the NFT;
(2) "nft_symbol" describes the symbol of the NFT;
(3) “nft_address” describes the address of the NFTs;
(4) “nft_owner_number” describes the holders of the NFT;
(5) “create_block_number” describes the number of blocks created for the NFT.
Return "null" means no NFTs with duplicate name and symbol.
​
Trust List
trust_list
It describes whether the NFT is a famous and trustworthy one.
"1" means true; 
Return "null" means no result.
(1) Only "trust_list": "1" means it is a famous and trustworthy NFT.
(2) Return "null" doesn't mean it is risky.Th
Malicious NFT
malicious_nft_contract
It describes whether this NFT has performed malicious behaviors.
"1" means true;
"2" means false.
Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with NFTs flagged as Malicious may contain a high level of risk
Open Source
nft_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.
NFT Contract is Proxy
nft_proxy
It describes whether this NFT contract has a proxy contract. 
"1" means true; 
"0" means false; 
"Null" means unknown.
(1) When "is_open_source": "0", it will return "null".
(2) Most Proxy contracts are accompanied by modifiable implementation contracts, and implementation contracts may contain significant potential risk.
Can burn others NFT
privileged_burn: { value:
owner_address: owner_type: }
It describes whether the NFT owner can burn others NFT.
(1)value
The "value" describes the status of the risk.
null: the contract is not open source or there is a proxy, it is not possible to detect whether the risk exists. -1: the risk is detected but the ownership give up. If the detection of a code vulnerability, it can also be considered risk-free. 
0: the risk is not detected. 
1: the risk is detected, and the owner address is a common address (EOA), then it can be said that there is a clear risk. 
2: The risk is detected, but the owner address is a contract address, the risk is not significant. 
3: The risk is detected, but the owner address is not detectable / or an array.

(2)owner_address
Owner_address describes the owner address. 
null: the owner address cannot be fetched.

(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.
Privileged_burn means that the owner can burn others' NFTs directly through the method.
Can transfer
NFT without approval (sleep mint)
transfer_without_approval:{ 
value: owner_address: owner_type:
}
It describes whether the NFT owner can transfer NFT without approval.
Other contents are the same as above.
Transfer_without_approval generally means the scammer does not need to get approvals to transfer another address's NFT.
One typical example is sleep_minting. Sleep_minting means that the scammer will first add the NFT to a well-known wallet address and then retrieve the NFT. After the value of the NFT has appreciated , it will be put back on the market.
Privileged Minting
privileged_minting: { value:
owner_address: owner_type }
It describes whether the NFT contract has  minting methods which can only be triggered by an address with special privileges.
Other contents are the same as above.
Some minting methods can only be triggered by an address with special privileges. Generally speaking, these are usually for the owner to mint.
Selfdestruct
self_destruct: { value: owner_address: owner_type }
It describes whether this NFT contract can self destruct.
Other contents are the same as above.
When the self-destruct function is triggered, this contract will be destroyed, all functions will be unavailable, and all related assets will be erased.
Approval Restriction
restricted_approval
It describes whether the NFT contract can restrict the approval, resulting in NFT can not be traded on the NFT DEX.
"1" means true; 
"0" means false; 
"Null" means unknown.
If this risk exists, it means that users will not be able to trade the NFT on the exchange and only privileged users in the whitelist will be able to trade normally.
Oversupply Minting
oversupply_minting
It describes whether this NFT owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit. 
"1" means true; 
"0" means false; 
"Null" means unknown.


Oversupply minting refers to the existence of a special mint method in the NFT contract — the owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit.
Sample Response
Response for a successful request:
{
  "code": 1,
  "message": "string",
  "result": {
    "average_price_24h": 0,
    "create_block_number": 0,
    "creator_address": "string",
    "discord_url": "string",
    "github_url": "string",
    "highest_price": 0,
    "lowest_price_24h": 0,
    "medium_url": "string",
    "nft_address": "string",
    "nft_description": "string",
    "nft_erc": "string",
    "nft_items": 0,
    "nft_name": "string",
    "nft_owner_number": 0,
    "nft_symbol": "string",
    "nft_verified": 1,
    "sales_24h": 0,
    "same_nfts": [
      {
        "create_block_number": 0,
        "nft_address": "string",
        "nft_name": "string",
        "nft_owner_number": 0,
        "nft_symbol": "string"
      }
    ],
    "telegram_url": "string",
    "total_volume": 0,
    "traded_volume_24h": 0,
    "trust_list": 1,
    "twitter_url": "string",
    "website_url": "string",
    "nft_open_source":1,
    "nft_proxy":0,
    "privileged_burn": { 
    value:0,
    owner_address: null
    owner_type: null
    }
    "transfer_without_approval": { 
    value:0,
    owner_address: null
    owner_type: null
    }
    "privileged_minting": { 
    value:0,
    owner_address: null
    owner_type: null
    }
    "self_destruct": { 
    value:0,
    owner_address: null
    owner_type: null
    }
    "restricted_approval":0,
    "oversupply_minting":0,
    
  }
}
Code
code
description
1
Complete data prepared
2
Partial data obtained. The complete data can be requested again in about 15 seconds.
2024
request limit reached
4023
not found your access token
5000
system error
4012
signature verification failure
2020
non-contract address
2021
no info for this contract

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

Parameters	Type	Required	Description
contract_addresses	String	True	NFT contract address

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

Last modified 1mo ago

Security items	Parameter	Description	Notice
NFT Name	nft_name
NFT Symbol	nft_symbol
NFT Description	nft_description	It describes the introduction of the NFT. Return “null” means there is no description of the NFT.
NFT ERC	nft_erc	It describes the ERC protocol of the NFT. Example: "nft_erc": "erc721"
Creator Address	creator_address	It describes the creator address of the NFT. Example: "creator_address": "0x1ee0af784b96bb55ece98c9b15675726b0da1b6b"; Return “null” means that we didn't find the creator address.
The number of blocks created	create_block_number	It describes the number of blocks created for the NFT. Return “null” means that we didn't find the number of blocks created for the NFT.
Website URL	website_url	It describes the website url of the NFT. Return “null” means there is no website url or didn't find the website url.
Discord URL	discord_url	It describes the discord url of the NFT. Return “null” means there is no discord url or didn't find the discord url.
Github URL	github_url	It describes the github url of the NFT. Return “null” means there is no github url or didn't find the github url.
Twitter URL	twitter_url	It describes the twitter url of the NFT. Return “null” means there is no twitter url or didn't find the twitter url.
Medium URL	medium_url	It describes the medium url of the NFT. Return “null” means there is no medium url or didn't find the medium url.
Telegram URL	telegram_url	It describes the telegram url of the NFT. Return “null” means there is no telegram url or didn't find the telegram url.
NFT Items	nft_items	It describes the numbers of the NFT.
NFT Holders	nft_owner_number	It describes the holders of the NFT.
The average price in 24h	average_price_24h	It describes the average price of the NFT in 24h.
The lowest price in 24h	lowest_price_24h	It describes the lowest price of the NFT in 24h.
The sales in 24h	sales_24h	It describes the sales of the NFT in 24h.
The trading volume in 24h	traded_volume_24h	It describes the trading volume of the NFT in 24h.
The total volume	total_volume	It describes the total volume of the NFT.
The highest price	highest_price	It describes the highest price of the NFT.
The NFT is verified	nft_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.
The info of duplicate name NFTs	"same_nfts":[{"nft_name":"Landbox Club","nft_symbol":"Land","nft_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5","nft_owner_number": "1111","create_block_number": "1111"},{"nft_name":"Landbox Club", "nft_symbol":"Land","nft_address": "0x744aF9cBb7606BB040f6FBf1c0a0B0dcBA6385E5","nft_owner_number": "1111"}]	It describes the info of other NFTs with duplicate name and symbol. The info includes: (1) "nft_name" describes the name of the NFT; (2) "nft_symbol" describes the symbol of the NFT; (3) “nft_address” describes the address of the NFTs; (4) “nft_owner_number” describes the holders of the NFT; (5) “create_block_number” describes the number of blocks created for the NFT. Return "null" means no NFTs with duplicate name and symbol.
Trust List	trust_list	It describes whether the NFT is a famous and trustworthy one. "1" means true; Return "null" means no result.	(1) Only "trust_list": "1" means it is a famous and trustworthy NFT. (2) Return "null" doesn't mean it is risky.Th
Malicious NFT	malicious_nft_contract	It describes whether this NFT has performed malicious behaviors. "1" means true; "2" means false.	Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with NFTs flagged as Malicious may contain a high level of risk
Open Source	nft_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.
NFT Contract is Proxy	nft_proxy	It describes whether this NFT contract has a proxy contract. "1" means true; "0" means false; "Null" means unknown.	(1) When "is_open_source": "0", it will return "null". (2) Most Proxy contracts are accompanied by modifiable implementation contracts, and implementation contracts may contain significant potential risk.
Can burn others NFT	privileged_burn: { value: owner_address: owner_type: }	It describes whether the NFT owner can burn others NFT. (1)value The "value" describes the status of the risk. null: the contract is not open source or there is a proxy, it is not possible to detect whether the risk exists. -1: the risk is detected but the ownership give up. If the detection of a code vulnerability, it can also be considered risk-free. 0: the risk is not detected. 1: the risk is detected, and the owner address is a common address (EOA), then it can be said that there is a clear risk. 2: The risk is detected, but the owner address is a contract address, the risk is not significant. 3: The risk is detected, but the owner address is not detectable / or an array. (2)owner_address Owner_address describes the owner address. null: the owner address cannot be fetched. (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.	Privileged_burn means that the owner can burn others' NFTs directly through the method.
Can transfer NFT without approval (sleep mint)	transfer_without_approval:{ value: owner_address: owner_type: }	It describes whether the NFT owner can transfer NFT without approval. Other contents are the same as above.	Transfer_without_approval generally means the scammer does not need to get approvals to transfer another address's NFT. One typical example is sleep_minting. Sleep_minting means that the scammer will first add the NFT to a well-known wallet address and then retrieve the NFT. After the value of the NFT has appreciated , it will be put back on the market.
Privileged Minting	privileged_minting: { value: owner_address: owner_type }	It describes whether the NFT contract has minting methods which can only be triggered by an address with special privileges. Other contents are the same as above.	Some minting methods can only be triggered by an address with special privileges. Generally speaking, these are usually for the owner to mint.
Selfdestruct	self_destruct: { value: owner_address: owner_type }	It describes whether this NFT contract can self destruct. Other contents are the same as above.	When the self-destruct function is triggered, this contract will be destroyed, all functions will be unavailable, and all related assets will be erased.
Approval Restriction	restricted_approval	It describes whether the NFT contract can restrict the approval, resulting in NFT can not be traded on the NFT DEX. "1" means true; "0" means false; "Null" means unknown.	If this risk exists, it means that users will not be able to trade the NFT on the exchange and only privileged users in the whitelist will be able to trade normally.
Oversupply Minting	oversupply_minting	It describes whether this NFT owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit. "1" means true; "0" means false; "Null" means unknown.	Oversupply minting refers to the existence of a special mint method in the NFT contract — the owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit.

code	description
1	Complete data prepared
2	Partial data obtained. The complete data can be requested again in about 15 seconds.
2024	request limit reached
4023	not found your access token
5000	system error
4012	signature verification failure
2020	non-contract address
2021	no info for this contract