Nval API (1.1.48)

Download OpenAPI specification:Download

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
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
Response samples
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}

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
Response samples
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}

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
Response samples
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}

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
Response samples
application/json
[
  • {
    }
]