Nval API (1.1.48)

Download OpenAPI specification:Download

URL: https://www.nval.com/support License: NVAL Terms of Service

The Nval API is the access point to all Nval NFT pricing and market data

Introduction

The Nval API is your access point for the most advanced NFT market pricing analytics data available.

Our technology utilizes our proprietary data set that combines on-chain, off-chain, OTC, and extraneous data points to calculate Fair Market Value (FMV) and NFT benchmarks.

Nval data is responsive to current and historical market conditions allowing regulated (or any) businesses, protocols, and platforms to manage assets and offer better products to their customers.

Nval prices NFTs on Ethereum, Polygon (Matic), and soon on: Flow, Solana, Binance Smart Chain, Arbitrum, Optimism, Tezos, Avalanche, Klatyn, etc. We’re adding more chains steadily and will support all blockchains where NFTs markets exist.

Authentication

OAuth2 - an open protocol to allow secure authorization in a simple and standard method from web, mobile and desktop applications.

Request Token

Use to request Token

Securitynval_auth

Request

Request Body schema: application/x-www-form-urlencoded

client_id	string
client_secret	string
grant_type	string

Responses

200

A successful response

400

invalid client credientals

post/oauth/token

Request samples

Payload
curl

application/x-www-form-urlencoded

client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&client_secret=secret&grant_type=client_credentials

Response samples

application/json

{"access_token": "string",
"token_type": "string",
"expires_in": 0
}

Price Prediction

Used to request the current price prediction for a specified token

Securitynval_auth

Request

path Parameters

network required	string The network the collection is on Enum: "ethereum" "polygon"
collection_id required	string Contract address for the specified NFT
nft_id required	integer Unique identifier for the NFT

Responses

200

A successful response

400

Token not available

404

Collection not available

get/v1/priceprediction/{network}/{collection_id}/{nft_id}

Request samples

curl

Response samples

application/json

{"count": 0,
"next": "string",
"previous": "string",
"results": [{"datetime": "string",
"price": 0,
"usd_price": 0,
"token_price": 0,
"token_name": "string",
"confidence": 0,
"nft_info": {"collection_address": "string",
"collection_name": "string",
"nft_id": 0,
"nft_title": "string",
"token_name": "string"
},
"feature_importance": [{"category": {"property1": "string",
"property2": "string"
},
"subcategories": {"property1": "string",
"property2": "string"
}
}
]
}
]
}

Price History

Used to request price prediction history for a specified token, date range, and interval

Securitynval_auth

Request

path Parameters

network required	string The network the collection is on Enum: "ethereum" "polygon"
collection_id required	string
nft_id required	integer

query Parameters

startDate	string
endDate	string
interval	string

Responses

200

A successful response

400

Token not available

404

Collection not available

get/v1/pricepredictionhistory/{network}/{collection_id}/{nft_id}

Request samples

curl

Response samples

application/json

{"count": 0,
"next": "string",
"previous": "string",
"results": [{"datetime": "string",
"price": 0,
"usd_price": 0,
"token_price": 0,
"token_name": "string",
"confidence": 0,
"nft_info": {"collection_address": "string",
"collection_name": "string",
"nft_id": 0,
"nft_title": "string",
"token_name": "string"
},
"feature_importance": [{"category": {"property1": "string",
"property2": "string"
},
"subcategories": {"property1": "string",
"property2": "string"
}
}
]
}
]
}

Transaction History

Used to request transactions within a given date range for a token

Securitynval_auth

Request

path Parameters

network required	string The network the collection is on Enum: "ethereum" "polygon"
collection_id required	integer
nft_id required	integer

query Parameters

startDate	string
endDate	string

Responses

200

A successful response

400

Token not available

404

Collection not available

get/v1/transactionhistory/{network}/{collection_id}/{nft_id}

Request samples

curl

Response samples

application/json

{"count": 0,
"next": "string",
"previous": "string",
"results": [{"datetime": "string",
"price": 0,
"usd_price": 0,
"token_price": 0,
"token_name": "string",
"confidence": 0,
"nft_info": {"collection_address": "string",
"collection_name": "string",
"nft_id": 0,
"nft_title": "string",
"token_name": "string"
},
"feature_importance": [{"category": {"property1": "string",
"property2": "string"
},
"subcategories": {"property1": "string",
"property2": "string"
}
}
]
}
]
}

Collections

Get all the supported collections for a chain

Securitynval_auth

Request

path Parameters

network

required

string

The network the collections are on

Enum: "ethereum" "polygon"

Responses

200

A successful response

404

Collections not available for selected chain

get/v1/collections/{network}

Request samples

curl

Response samples

application/json

[{"collection_address": "string",
"collection_name": "string"
}
]