Retrieve contract NFTs

get

https://api.nftport.xyz/v0/nfts/{contract_address}

Returns all NFTs for a given contract address. Can be set to include the NFT metadata, file_information or all which returns extra information. Ethereum and Polygon are supported.

Useful for:

Importing all NFTs from a given contract to your application.

For a quick start, see the List of sample addresses to copy.
To get detailed information on the returned NFTs, see Retrieve NFT details.
To get NFTs that a given account owns, see Retrieve NFTs owned by an account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

contract_address

string

required

Contract address from which to query NFTs also known as the collection address.

Query Params

chain

string

enum

required

Defaults to ethereum

Blockchain from which to query NFTs.

Allowed:

page_number

integer

≥ 1

Defaults to 1

The page number of the results to return. The first page is 1.

page_size

integer

1 to 50

Defaults to 50

The number of results returned per page. Limit can range between 1 and 50, and the default is 50.

include

string

enum

required

Defaults to metadata

Include optional data in the response. default is the minimal response, metadata includes NFT metadata and cached_file_url, file_information includes extra information of the NFT’s file and all includes full details like in Retrieve NFT details.

Allowed:

refresh_metadata

boolean

Defaults to false

Queues and refreshes all the NFTs metadata inside the contract (i.e. all tokens) if they have changed since the updated_date. Useful for example, when NFT collections are revealed.

Response

`nfts` property that contains an array of up to `page_size` NFTs. Each entry in the array is a separate NFT. If no more NFTs are available, the resulting array will be empty.

200A JSON object with an nfts property that contains an array of up to page_size NFTs. Each entry in the array is a separate NFT. If no more NFTs are available, the resulting array will be empty.

`nfts` property that contains an array of up to `page_size` NFTs. Each entry in the array is a separate NFT. If no more NFTs are available, the resulting array will be empty.