artopensea

artopensea is an R wrapper for the OpenSea API v2, providing programmatic access to NFT metadata, account information, and collection data from the world’s largest NFT marketplace. It enables R users to build NFT portfolio dashboards, verify ownership, and integrate OpenSea marketplace data into Shiny applications without requiring direct blockchain node access.

Installation

# Install from GitHub (requires GITHUB_PAT)
pak::pkg_install("artalytics/artopensea")

Environment Variables

Required

• ART_OPENSEA_KEY Your OpenSea API key. Required for all API calls.

  Sys.setenv(ART_OPENSEA_KEY = "your-api-key")

  Get a key at: https://docs.opensea.io/reference/api-keys

Quick Example

library(artopensea)
library(jsonlite)

# Parse OpenSea URL to extract NFT identifiers
url <- "https://opensea.io/assets/matic/0x6444522C5aD44285b7856dd3336D09Fb939865F1/2"
parts <- parseOpenseaURL(url)

# Fetch NFT metadata
nft_json <- get_os_nft(
    id = parts$id,
    chain = parts$chain,
    contract = parts$contract
)

# Parse and display
nft <- fromJSON(nft_json)
cat(nft$nft$name, "\n")
cat(nft$nft$description, "\n")
cat("Image:", nft$nft$image_url, "\n")

# Generate OpenSea badge for Shiny
badge <- getOpenseaBadge(
    contract = parts$contract,
    id = parts$id,
    chain = parts$chain
)

Package Hierarchy

artopensea is a standalone API client package with no internal Artalytics dependencies. It depends only on:

• httr2 for HTTP requests
• stringr for string manipulation
• shiny for badge widget generation

Documentation

• Get Started - Package overview and complete workflows
• Quickstart - Hands-on tutorial for immediate productivity
• Advanced Workflow - Complex use cases and performance optimization
• Function Reference - Complete API documentation

Development

For AI agent instructions and coding standards, see AGENTS.md.

devtools::test()
devtools::check()

---

Proprietary - Do Not Distribute