Get the NFT Authenticity Verifying report via API
Integrate our NFT Authenticity Verification AI Oracle to your platforms
NFT Content Authenticity Verifying Service is secured from unknown users by limiting API calls to those that provide proper authentication accreditations. These credentials are in the form of an API key. This guide shows how to get and use your API Key for the service.
The API key is a unique identifier that authenticates requests associated with your project for usage and billing purposes. You must have at least one API key associated with your project. Each of these API keys will represent the number of requests you have. Please contact us via email to register for an API Key via this form:
post
https://api-aioracle.airight.io/api-key/report
Create a report for a NFT
Example request:
curl --location --request POST 'https://api-aioracle.airight.io/report/nft'
--form 'file=@"/path/to/file.png" --header 'api-key: sdf546FGjrDFG56'
Response body:
{
"exact_match": [],
"near_exact": [],
"semantic": [
{
"contract": "0x60f80121c31a0d46b5279700f9df786054aa5ee5",
"tokenId": "9536",
"authorAddress": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
"creation_time": "1657267489316",
"name": "Lush greenery",
"description": "",
"marketName": "OpenSea",
"market": "https://opensea.io/assets/ethereum/0xbbe0ee73d36b3fb6b688ad24192541c059248188/4668",
"isVerified": false,
"image": "https://ipfs.io/ipfs/QmWCoDP4SM5MKMvqAAkaLNEN5TVu9f4m9CQQioWF1VkLDi",
"score": 0.65
},
],
"flag_red": false,
"flag_consider": true
}
2.1. Request for NFT Collection Authenticity Verifying report via API
post
https://api-aioracle.airight.io/report/collection
API for requesting Authenticity Verifying Report of an NFT Collection by contract
Example request:
curl --location --request POST 'https://api-aioracle.airight.io/report/collection' \
--header 'api-key: sdf546FGjrDFG56' \
--header 'Content-Type: application/json' \
--data-raw '{
"contract": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"chain": "ethereum",
"email": "[email protected]"
}'
Response body:
{
url: “https://api-aioracle.airight.io/report/collection/status/8-qw34rt”
}
If collection is verified, response body (there will be no “Verification Process Status” step):
{
"isVerified": true,
"marketName": "OpenSea"
}
2.2. Request checking the Verification Process Status
get
https://api-aioracle.airight.io/report/collection/status/{id}
Request check the Status of Verification Process for NFT collection above
Variable explanation:
status
: The status of the verifying process
N/A
: Have not been processed verifying collection yet process
: In processing verifying collectiondone
: Have done verifying collectiontotal_supply
: Total NFT of the collectionnumber_verified
: The number of checked NFTs of the collectionSummary
: Displays scoring the confidence level of this NFT, data will return:
red
: Red-flag level: the NFTs exact-duplicate, near exact-duplicate with or have a similarity score of more than 0.9 with NFTs of the other contracts => highly potential fake/forged/infringed NFTnumber
: the number of checked NFTs in the red-flag levelrate
: the rate (%) of Red flag NFT on the total number of checked NFT in collections nft
: list of NFT in Red-flag level, tokenid:
The ID of the NFT in the contract
consider
: Consider level: the NFTs have a similarity score of more than 0.55 with the NFTs of the other contracts
Reliable
: Reliable level: the NFTs have no exact-duplicate, near exact-duplicate results and have a similarity score of less than 0.55 with NFTs of the other contracts. Our system will send another email informing you that the verifying process has been done along with a
json.
file aggregating details of checking results for each checked NFT in the collection.
👉🏻 Data will return in
detail
: Tokenid
: ID of the checked NFTs of the checking contractexact_match
: list of NFTs of other contracts found as exact-duplicated with checked NFTnear-exact
: list of NFTs of other contracts found as near-duplicated with checked NFTsemantic
: list of NFTs of other contracts found as edit-copied or in the same concept with checked NFTcontract
: contract address of the similar NFT founddescription
: the NFT descriptionimage
: the image URL of the NFT market
: the URL to the NFT on the marketplacename
: the NFT nametokenId
: the ID of this NFT in the contractscore:
similarity score in comparison with checked NFT measured by AI modelisVerified
: true => collection has been verified by the organization below, false => collection has not been verified marketName
: the marketplace that the NFT is being listed on. {
"contract": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
"chain": "ethereum",
"status": "done",
"total_supply": 150,
"number_verified": 2,
"summary": {
"red": {
"number": 1,
"rate": 0.6,
"nft": [
"40610047128735507369531371678689547884095804282887658682343845465022913314834"
]
},
"consideration": {
"number": 0,
"rate": 0,
"nft": []
},
"reliable": {
"number": 1,
"rate": 0.6
}
},
"detail": {
"29988661540054685624256145304119478717841111267903514459897271889511510441999": {
"exact_match": [],
"near_extract": [],
"sematic": [
{
"contract": "0x60f80121c31a0d46b5279700f9df786054aa5ee5",
"description": "Unlocks full drawing ",
"image": "ipfs://ipfs/QmdWcS6AhubZ3Tqdhrmrp3C62VSjHjWj35VW3aXttqDq82",
"market": "https://opensea.io/assets/0x60f80121c31a0d46b5279700f9df786054aa5ee5/28975",
"name": "Unigirl v1",
"tokenId": "28975",
"score": 0.65,
"isVerified": false,
"marketName": "OpenSea"
},
{
"contract": "0x60f80121c31a0d46b5279700f9df786054aa5ee5",
"description": "Big MaKEN ",
"image": "ipfs://ipfs/QmZmLdRtgxyfSae59hPxY1pwngwN9sDxtTvEU2drpXdCJq/image.png",
"market": "https://opensea.io/assets/0x60f80121c31a0d46b5279700f9df786054aa5ee5/557046",
"name": "I'm loving it",
"tokenId": "557046",
"score": 0.65,
"isVerified": false,
"marketName": "OpenSea"
}
]
},
"40610047128735507369531371678689547884095804282887658682343845465022913314834": {
"exact_match": [
{
"contract": "0xd07dc4262bcdbf85190c01c996b4c06a461d2430",
"description": "",
"image": "ipfs://ipfs/QmPuJxURAgyFE1H2Qj5u9veEYNMyuhckd9ghKAwiWD28v6/image.jpeg",
"market": "https://opensea.io/assets/0xd07dc4262bcdbf85190c01c996b4c06a461d2430/643499",
"name": "Snake of sea ",
"tokenId": "643499",
"score": 0.95,
"isVerified": false,
"marketName": "OpenSea"
}
],
"near_extract": [],
"sematic": [
{
"contract": "0x6184f10302cebeea0211f9310225f051cc549626",
"description": "Galactic Secret Agency is a collection of 10.000 unique Alien Agents. They're lurking, watching and influencing humanity for centuries. Each Alien is unique, generated from over 170 hand drawn assets. Holding one of the agent grant you access to future members-only benefits. Visit our website to learn more about GSA. https://www.GalacticSecretAgency.com",
"image": "https://galacticsecretagency.com/assets/assets/gsa/avatar/5101.png",
"market": "https://opensea.io/assets/0x6184f10302cebeea0211f9310225f051cc549626/5101",
"name": "Agent #5101",
"tokenId": "5101",
"score": 0.65,
"isVerified": true,
"marketName": "OpenSea"
}
]
}
}
}