Get NFTs by wallet address
Returns a paginated list of NFTs owned by the specified wallet address. Supports cursor-based pagination via openseaNextToken.
Parameters
chainIds
* array queryList of blockchain network IDs to query
address
* string queryWallet address of the NFT owner
limit
number queryThe maximum number of assets to return
offset
number queryThe offset number of assets to return
openseaNextToken
string queryThe cursor for the next page of results. This is returned from a previous request.
Request Body
This request doesn’t have any request body.
JavaScript
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
const axios = require('axios');
async function httpCall() {
const url = 'https://api.1inch.com/nft/v2/byaddress';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
chainIds: [1, 137],
address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
limit: 10,
offset: 0,
},
paramsSerializer: {
indexes: null,
},
};
const body = {};
try {
const response = await axios.get(url, body, config);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
Returns
200
400
401
500
Paginated response containing NFT assets and pagination cursor
assets
* array Array of NFT assets
items
NftV2Model object NFT model with basic token information for list views
id
* string Unique identifier (format: chainId:contract:tokenId)
token_id
* string Unique token identifier within the contract
provider
* string (Enum)Data provider source (OPENSEA, RARIBLE, POAP)
OPENSEA
RARIBLE
POAP
name
* string Name of the NFT
chainId
* number Blockchain network identifier
priority
* number Display priority (lower values displayed first)
asset_contract
* any NFT contract information
allOf[0]
AssetContract object NFT contract information including address and token standard
address
* string Contract address on the blockchain
schema_name
* string Token standard (e.g., ERC721, ERC1155)
image_url
* string URL of the NFT image
openseaNextToken
* string next token for get next elements from opensea provider
JSON
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"assets": [
{
"id": "string",
"token_id": "string",
"provider": "OPENSEA",
"name": "string",
"chainId": 0,
"priority": 0,
"asset_contract": {
"address": "string",
"schema_name": "string"
},
"image_url": "string"
}
],
"openseaNextToken": "string"
}