NFT Asset

As the name suggests, assets are a key element of the NFolio platform. Our goal is to provide you with the tools and insights you need to make informed decisions about your NFT assets. With our API, you can access and manipulate asset data programmatically, using a range of endpoints specifically designed for this purpose. Explore this page to learn more about the various asset endpoints available through our API, and how you can use them to manage your NFT assets more effectively. Whether you are a business, developer, or individual interested in the NFT market, our asset endpoints can help you make the most of your investments.

The NFT Asset model

The NFT asset model in NFolio contains all the relevant information about your NFTs, including their asset contract address, token id, and estimated value.

Properties

Name
asset_id
Type
string
Description
Unique identifier for the asset.
Name
token_id
Type
string
Description
The token id for the asset withing its collection.
Name
asset_contract_address
Type
string
Description
The contract address of the asset.
Name
asset_contract_type
Type
string
Description
The contract type of the asset (non-fungible).
Name
asset_contract_schema_name
Type
string
Description
The contract schema name of the asset, usually it's ERC721.
Name
slug
Type
string
Description
Unique identifier of the collection.
Name
name
Type
string
Description
The name of the asset.
Name
description
Type
string
Description
The description of the asset.
Name
external_link
Type
string
Description
The external_link of the collection of the asset.
Name
image_url
Type
string
Description
The image url of the asset.
Name
image_preview_url
Type
string
Description
The image preview url of the asset.
Name
image_thumbnail_url
Type
string
Description
The image thumbnail url of the asset.
Name
image_original_url
Type
string
Description
The original image url of the asset.
Name
crawled_all
Type
string
Description
-- To be removed --
Name
num_sales
Type
string
Description
Number of sales of the asset -- To be removed --
Name
total_rarity
Type
string
Description
The total rarity score of the assets within its collection.
Name
last_price
Type
string
Description
The last sold price in ETH of the assets during the past 7 days.
Name
greatest_trait_value_stat
Type
string
Description
The summary statistic of the most valuable trait of the asset.
Name
estimated_value
Type
string
Description
NFolio estimated value of the asset in ETH.

GET/v2/nft/{slug}/{token_id}

Get NFT asset

This endpoint allows you to retrieve the asset model of the specified NFT by slug and token id.

Required attributes

Name
slug
Type
string
Description
Unique identifier of the collection.
Name
token_id
Type
string
Description
The token id for the asset withing its collection.

Request

GET

/v2/nft/{slug}/{token_id}

curl -G https://api.nfolio.io/v2/nft/{slug}/{token_id} \
  -H "x-api-key: {your-api-key}" \

Response

{
    "asset_contract_address": "0xed5af388653567af2f388e6224dc7c4b3241c544",
    "asset_contract_schema_name": "ERC721",
    "asset_contract_type": "non-fungible",
    "asset_id": "202832369",
    "crawled_all": 0,
    "description": null,
    "estimated_value": 18.53892489720448,
    "external_link": null,
    "greatest_trait_value_stat": 16.8,
    "image_original_url": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/100.png",
    "image_preview_url": "https://i.seadn.io/gae/APRxMjKX0avXL5bJpKnh_4P_8U7ipywLyw0m_wqiOR9g_qI6hipLBSTQoc5R5oqCVa6xFZD_yVUicMR5CNnH0Bz71icfle5gh6eX-w?w=500&auto=format",
    "image_thumbnail_url": "https://i.seadn.io/gae/APRxMjKX0avXL5bJpKnh_4P_8U7ipywLyw0m_wqiOR9g_qI6hipLBSTQoc5R5oqCVa6xFZD_yVUicMR5CNnH0Bz71icfle5gh6eX-w?w=500&auto=format",
    "image_url": "https://i.seadn.io/gae/APRxMjKX0avXL5bJpKnh_4P_8U7ipywLyw0m_wqiOR9g_qI6hipLBSTQoc5R5oqCVa6xFZD_yVUicMR5CNnH0Bz71icfle5gh6eX-w?w=500&auto=format",
    "last_price":NaN,
    "name": "Azuki #100",
    "num_sales": "0",
    "slug": "azuki",
    "token_id": "100",
    "total_rarity": 678
}