aiRight
Search
K

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.

I. Request your API Key for 1-month free trial

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:

II. Request API for Single NFT Authenticity Verification report

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
}

III. Request Authenticity Verifying Report for NFT Collection via API with your API key

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 collection
done: Have done verifying collection
  • total_supply: Total NFT of the collection
  • number_verified: The number of checked NFTs of the collection
  • Summary: 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 NFT
number: the number of checked NFTs in the red-flag level
rate: 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.

Get your report after the Verifying process done

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 contract
exact_match: list of NFTs of other contracts found as exact-duplicated with checked NFT
near-exact: list of NFTs of other contracts found as near-duplicated with checked NFT
semantic: list of NFTs of other contracts found as edit-copied or in the same concept with checked NFT
contract: contract address of the similar NFT found
description: the NFT description
image: the image URL of the NFT
market: the URL to the NFT on the marketplace
name: the NFT name
tokenId: the ID of this NFT in the contract
score: similarity score in comparison with checked NFT measured by AI model
isVerified: 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.

For example:

{
"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"
}
]
}
}
}