Indexer: List NFTs owned by an address
getNFTsRetrieve all NFTs owned by a wallet address on VeChain, with optional filtering by contract and pagination controls for exploring large collections.
Instructions
Get all NFTs owned by an address using VeWorld Indexer. Endpoint: /api/v1/nfts. Accepts address, optional contractAddress, and pagination (page/size/direction or cursor).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "getNFTs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Zero-based results page number (0 is the first page) | |
| size | No | Results per page (1..150); API default is typically 20 | |
| cursor | No | Opaque cursor for fetching the next page when provided by the API | |
| address | No | Wallet address that owns NFTs to query (0x-prefixed, 40 hex chars) | |
| direction | No | Sort direction for time-based queries; defaults to 'DESC' (newest first) | |
| contractAddress | No | Optional NFT contract address to filter results (VIP‑721/VIP‑181) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| network | Yes |