getOwnedNFTs

Get NFTs owned by an address

Example

import { Insight } from "thirdweb";
const nfts = await Insight.getOwnedNFTs({
client,
chains: [sepolia],
ownerAddress: "0x1234567890123456789012345678901234567890",
});
function getOwnedNFTs(args: {
chains: Array<Readonly<ChainOptions & { rpc: string }>>;
client: ThirdwebClient;
ownerAddress: string;
queryOptions?: Omit<
| undefined
| {
chain?: unknown;
limit?: number;
metadata?: "false" | "true";
page?: null | number;
token_types?: Array<"erc721" | "erc1155">;
},
"chain"
>;
}): Promise<
Array<{
animation_url?: string;
background_color?: string;
balance: string;
chain_id: number;
collection?: {
banner_image_url?: string;
description?: string;
external_link?: string;
featured_image_url?: string;
image_url?: string;
name?: string;
};
contract?: {
address: string;
chain_id: number;
name?: string;
symbol?: string;
type?: "erc721" | "erc1155";
};
description?: string;
external_url?: string;
extra_metadata?: {
attributes?:
| {}
| Array<{
display_type?: string;
trait_type: string;
value: string | number;
}>;
properties?: {};
};
image_url?: string;
metadata_url?: string;
name?: string;
owner_addresses?: Array<string>;
status?: string;
token_address: string;
token_id: string;
video_url?: string;
}>
>;

Parameters

Type

let args: {
chains: Array<Readonly<ChainOptions & { rpc: string }>>;
client: ThirdwebClient;
ownerAddress: string;
queryOptions?: Omit<
| undefined
| {
chain?: unknown;
limit?: number;
metadata?: "false" | "true";
page?: null | number;
token_types?: Array<"erc721" | "erc1155">;
},
"chain"
>;
};

Returns

let returnType: Promise<
Array<{
animation_url?: string;
background_color?: string;
balance: string;
chain_id: number;
collection?: {
banner_image_url?: string;
description?: string;
external_link?: string;
featured_image_url?: string;
image_url?: string;
name?: string;
};
contract?: {
address: string;
chain_id: number;
name?: string;
symbol?: string;
type?: "erc721" | "erc1155";
};
description?: string;
external_url?: string;
extra_metadata?: {
attributes?:
| {}
| Array<{
display_type?: string;
trait_type: string;
value: string | number;
}>;
properties?: {};
};
image_url?: string;
metadata_url?: string;
name?: string;
owner_addresses?: Array<string>;
status?: string;
token_address: string;
token_id: string;
video_url?: string;
}>
>;