v2.2.2

What's Changed

Marketplace docs — Seaport order creation

references/marketplace-api.md and references/seaport.md:

• Fix stale /hash/ segment in the GET /api/v2/orders/chain/{chain}/protocol/{protocol_address}/{order_hash} and matching cancel-order paths so the documented routes match the OpenAPI spec and the opensea-order.sh script.
• Document the fields an agent needs to actually submit a Seaport listing or offer:
  • counter — Seaport nonce for the offerer, with guidance on getCounter(address) / "0" default.
  • protocol_address — now shown as a top-level field alongside parameters and signature.
  • salt — replaced the "random_salt_value" placeholder with a real uint256 and clarified the format.
  • New Signing Orders (EIP-712) section covering the Seaport 1.6 domain, the OrderComponents / OfferItem / ConsiderationItem types, the totalOriginalConsiderationItems sign-vs-submit caveat, and a viem signing example.
• seaport.md → Creating Listings cross-links to the new section.

Community Contributions

Huge thanks to:

• @viktorcrypt — flagged the stale endpoint paths in ProjectOpenSea/opensea-skill#26.
• @0xildefonso — detailed report of the order-creation documentation gaps in ProjectOpenSea/opensea-skill#22, including an end-to-end reproduction that made the fix easy to scope.

Full Changelog: v2.2.1...v2.2.2

v2.2.1

What's Changed

Metadata and provenance fixes so skill registries and security scanners (e.g. OpenClaw) can correctly identify the skill's source and required environment variables.

• SKILL.md frontmatter now declares homepage, repository, license, and a canonical requires.env list ([OPENSEA_API_KEY]), alongside the existing rich env: map kept for human readers. Privy vars are now explicitly labeled as write/fulfillment-only.
• package.json adds description, homepage, repository, license, and keywords so registry fallbacks also populate correctly.
• README.md gains a "Provenance" section pointing to the canonical public repo and release tags.
• Strengthened credential-safety guidance in SKILL.md: the raw PRIVATE_KEY wallet adapter is local-dev only and must never be used in shared agent environments. Read-only flows do not require any wallet credentials.

Full Changelog: v2.2.0...v2.2.1

v2.2.0

What's Changed

Add shell scripts for the new OpenSea API v2 endpoints shipped in api-types v0.2.1:

• opensea-token-groups.sh [limit] [cursor] — list token groups (equivalent currencies across chains, e.g. ETH on Ethereum, Base, and Arbitrum share the eth group)
• opensea-token-group.sh <slug> — fetch a single token group
• opensea-auth-request-key.sh — request a free-tier API key without authentication; includes a friendly 429 message pointing to opensea.io/settings/developer if rate-limited

README and SKILL.md updated with the new scripts and CLI command entries.

Full Changelog: ProjectOpenSea/opensea-devtools@skill-v2.1.0...skill-v2.2.0

v2.1.0

What's Changed

• fix(skill): declare all wallet provider env vars in metadata (#53)
• docs: add instant API key info across all packages (#56)
• docs: update descriptions to reflect NFT and token support (#61)

Full Changelog: ProjectOpenSea/opensea-devtools@skill-v2.0.0...skill-v2.1.0

v2.0.0

What's Changed

Skill v2.0.0

• Consolidated SKILL.md: Unified documentation for CLI commands, MCP tools, task guides, and workflow reference
• Wallet setup docs: Complete setup guides for Privy, Turnkey, Fireblocks, and Private Key providers
• Wallet policies docs: Privy policy configuration — spending caps, allowlists, chain restrictions
• Token swaps reference: MCP swap workflows, parameters, and response structure
• Unified auth: API key-only authentication (removed OPENSEA_MCP_TOKEN)

Full Changelog: ProjectOpenSea/opensea-devtools@skill-v1.0.0...skill-v2.0.0