Skip to main content

​
OpenSea

ShanoneのOpenSea連携は、NFTマーケットプレイスの全体像をカバーする63個のツールをエージェントに提供します。コレクション・NFTの検索、リスティングとオファー、注文の実行、ポートフォリオ/アカウント統計、オンチェーンのトークンスワップまで対応しています。

​
はじめに

1

OpenSea APIキーを作成する

OpenSea開発者ポータルからキーを発行します。
2

Shanoneにキーを追加する

Shanoneダッシュボードの連携でOpenSeaを選択し、APIキーを貼り付けます。
3

リクエストを再実行する

保存が完了すると、opensea_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはOpenSea向けに63個のツールを、以下のカテゴリに整理して提供しています。
opensea_get_account, opensea_resolve_account, opensea_get_portfolio_stats, opensea_get_portfolio_history, opensea_get_profile_collections, opensea_get_profile_favorites, opensea_get_profile_listings, opensea_get_profile_offers, opensea_get_profile_offers_received
opensea_get_nft, opensea_get_nfts_batch, opensea_get_nfts_by_account, opensea_get_nfts_by_collection
opensea_get_best_listing_nft, opensea_get_best_listings_collection, opensea_get_all_listings_collection, opensea_create_listing_actions, opensea_create_listing, opensea_fulfill_listing, opensea_fulfill_listing_cross_chain
opensea_get_best_offer_nft, opensea_get_offers_nft, opensea_get_offers_collection, opensea_get_trait_offers, opensea_get_all_offers_collection, opensea_build_offer, opensea_create_offer, opensea_create_criteria_offer
opensea_get_order, opensea_cancel_order, opensea_fulfill_offer
opensea_get_collection_stats, opensea_get_collection_floor_prices, opensea_get_collection_holders, opensea_get_collection_offer_aggregates, opensea_get_nft_analytics, opensea_get_nft_metadata, opensea_get_nft_owners, opensea_refresh_nft_metadata
opensea_get_drops, opensea_get_drop, opensea_get_mint_data, opensea_deploy_contract, opensea_get_events, opensea_get_events_by_account, opensea_get_events_by_collection, opensea_get_events_by_nft
opensea_get_swap_quote, opensea_get_swap_transaction, opensea_get_swap_status, opensea_get_supported_tokens, opensea_get_token, opensea_get_token_price, opensea_get_token_balances, opensea_get_token_allowances

​
よくあるユースケース

コレクション調査

コレクションを評価する前にフロア価格、ホルダー数、トレイトの内訳を取得する

ポートフォリオ管理

アカウントのNFT保有状況、リスティング、オファーの動きを一度に確認する

自動ビッディング

単一のNFTではなく、コレクションやトレイト全体に対する条件付きオファーを作成・発行する

クロスチェーンスワップ

購入資金確保に必要なトークンスワップの見積もりと実行を行い、リスティングを成立させる

​
トラブルシューティング

これらのツールは送信前に接続済みウォレットで署名する必要がある未署名の注文ペイロードを返します。署名がクライアント側で行われるかopensea_create_listing_actions経由かをshanone_get_tool_schemaで確認してください。
まずopensea_get_token_allowancesでトークンの許可状況を確認してください。ERC-20での購入(ETH以外)では、マーケットプレイスコントラクトが購入者のトークンを使えるように、事前に承認トランザクションが必要になるのが通常です。
opensea_get_collection_statsなどの集計データはリアルタイムの取引から少し遅れることがあります。特定のNFTのメタデータが古く見える場合はopensea_refresh_nft_metadataを使ってください。