Get NFT Collection
Retrieve all NFTs (ERC-721 and ERC-1155) owned by a wallet address. Returns collection name, token ID, image, traits, and floor price. Supports Ethereum, Polygon, Base, and more.
Catalog action Blockchain Data
Retrieve all NFTs (ERC-721 and ERC-1155) owned by a wallet address. Returns collection name, token ID, image, traits, and floor price. Supports Ethereum, Polygon, Base, and more.
At a Glance
| Field | Value |
|---|---|
| Action ID | sim-dune-get-wallet-collectibles |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | sim-dune, blockchain, wallet, nft, collectibles, erc721, erc1155, gallery, ownership, metadata, traits, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Wallet address to get collectibles for |
chainIds | array | No | Chain IDs to query (optional, defaults to all supported chains) |
limit | number | No | Maximum number of collectibles to return (default: 250, max: 2500) |
offset | string | No | Cursor for pagination (use nextOffset from previous response) |
filterSpam | boolean | No | Filter out spam NFTs from results. Default: true |
showSpamScores | boolean | No | Include spam scores in the response to help identify potentially spam NFTs. Default: false |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Wallet address queried |
collectibles | array | Yes | NFT collectibles owned by the wallet |
totalCount | number | No | Number of collectibles in this response page |
hasMore | boolean | Yes | Whether there are more results available |
nextOffset | string | No | Cursor for next page of results |
Examples
json{ "type": "sim-dune-get-wallet-collectibles", "payload": { "address": "0x0000000000000000000000000000000000000000" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/sim-dune-get-wallet-collectibles/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "address": "0x0000000000000000000000000000000000000000" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.