home / utilities / opensea

OpenSea CLI

Official · OpenSea

OpenSea CLI for querying NFT collections, NFTs, listings, offers, events, accounts, tokens, and swap quotes.

$npm install -g @opensea/cli
Language
TypeScript
Stars
6
Category
Utilities
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

OpenSea CLI is the official command-line client for OpenSea's API. It gives you shell access to NFT metadata, marketplace activity, account lookups, token data, and swap quotes, with one metadata-refresh action for NFTs.

What It Enables
  • Inspect collections, NFT assets, contracts, account holdings, and collection stats or traits across OpenSea-supported chains.
  • Monitor marketplace state by listing offers, best listings, sales, transfers, mints, and search results across collections, NFTs, tokens, and accounts.
  • Pull trending or top token data, request swap quotes, and trigger NFT metadata refresh requests when OpenSea's index needs an update.
Agent Fit
  • JSON is the default output, commands are flag-driven, and failures return structured JSON plus distinct exit codes, which fits inspect-parse-retry loops well.
  • Cursor pagination, field filtering, retries, and a health check make it practical to script larger read-heavy workflows without scraping the website.
  • The surface is narrower than the full OpenSea product: agents can inspect and refresh metadata, but they cannot manage listings or execute trades through this CLI.
Caveats
  • Useful operation requires an OpenSea API key.
  • Most commands are read-only wrappers around the OpenSea API, so this is stronger for monitoring and enrichment than for marketplace mutation.