ankr_getNFTsByOwner
List NFTs (ERC-721/ERC-1155/ENS/POAP) owned by a wallet
POST/?ankr_getNFTsByOwner
Returns the NFTs owned by a wallet across one or more supported chains, with collection metadata, token IDs, image URLs, traits, and pagination cursors. Supports ERC-721, ERC-1155, ENS, and POAP.
Pass walletAddress (hex address, or ENS name on Ethereum). Scope to specific chains with the blockchain array, or omit it for all supported chains. Narrow results with the filter argument: each entry maps a contract address to an array of token IDs (empty array = all NFTs from that contract).
Pagination via pageSize (max 50, default 10) and pageToken. Part of the NFT API product (700 compute units per call, $0.00007 at base rate).
Request
Responses
- 200
- 400
- 401
- 429
- 500
Success. JSON-RPC result envelope contains the NFT asset list, the queried owner, and a pagination cursor. JSON-RPC errors are returned with HTTP 200; check the response body for an error key.
Bad Request — malformed JSON-RPC envelope or invalid params. The gateway rejects before the JSON-RPC layer processes the call.
Unauthorized — missing or invalid API key in the server URL path. Verify that {API_KEY} is set to a valid project key.
Too Many Requests — the API key has exceeded its rate or quota limits. Back off and retry; consider upgrading the Premium tier for higher limits.
Server error — unexpected condition. Retry with exponential backoff; if it persists, file a ticket at https://www.ankr.com/support/.