NFT Search

The NFT Search API allows you to compare a query image to Hive's library of existing NFT image assets in order to identity duplicates and other types of fraud. You can read more about our NFT Search project in our guide pages.

Input

As input data, the NFT Search API accepts a single image file (specified via file path) or a link to the image. This link must be public in order to be readable by our API.

Output

Here's an example of the full response object returned by the NFT Search API.

{
  "task_id": "dd52c0d0-9ec7-11ea-98a3-4b92424b8366",
  "project_id": 18416,
  "status":
    {
      "output": {
            "input": {
                  "url": "https://nvme-s3.castle.fm/hive-data/project/32952/task/real/f75f068",
            }, 
            "matches":
                [{
                  "url": "ipfs://QmdeH3Dm1FvL1ttVVcTWD5nTtUKjVMsjQXn5D2i8WrsHWA/6666.png",
                  "token_id": "string",
                  "contract_address": "string",
                  "token_url": "string",
                  "image_hash": "05cd5e3eaa08e234b42191a5de7979974b9a417d1cec234f05219e5e89b83b52", //example
                  "blockchain": "Ethereum" //example 
                  "metadata": {
                      "name": "this is the name of the nft",
                      "desc": "this is the description of the nft", 
                     // .... can also include "image", "attributes", "edition", etc. depending on the type of NFT
                 },
                 "similarity_score": 0.997
                }]
      }
    }
}

Results will be included in the "matches" object. If our model identifies multiple matches, the response will include a similar object for each matching NFT image asset. Generally, response fields include:

Name	Description
url	Link to hosting location of the matching NFT image asset: string
contract_address	Unique identifier for the smart contract that implements/references the matching NFT: string
token_id	Unique identifier for the NFT (within the identified contract address) that references the matching image: string
token_url	Link to metadata file (link to image, descriptors etc.) referenced by the matching NFT: string
image_hash	A cryptographic hash of the matching NFT image asset: string
blockchain	Name of the blockchain on which the token is located (e.g., "Ethereum," "Polygon"): string
metadata	Subfields include names, descriptions, or attributes specified in the metadata file hosted at the token_url of the matching NFT: all strings
similarity_score	Similarity metric between the query image and the matching NFT image asset. Float value between 0 and 1. 1.0 indicates an exact match between the two images, while lower values indicate that the query image has been modified to some extent.