Skip to contents

Fetch OpenSea listing URL for NFT marketplace link

Source: R/db-artwork.R
get_art_opensea_url.Rd

Retrieves the direct OpenSea listing URL for an NFT artwork. Use this to provide one-click navigation to the NFT marketplace listing.

Unlike get_artwork_opensea() which returns full NFT metadata, this function returns only the URL for lightweight link generation. Returns NULL if no OpenSea listing exists.

Usage

get_art_opensea_url(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

Character string with OpenSea URL, or NULL if not listed.

See also

get_artwork_opensea() for full NFT metadata, art_has_nft() for existence check.

Other data-access: art_has_nft(), db-frame-analytics, 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_opensea(), get_artwork_profile(), get_artwork_profile_full(), get_artwork_stats(), get_color_codes(), get_verification_info()

Examples

if (FALSE) { # \dontrun{
url <- get_art_opensea_url(artist, artwork)
if (!is.null(url)) {
  # Display OpenSea link button
}
} # }