Fetch NFT listing for marketplace integration

Retrieves NFT listing information for an artwork on OpenSea. Use this to display NFT badges, link to marketplace listings, or verify minting status.

Returns NULL/empty if the artwork hasn't been minted as an NFT. Check the is_nft flag from get_artwork_index() first to avoid unnecessary queries.

Usage

get_artwork_opensea(artist, artwork, cn = NULL)

Arguments

artist

Character. Artist UUID (format: "746bxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated with artcore::validate_uuid() where applicable.

artwork

Character. Artwork UUID (format: "99xxxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated with artcore::validate_uuid() where applicable.

cn

Database connection. If NULL, creates a connection via artcore::dbc() and closes it on exit. Pass an existing connection to batch multiple queries efficiently.

Value

List with: url_os (OpenSea listing URL), contract_address, token_id, and minting metadata

See also

Other data-access: art_has_nft(), db-frame-analytics, get_art_opensea_url(), get_art_print_url(), get_art_purchase_urls(), get_artist_by_slug(), get_artist_collections_summary(), get_artist_index(), get_artist_opensea(), get_artist_recent_works(), get_artist_stats(), get_artist_style_map(), get_artist_tags(), get_artwork_index(), get_artwork_meta(), get_artwork_profile(), get_artwork_profile_full(), get_artwork_stats(), get_color_codes(), get_verification_info()