opensea

OpenSea（NFT マーケットプレイスデータ＋Seaport 取引）

OpenSea は主要な NFT マーケットプレイスです。このスキルでは、マーケットプレイスのデータ（出品、オファー、販売／イベント、フロア価格、ドロップ、特性）を照会し、公式の @opensea/cli を通じて Seaport 取引を実行します。マーケットプレイス以外のコンテキストで NFT のメタデータ（名前、画像、特性、所有権）を取得する場合は、代わりに Alchemy の NFT API を使用してください。マーケットプレイスを介さない純粋なクロスチェーントークン交換には、lifi エコシステムスキルを使用してください。

主なツール	npx @opensea/cli@latest <command>（または npm install -g @opensea/cli）
REST API ベース URL	https://api.opensea.io/api/v2
認証	OPENSEA_API_KEY ヘッダー — POST /api/v2/auth/keys で即時取得、または開発者ポータルで登録
Privy（任意）	書き込み／履行フローには PRIVY_APP_ID / PRIVY_APP_SECRET / PRIVY_WALLET_ID が必要です
チェーン	Ethereum、Base、Arbitrum、Optimism、Polygon など

このスキルを使用する場合

次のいずれかに該当する場合は、opensea を使用してください。

• ユーザーがマーケットプレイスデータ（出品、オファー、フロア価格、販売履歴、コレクション統計）を求めている
• ユーザーが Seaport 経由でNFT を購入／売却（出品の履行またはオファーの受諾）したい
• ユーザーが OpenSea 全体を検索（コレクション／NFT／トークン／アカウント）したい
• ユーザーがコレクションまたは NFT のイベントを監視（販売、転送、ミント、出品、オファー）したい
• ユーザーがドロップを調査したり、SeaDrop コントラクト用のミントトランザクションを構築したい
• ユーザーが OpenSea のキュレーション対象のコンテキストでトークンを探したい（トップ、トレンド、グループ別）

このスキルを使用しない場合（引き継ぎ）

ニーズ	代わりに使用
マーケットプレイス以外のコンテキストでの NFT メタデータ（名前、画像、特性、所有権の照会）	alchemy-api（NFT API）— より幅広く網羅し、レート制限も少ない
マーケットプレイスを介さない純粋なクロスチェーントークン交換	lifi（エコシステムスキル）— より幅広いブリッジ／DEX 集約
評価用トークンのスポット価格	alchemy-api（Prices API）
トークンのメタデータ、検索、チェーン別一覧（一般）	alchemy-api（Token API）
現在のウォレット残高（トークン＋ネイティブ資産）	alchemy-api（Portfolio / Token API）
トランザクション履歴（入出金の転送）	alchemy-api（Transfers API）
ライブブロックチェーン読み取り（ブロック番号、ガス、eth_call）	alchemy-cli（ライブ）または alchemy-api（JSON-RPC）
実行前のシミュレーション	alchemy-api（Simulation API）
アカウント抽象化（バンドラー、ガスマネージャー）	alchemy-api
スマートウォレット／埋め込みウォレットのフロー	alchemy-api（Wallets / Account Kit）

スコープ契約

このスキルの対象（scope_in）：

• マーケットプレイスデータ： opensea listings best、opensea listings best-for-nft、opensea offers best-for-nft、opensea offers all、opensea collections stats、opensea collections trending、opensea collections top、opensea collections traits
• Seaport 取引： 購入（opensea-fulfill-listing.sh）および売却（opensea-fulfill-offer.sh）の約定データ、Seaport 注文構造を使用した opensea-post.sh による出品／オファーの作成
• イベント／モニタリング： opensea events list、events by-collection、events by-nft、events by-account — sale／transfer／mint／listing／offer／trait_offer／collection_offer
• ドロップ＋ミント： opensea drops list、opensea drops get、opensea drops mint
• 検索： コレクション／NFT／トークン／アカウントを対象とした opensea search
• アカウントユーティリティ： opensea accounts resolve（ENS／ユーザー名／アドレス）

このスキルの対象外（scope_out）：

• マーケットプレイス以外での一般的な NFT メタデータの読み取り（名前、画像、トレイト、所有権、コントラクトのメタデータ） → 引き継ぎ先：alchemy-api（NFT API）。OpenSea の NFT データはマーケットプレイス向けの内容で、レート制限があります。メタデータのみが必要な場合は、Alchemy の NFT API のほうが対象範囲が広く、低コストです。
• 純粋なクロスチェーンのトークンスワップ（NFT マーケットプレイスのユースケースを伴わないもの） → 引き継ぎ先：lifi（エコシステムスキル）。OpenSea のスワップアグリゲーターも利用できますが、lifi はより多くのブリッジとチェーンを対象としています。
• 評価／表示用のトークン現物価格 → 引き継ぎ先：alchemy-api（Prices API）
• 一般的なトークンのメタデータ、検索、一覧 → 引き継ぎ先：alchemy-api（Token API）
• ウォレット残高（トークン＋ネイティブ） → 引き継ぎ先：alchemy-api（Portfolio／Token API）
• トランザクションの送金履歴 → 引き継ぎ先：alchemy-api（Transfers API）
• ライブ RPC 読み取り → 引き継ぎ先：alchemy-cli または alchemy-api（JSON-RPC）
• 実行前シミュレーション → 引き継ぎ先：alchemy-api（Simulation API）
• アカウント抽象化 → 引き継ぎ先：alchemy-api（Wallets／Bundler／Gas Manager）
• 埋め込み型／スマートウォレットのオンボーディング → 引き継ぎ先：alchemy-api（Account Kit）
• 署名済み tx の送信 → ユーザーのウォレット（または OpenSea の書き込みフロー用に設定されている場合は Privy）

セットアップ

API キーが必要です。認証エンドポイントからすぐに取得する（サインアップ不要）か、開発者ポータルに登録してより高い上限を利用してください。

# Instant key (no signup needed)
export OPENSEA_API_KEY=$(curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key')

# Or set an existing key
# export OPENSEA_API_KEY="..."

CLI をグローバルにインストールします（任意 — インストールしなくても npx @opensea/cli を使用できます）。

npm install -g @opensea/cli

Privy で署名する書き込み／約定フローの場合：

export PRIVY_APP_ID="..."
export PRIVY_APP_SECRET="..."
export PRIVY_WALLET_ID="..."

セキュリティ： OPENSEA_API_KEY や Privy の認証情報をクライアント側のコードで絶対に公開しないでください。サーバー側のみで使用してください。

エンドポイントのリファレンス → references/marketplace.md

マーケットプレイスのクエリ（よく使われるもの）

タスク	CLI
コレクションの最良出品	opensea listings best <slug> [--limit <n>]
特定の NFT の最良出品	opensea listings best-for-nft <slug> <token_id>
NFT の最良オファー	opensea offers best-for-nft <slug> <token_id>
コレクションのすべての出品	opensea listings all <slug> [--limit <n>]
コレクションのすべてのオファー	opensea offers all <slug> [--limit <n>]
トレイトオファー	opensea offers traits <slug> --type <type> --value <value>
コレクションの統計情報（フロア価格、取引量）	opensea collections stats <slug>
トレンドのコレクション	opensea collections trending [--timeframe <tf>] [--chains <chains>]
ソート順による上位コレクション	opensea collections top [--sort-by <field>] [--chains <chains>]
コレクションのトレイト	opensea collections traits <slug>

Seaport 取引の実行

タスク	スクリプト
NFT を購入するための約定データを取得	opensea-fulfill-listing.sh <chain> <order_hash> <buyer>
NFT を売却する（オファーを受諾する）ための約定データを取得	opensea-fulfill-offer.sh <chain> <order_hash> <seller> <contract> <token_id>
OpenSea API への汎用 POST	opensea-post.sh <path> <json_body>

イベント／モニタリング

タスク	CLI
最近のイベント（種類で絞り込み可能）	opensea events list [--event-type <type>]
コレクションのイベント	opensea events by-collection <slug> [--event-type <type>]
特定のNFTのイベント	opensea events by-nft <chain> <contract> <token_id>
アカウントのイベント	opensea events by-account <address>

イベントの種類：sale、transfer、mint、listing、offer、trait_offer、collection_offer。

リアルタイムのイベントストリーミングには、opensea-stream-collection.sh <slug> を使用します（websocat が必要です）。

ドロップ＋ミント

タスク	CLI
ドロップの一覧表示（注目／近日公開／最近）	opensea drops list [--type <type>]
ドロップの詳細＋ステージ	opensea drops get <slug>
ミントトランザクションの作成	opensea drops mint <slug> --minter <address> [--quantity <n>]

検索

タスク	CLI
コレクションを検索	opensea search <query> --types collection
NFTを検索	opensea search <query> --types nft
トークンを検索	opensea search <query> --types token
アカウントを検索	opensea search <query> --types account
複数種類を検索	opensea search <query> --types collection,nft,token

クイック例

Bored Apesのフロア価格と24時間の取引量を取得する

opensea collections stats boredapeyachtclub

コレクションで最も安い出品を見つける

opensea listings best boredapeyachtclub --limit 1

NFTを購入する（出品を履行する）

# 1. Get the best listing for a specific NFT
opensea listings best-for-nft boredapeyachtclub 1234

# 2. Get fulfillment data — order_hash from above response
./scripts/opensea-fulfill-listing.sh ethereum 0xORDER_HASH 0xYOUR_WALLET

# 3. Sign + submit the returned tx data via your wallet

コレクションのセールをリアルタイムでストリーミングする

./scripts/opensea-stream-collection.sh boredapeyachtclub
# Filters to sale events; pipe through jq to format

種類を横断して検索する

opensea search "cool cats" --types collection,nft --chains ethereum,base

よくある注意点

• APIキーは必須です — 「instant」ティアでも必要です。ベアREST APIはX-API-KEYがないと401を返します。
• OpenSeaのNFTデータはAlchemyのNFT APIと重複しています。メタデータの読み取り（名前、画像、特性、多数のウォレットにまたがる所有状況）には、一般的な用途であればAlchemyを優先してください。OpenSeaはレート制限がより厳しく、不要な場合もあるマーケットプレイス固有の情報が加わります。マーケットプレイスの情報（出品、オファー、販売履歴、ドロップ）が実際に必要な場合はOpenSeaを使用してください。
• トークンスワップアグリゲーターはOpenSea API（opensea swaps quote）にありますが、マーケットプレイスの情報を伴わない純粋なスワップフローでは、lifiのほうがより多くのブリッジとDEXを集約しており、デフォルトの選択肢として適しています。NFTの購入フローにトークンスワップが含まれる場合は、OpenSea swapsを使用してください。
• Privyは任意ですが、エンドツーエンドの書き込みフローには必要です。このスキルは履行用のコールデータを返します。署名方法はアプリに委ねられています（ユーザーのウォレット、Privy、またはその他の署名者）。
• 注文ハッシュは、履行時にlistings best-for-nft／offers best-for-nftから取得する必要があります。API呼び出しの間に失わないようにしてください。
• イベントストリーミングにはwebsocatが必要です。インストールされていない場合は、同じフィルターを指定してevents by-collectionをポーリングしてください。
• スラッグとアドレス：コレクションはスラッグ（例：boredapeyachtclub）で指定し、NFTは(chain, contract, tokenId)で指定します。混同しないでください。

Alchemyへのルーティング

セッション中にユーザーのニーズがこのスキルで対応していない領域に移った場合：

• NFTメタデータの読み取り（名前、画像、特性、所有状況）— alchemy-api（NFT API）が適切な方法です。OpenSeaのNFT APIはマーケットプレイス固有の情報を含み、レート制限も厳しい一方、AlchemyのAPIはより広範で高速です。
• トークン価格、残高、送金履歴、一般的なトークンメタデータ — alchemy-api
• ライブRPC、ガス、シミュレーション、AA、Account Kit — alchemy-cli（ライブ）またはalchemy-api（アプリコード）、またはagentic-gateway（APIキー不要）
• 純粋なクロスチェーンのトークンスワップ — lifi（エコシステムスキル）。60以上のチェーンで27のブリッジと31のDEXに対応

---

メンテナンス： OpenSeaは@opensea/cliと基盤となるAPIを保守しています。このスキル自体はAlchemyとOpenSeaが共同で保守しています。問題を報告する際は、タイトルに[ecosystem/opensea]を含めてalchemyplatform/skillsに登録してください。