Retrieve NFTs owned by an account

get https://api.nftport.xyz/v0/accounts/{account_address}

Returns NFTs owned by a given account (i.e. wallet) address. Can also return each NFT metadata with include parameter.

Useful for:

For checking if a user owns a specific NFT and then unlocking specific activity.
Adding NFT portfolio section to your apps.

For a quick start, see the List of sample addresses to copy.
To get all NFTs per contract, see Retrieve contract NFTs.
To get extra detailed information on the returned NFTs, see Retrieve NFT details.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

account_address

string

required

Defaults to 0xf5663d0eee3620c4a88e28e392aac72d077a8c4d

Account address from which to fetch NFTs.

Query Params

chain

string

required

Defaults to ethereum

Blockchain from which to query NFTs.

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.

continuation

string

Continuation. Pass this value from the previous response to fetch the next page.

include

array of strings

required

Defaults to metadata

Include optional data in the response. default is the minimal response, metadata includes NFT metadata and file_information includes extra information of the NFT’s file, like in Retrieve NFT details, and contract_information includes information of the NFT’s contract. Fields can be combined to get desired result.

include*

exclude

array of strings

Exclude data from the response. erc721 excludes ERC721 tokens and erc1155 excludes ERC1155 tokens.

exclude

contract_address

string

Filter by and return NFTs only from the given contract address.

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.

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.nftport.xyz/v0/accounts/0xf5663d0eee3620c4a88e28e392aac72d077a8c4d?chain=ethereum&page_size=50&include=metadata' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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.