opensea-vendor

Query OpenSea marketplace and NFT data across supported EVM chains.

3|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill opensea-vendor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opensea-vendor
Source: https://github.com/Pieverse-Eng/purrfect-skills/tree/main/opensea/vendor
Command: npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill opensea-vendor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, websocat, wscat, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a dependable vendor data layer for querying OpenSea marketplace and NFT information so agents and scripts can retrieve collections, tokens, listings, offers, events, and swap quotes without implementing API integration from scratch.

Core Features & Use Cases

  • Comprehensive Read Coverage: Collection details, collection stats, NFTs by collection/contract/account, listings and offers, events, and token data across supported chains.
  • Fulfillment & Swap Prep: Obtain fulfillment calldata for buying or accepting offers and get token swap quotes and transaction submission data via MCP.
  • Operational Scripts & CLI: Ready-to-run shell scripts for common endpoints, streaming support for real-time events, and recommended CLI/SDK usage for programmatic access.
  • Robust Error Handling: Built-in HTTP retry logic for rate limits, explicit input validation in scripts, and guidance on credential safety and rate-limit best practices.

Quick Start

Use the opensea-vendor skill to fetch collection stats for boredapeyachtclub and the best listing for token 1234 on ethereum.

Frequently Asked Questions about opensea-vendor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query OpenSea NFT collection stats and listings across EVM chains?

To query OpenSea NFT collection stats across EVM chains, use shell scripts or CLI commands to retrieve read-only marketplace data including collections, NFTs, listings, and offers, outputting results as JSON for consumption.

Can I get OpenSea fulfillment calldata and token swap quotes via MCP?

Yes, you can obtain OpenSea fulfillment calldata and token swap quotes via MCP. The skill prepares fulfillment calldata for buying or accepting offers and generates token swap quotes with transaction submission data.

Do I need an OPENSEA_API_KEY to retrieve marketplace data and events?

Yes, an OPENSEA_API_KEY is required to retrieve OpenSea marketplace data and events. An optional OPENSEA_MCP_TOKEN can also be configured for MCP-based operations and swap quote generation.

What's the best way to stream OpenSea marketplace events in real-time?

The best way to stream OpenSea marketplace events in real-time is using websocat or wscat dependencies. The skill provides streaming support to monitor real-time marketplace events across supported EVM chains via shell scripts.

How do I handle HTTP 429 rate limits when querying OpenSea API endpoints?

To handle HTTP 429 rate limits when querying OpenSea API endpoints, the skill implements built-in retry-on-429 behavior. It includes explicit input validation in scripts and provides credential safety guidance along with rate-limit best practices.

Does curl work for fetching OpenSea NFT data and compact TOON outputs?

Yes, curl works for fetching OpenSea NFT data and generating compact TOON outputs. The skill relies on curl for HTTP operations, producing JSON or compact TOON outputs specifically formatted for agent consumption.