This page will help you get started with DeepNFTValue API.

Welcome to DeepNFTValue API. We provide endpoints for NFT-related queries, including our machine-learning driven Valuations.

Authentication

Our API is generally free to use, but all endpoints require authentication. Check out the next page for more info on obtaining a free API Key. You can make requests to DeepNFTValue API by including your API key in the Authorization request header. We use token-based authentication with required prefix "Token". For example:

curl --request GET \
     --url https://api.deepnftvalue.com/v1/valuation/cryptopunks/1 \
     --header 'Authorization: Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061' \
     --header 'accept: application/json'
import requests

url = "https://api.deepnftvalue.com/v1/valuation/cryptopunks/1"

headers = {
    "accept": "application/json",
    "Authorization": "Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061'
  }
};

fetch('https://api.deepnftvalue.com/v1/valuation/cryptopunks/1', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Example Queries

Let's get started with some example queries to show you how our API can be used. We provide up-to-date valuations on all supported NFT collections. Thus, our API covers some very interesting use-cases.

What is the highest-valued CryptoPunk with attribute Beanie?

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061'
  }
};

fetch('https://api.deepnftvalue.com/v1/tokens/cryptopunks?sort=highest_valuation&limit=1&attributes=beanie', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://api.deepnftvalue.com/v1/tokens/cryptopunks?sort=highest_valuation&limit=1&attributes=beanie"

headers = {
    "accept": "application/json",
    "Authorization": "Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061'
  }
};

fetch('https://api.deepnftvalue.com/v1/tokens/cryptopunks?sort=highest_valuation&limit=1&attributes=beanie', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

At the time of writing, the result is CryptoPunk #4513 at a valuation of 1433 ETH. The JSON response also includes other useful token metadata, like last sale price. As you can see, the cost basis for this Punk is 60 ETH, bought on May 16, 2020.

{
  "count": 44,
  "next": "https://api.deepnftvalue.com/v1/tokens/cryptopunks?attributes=beanie&limit=1&offset=1&sort=highest_valuation",
  "previous": null,
  "results": [
    {
      "token_id": 4513,
      "collection": {
        "slug": "cryptopunks",
        "name": "CryptoPunks",
        "contract": null
      },
      "image": {
        "src": "https://deepnftvalue-data.s3.us-west-2.amazonaws.com/nfts_images/cryptopunks/4513.png"
      },
      "attributes": [
        "beanie",
        "luxurious beard",
        "earring",
        "zombie"
      ],
      "is_flagged": false,
      "owner": {
        "address": "0xc43473fa66237e9af3b2d886ee1205b81b14b2c8",
        "name": "tycoon.eth"
      },
      "valuation": {
        "price": "1433.0",
        "currency": "ETH",
        "date": "2022-10-10"
      },
      "active_offer": null,
      "last_sale": {
        "timestamp": "2020-05-16T20:49:18Z",
        "price": "60.0",
        "currency": "ETH",
        "from_address": "0x8321795bdace7428d4fadfa30c2ee8e727e491e5",
        "to_address": "0x51787a2c56d710c68140bdadefd3a98bff96feb4"
      },
      "top_bid": null
    }
  ]
}

Okay, now we want to know more about price history of this specific CryptoPunk. Usually, this is a hard metric to obtain, because there are so few available data points (sales, offers etc.). However, DeepNFTValue provides a daily valuation history. Let's explore..

What was the historical valuation of CryptoPunk #4513 in August 2022?

curl --request GET \
     --url 'https://api.deepnftvalue.com/v1/valuations/hist/cryptopunks?token_ids=4513&start=2022-08-01&end=2022-08-05' \
     --header 'Authorization: Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061' \
     --header 'accept: application/json'
import requests

url = "https://api.deepnftvalue.com/v1/valuations/hist/cryptopunks?token_ids=4513&start=2022-08-01&end=2022-08-05"

headers = {
    "accept": "application/json",
    "Authorization": "Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061'
  }
};

fetch('https://api.deepnftvalue.com/v1/valuations/hist/cryptopunks?token_ids=4513&start=2022-08-01&end=2022-08-05', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

At the beginning of August 2022, CryptoPunk #4513 was valued above 1500 ETH. More price history charts available on our website.

{
    "count": 5,
    "next": null,
    "previous": null,
    "results": [
        {
            "nft": {
                "token_id": 4513,
                "collection": {
                    "slug": "cryptopunks",
                    "name": "CryptoPunks"
                }
            },
            "price": "1522.6",
            "currency": "ETH",
            "date": "2022-08-05"
        },
        {
            "nft": {
                "token_id": 4513,
                "collection": {
                    "slug": "cryptopunks",
                    "name": "CryptoPunks"
                }
            },
            "price": "1547.8",
            "currency": "ETH",
            "date": "2022-08-04"
        },
        {
            "nft": {
                "token_id": 4513,
                "collection": {
                    "slug": "cryptopunks",
                    "name": "CryptoPunks"
                }
            },
            "price": "1535.5",
            "currency": "ETH",
            "date": "2022-08-03"
        },
        {
            "nft": {
                "token_id": 4513,
                "collection": {
                    "slug": "cryptopunks",
                    "name": "CryptoPunks"
                }
            },
            "price": "1555.4",
            "currency": "ETH",
            "date": "2022-08-02"
        },
        {
            "nft": {
                "token_id": 4513,
                "collection": {
                    "slug": "cryptopunks",
                    "name": "CryptoPunks"
                }
            },
            "price": "1530.0",
            "currency": "ETH",
            "date": "2022-08-01"
        }
    ]
}

In addition to attribute-related queries, our Tokens endpoint also supports filtering for flagged NFTs. Using isFlagged parameter, you can check activity of stolen NFTs.

Get three recently listed Bored Apes that are flagged for suspicious activity?

curl --request GET \
     --url 'https://api.deepnftvalue.com/v1/tokens/boredapeyachtclub?sort=recently_listed&limit=3&isFlagged=true' \
     --header 'Authorization: Token 6d3b85e2e7d3679c55dedc0f2b21ef2a72018061' \
     --header 'accept: application/json'

Resulting tokens are Bored Ape Yacht Club #2611, #71 and #5149.

{
  "count": 131,
  "next": "https://api.deepnftvalue.com/v1/tokens/boredapeyachtclub?isFlagged=true&limit=3&offset=3&sort=recently_listed",
  "previous": null,
  "results": [
    {
      "token_id": 2611,
      "collection": {
        "slug": "boredapeyachtclub",
        "name": "Bored Ape Yacht Club",
        "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
      },
      "image": {
        "src": "https://deepnftvalue-data.s3.us-west-2.amazonaws.com/nfts_images/boredapeyachtclub/2611.png"
      },
      "attributes": [
        "background:yellow",
        "eyes:angry",
        "fur:golden brown",
        "earring:gold hoop",
        "clothes:smoking jacket",
        "hat:horns",
        "mouth:phoneme oh"
      ],
      "is_flagged": true,
      "owner": {
        "address": "0xec0b510f89c910b76ddc6c58f767b4813436b9bd",
        "name": null
      },
      "valuation": {
        "price": "91.3",
        "currency": "ETH",
        "date": "2022-10-10"
      },
      "active_offer": null,
      "last_sale": {
        "timestamp": "2022-05-19T05:25:22.451947Z",
        "price": "99.0",
        "currency": "ETH",
        "from_address": "0xbaffd69e70cc5cb224699478ceba8e31cfbdfb90",
        "to_address": "0xec0b510f89c910b76ddc6c58f767b4813436b9bd"
      },
      "top_bid": null
    },
    {
      "token_id": 71,
      "collection": {
        "slug": "boredapeyachtclub",
        "name": "Bored Ape Yacht Club",
        "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
      },
      "image": {
        "src": "https://deepnftvalue-data.s3.us-west-2.amazonaws.com/nfts_images/boredapeyachtclub/71.png"
      },
      "attributes": [
        "background:orange",
        "eyes:bloodshot",
        "mouth:bored",
        "fur:cheetah",
        "clothes:stunt jacket",
        "hat:bowler"
      ],
      "is_flagged": true,
      "owner": {
        "address": "0xdbfd76af2157dc15ee4e57f3f942bb45ba84af24",
        "name": "bayc.benddao.eth"
      },
      "valuation": {
        "price": "98.7",
        "currency": "ETH",
        "date": "2022-10-10"
      },
      "active_offer": null,
      "last_sale": {
        "timestamp": "2022-04-29T05:28:39Z",
        "price": "145.0",
        "currency": "ETH",
        "from_address": "0xae1cfb433cec0740c40320d82b28ecb1caa4a1e7",
        "to_address": "0x969d8499e1f0801795def974a6e53ecadf290b7f"
      },
      "top_bid": null
    },
    {
      "token_id": 5149,
      "collection": {
        "slug": "boredapeyachtclub",
        "name": "Bored Ape Yacht Club",
        "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
      },
      "image": {
        "src": "https://deepnftvalue-data.s3.us-west-2.amazonaws.com/nfts_images/boredapeyachtclub/5149.png"
      },
      "attributes": [
        "background:orange",
        "hat:bayc flipped brim",
        "eyes:sleepy",
        "clothes:black t",
        "fur:pink",
        "mouth:grin",
        "earring:diamond stud"
      ],
      "is_flagged": true,
      "owner": {
        "address": "0x0eb3b031927e6833231159c9ed0fe47efd29842b",
        "name": null
      },
      "valuation": {
        "price": "100.0",
        "currency": "ETH",
        "date": "2022-10-10"
      },
      "active_offer": null,
      "last_sale": {
        "timestamp": "2022-04-10T12:22:42.804099Z",
        "price": "245.0",
        "currency": "ETH",
        "from_address": "0x0a9bf8acbdfd96d491d6cf80b2d45b52a9706935",
        "to_address": "0x5d4e49eee18b3eb6dc5320651d00b40db83a5b4e"
      },
      "top_bid": null
    }
  ]
}