This interface allows you to query personal assets, including token details, collection information, contract specifics, and token attributes.
Request Details
Request Address
GET https://web3.okx.com/api/v5/mktplace/nft/owner/asset-list
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chain | String | Yes | Blockchain name (see Supported Blockchains) |
| contractAddress | String | No | Valid contract address |
| ownerAddress | String | Yes | Valid owner address |
| cursor | String | No | Pagination cursor |
| limit | String | No | Items per page (default: 10, max: 100) |
Response Parameters
Returns an Asset Model object:
| Parameter | Type | Description |
|---|---|---|
| name | String | NFT name |
| tokenId | String | Unique token identifier |
| amount | String | Total supply for this token |
| tokenUri | String | Metadata storage URL |
| image | String | Primary image URL (cached) |
| imagePreviewUrl | String | Preview image URL (cached) |
| imageThumbnailUrl | String | Thumbnail image URL (cached) |
| animationUrl | String | Animation resource URL |
| attributes | Object | Token characteristics |
| assetContracts | Object | Contract details |
| collection | Object | Collection information |
| ownerAddress | String | Current owner's address |
| isLazyMintType | Boolean | Indicates delayed mint status |
Usage Examples
👉 See real-world API implementation examples
Frequently Asked Questions
What chains are supported?
The API currently supports all EVM-compatible blockchains listed in our documentation.
How do I handle pagination?
Use the cursor parameter to navigate through large result sets, combined with the limit parameter for batch sizes.
What's the difference between tokenUri and image fields?
tokenUri points to raw metadata while image displays the processed visual asset.
Why is my query returning empty results?
Ensure: 1) Correct chain selection 2) Valid owner address 3) Properly deployed contract (if filtering by contractAddress).
👉 Need higher rate limits? Upgrade your API access
Best Practices
- Always validate contract addresses before querying
- Implement client-side caching for frequent requests
- Handle rate limits with exponential backoff retry logic
The API provides comprehensive NFT asset management capabilities suitable for wallet applications, marketplace integrations, and portfolio tracking tools.