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));

Supported Collections

The majority of our API endpoints utilize collection slugs as distinctive identifiers. At present, our platform supports multiple collections, such as CryptoPunks, Bored Ape Yacht Club, Azuki and others.

Collection NameSlug
CryptoPunkscryptopunks
Wrapped CryptoPunkswrapped-cryptopunks
Bored Ape Yacht Clubboredapeyachtclub
Mutant Ape Yacht Clubmutant-ape-yacht-club
Azukiazuki
Pudgy Penguinspudgypenguins
Nakamigosnakamigos
DeGodsdegods
Meebitsmeebits
Milady Makermilady
Mad Ladsmad-lads
Chromie Squiggle by Snowfrochromie-squiggle-by-snowfro
Fidenza by Tyler Hobbsfidenza-by-tyler-hobbs
Autoglyphsautoglyphs
Ringers by Dmitri Cherniakringers-by-dmitri-cherniak
Gazers by Matt Kanegazers-by-matt-kane
Archetype by Kjetil Golidarchetype-by-kjetil-golid
Meridian by Matt DesLauriersmeridian-by-matt-deslauriers
The Eternal Pump by Dmitri Cherniakthe-eternal-pump-by-dmitri-cherniak
Anticyclone by William Mapananticyclone-by-william-mapan
Subscapes by Matt DesLaurierssubscapes-by-matt-deslauriers
Memories of Qilin by Emily Xiememories-of-qilin-by-emily-xie
Elevated Deconstructions by luxpriselevated-deconstructions-by-luxpris
Singularity by Hideki Tsukamotosingularity-by-hideki-tsukamoto
sail-o-bots by sturecsail-o-bots-by-sturec
Unigrids by Zeblocksunigrids-by-zeblocks
720 Minutes by Alexis André720-minutes-by-alexis-andre

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 , and .

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