Get Paginated NFTs for a given Collection contract address, including metadata for all NFTs (where available).
GET/:network/nft/by-address
Get Paginated NFTs for a given Collection contract address, including metadata for all NFTs (where available).
Request
Path Parameters
Blockchain network name or chain id
Query Parameters
The unique identifier (contract address) of the NFT contract in hexadecimal format.
Page number for pagination
Number of tokens per page, Max 100 per page
The id of your project. Can be found in your Histori dashboard.
Responses
- 200
- 400
Boolean indicating if the user is the owner of the NFT.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Blockchain network name For the requested query
The chain ID of the network.
The current page number
The number of tokens returned per page
The total number of NFTs in the collection
The total number of pages for the requested range
Link to the next page of tokens
Link to the previous page of tokens
tokens
object[]
required
The list of NFTs for the current page
The token ID for the specific NFT.
The URI of the NFT, which can be an HTTP or IPFS URL.
The metadata of the token, which can include images, attributes, and other data.
The address of the owner of the NFT.
The address of the contract that issued the NFT.
The name of the NFT.
The symbol of the NFT.
{
"network_name": "eth-mainnet",
"chain_id": 1,
"page": 1,
"limit": 10,
"total_results": 100,
"total_pages": 10,
"next": "https://api.histori.xyz/v1/eth-mainnet/tokens?page=2&limit=10",
"previous": "https://api.histori.xyz/v1/eth-mainnet/tokens?page=1&limit=10",
"tokens": [
{
"token_id": 2,
"token_uri": "https://ipfs.io/ipfs/QmXUpbiHn8R42REihF5K8iEdi5yq6Xg81nVTfETLfCfK6k/metadata.json",
"metadata": {
"name": "peace",
"description": "peace",
"image": "https://ipfs.io/ipfs/Qmdw9iDyhb4V5njWgvPcCb71sdws2TZh77jEhqZn2TTiNE/nft.jpg"
},
"owner": "0x6b175474e89094c44da98b954eedeac495271d0f",
"token_address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"name": "CryptoKitties",
"symbol": "RARI"
}
]
}
Address is not a valid nft collection contract.