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:

https://forms.gle/PwKpCFVY91wiffxw8

II. Request API for Single NFT Authenticity Verification report

Create a report for a NFT

POST https://api-aioracle.airight.io/api-key/report

Body param must have an input file OR address - token_id

Headers

Name	Type	Description
api-key	String	Api key Ex: sdf546FGjrDFG56

Request Body

Name	Type	Description
file	String	File image upload

200: OK

{
    // Response
}

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

API for requesting Authenticity Verifying Report of an NFT Collection by contract

POST https://api-aioracle.airight.io/report/collection

Enter the Collection smart contract address and the blockchain it's created on, our system will send you an email including the URL which shows the process of verifying and real-time updated checking results.

Headers

Name	Type	Description
api-key*	String	Your API Key (provided by aiRight) Ex: sdf546FGjrDFG56

Request Body

Name	Type	Description
email*	String	Email to receive the report URL Ex: [email protected]
chain*	String	The blockchain that the contract created on Ex: ethereum, polygon, ...
contract*	String	Contract address of Collection Ex: 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae

200: OK

{
 url: "https://api-aioracle.airight.io/report/collection/status/8-qw34rt"
}

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

Request check the Status of Verification Process for NFT collection above

GET https://api-aioracle.airight.io/report/collection/status/{id}

Path Parameters

Name	Type	Description
id*	String	ID report + random string (get from the URL sent to your registered email) Ex: 8-qw34rt

Headers

Name	Type	Description
api-key*	String	Your API Key (provided by aiRight) Ex: sdf546FGjrDFG56

200: OK Status of verifying NFTs of the contract and summary on the confidence level of those NFTs

{
    status: "N/A|process|done",
    total_supply: int,
    number_verified: int,
    summary: {
      red: {
        number: int,
        rate: float,
        nft: ["tokenid", "tokenid",...],
      },
      consider: {
        number: int,
        rate: float,
        nft: [],
      },
      reliable: {
        number: int,
        rate: float,
      }
  },
}

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

👉🏻 Understand more about the above types of similarity

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