Parameters

NameTypeDescription
paramsConfiguration parameters
params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
params.collectionAddress - The collection contract address
params.collectibleId - The specific token ID to fetch listings for
params.filter - Optional filtering parameters (marketplace, currencies, etc.)
params.page - Optional pagination parameters
params.query - Optional React Query configuration

Returns

Query result containing listings data for the collectible

Example

Basic usage:
const { data, isLoading } = useListListingsForCollectible({
chainId: 137,
collectionAddress: '0x...',
collectibleId: '123'
})
With pagination:
const { data } = useListListingsForCollectible({
chainId: 1,
collectionAddress: '0x...',
collectibleId: '456',
page: {
page: 2,
pageSize: 20
}
})
With filtering:
const { data } = useListListingsForCollectible({
chainId: 137,
collectionAddress: '0x...',
collectibleId: '789',
filter: {
marketplace: [MarketplaceKind.sequence_marketplace_v2],
currencies: ['0x...'] // Specific currency addresses
}
})

Basic Usage

import { useListListingsForCollectible } from '@0xsequence/marketplace-sdk/react/hooks';

const result = useListListingsForCollectible({
  // Add your parameters here
});