NFT History

This page provides information about the NFT History endpoints, which allow you to access detailed data about your NFT assets programmatically. Use these endpoints to track and analyze the history of your assets

The NFT History model

The NFT History model in NFolio includes data on the historical estimated price of your NFTs at the intra-daily level. This information can be useful for tracking the value of your assets over time and making more informed investment decisions.

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
    result
    Type
    string
    Description

    The result object with historical details on the estimated price of your asset.


GET/v2/nft_history/{slug}/{token_id}

Get NFT Estimates History

This endpoint allows you to retrieve the historical estimated price 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.

Optional attributes

  • Name
    from_date
    Type
    string
    Description

    The date used to filter the results from the specified date 'YYYY-MM-DD'.

  • Name
    to_date
    Type
    string
    Description

    The date used to filter the results to the specified date 'YYYY-MM-DD'.

  • Name
    limit
    Type
    string
    Description

    Limit the number of contacts returned.

  • Name
    offset
    Type
    string
    Description

    The desired number of results to skip.

Request

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

Response

{
    "asset_contract_address": "0xed5af388653567af2f388e6224dc7c4b3241c544",
    "token_id": "100",
    "asset_id": "202832369",
    "results": [
        {
            "estimated_timestamp": "2023-01-03 01:00:00",
            "estimated_value": 19.935250403900543,
            "greatest_trait_value_stat": 16.8,
            "last_price":NaN
        },
        {
            "estimated_timestamp": "2023-01-03 13:00:00",
            "estimated_value": 19.932500244658343,
            "greatest_trait_value_stat": 16.8,
            "last_price":NaN
        },
        {
            "estimated_timestamp": "2023-01-04 01:00:00",
            "estimated_value": 18.033655322522765,
            "greatest_trait_value_stat": 16.8,
            "last_price":NaN
        }
    ]
}