需要 OpenSea 市场数据或执行 Seaport…

适用于通过 OpenSea 官方 CLI 和 REST API 获取 NFT 市场数据、监控事件、搜索集合/NFT/token/账户，以及构建 Seaport 买卖交易。

适用场景

解决思路

1. 获取 API key：export OPENSEA_API_KEY=$(curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key')，或设置已有 key。
2. 安装 CLI：npm install -g @opensea/cli，或直接使用 npx @opensea/cli@latest <command>。
3. 设置写/履行流程的 Privy 环境变量：export PRIVY_APP_ID=...、export PRIVY_APP_SECRET=...、export PRIVY_WALLET_ID=...。
4. 查询集合最佳挂单：opensea listings best <slug> [--limit <n>]。
5. 查询特定 NFT 的最佳挂单：opensea listings best-for-nft <slug> <token_id>。
6. 查询特定 NFT 的最佳报价：opensea offers best-for-nft <slug> <token_id>。
7. 查询集合所有挂单：opensea listings all <slug> [--limit <n>]。
8. 查询集合所有报价：opensea offers all <slug> [--limit <n>]。
9. 查询 trait offers：opensea offers traits <slug> --type <type> --value <value>。
10. 查询集合统计（地板价、成交量）：opensea collections stats <slug>。
11. 查询 trending collections：opensea collections trending [--timeframe <tf>] [--chains <chains>]。
12. 查询 top collections：opensea collections top [--sort-by <field>] [--chains <chains>]。
13. 查询集合 traits：opensea collections traits <slug>。
14. 获取购买 NFT 的 fulfillment data：opensea-fulfill-listing.sh <chain> <order_hash> <buyer>。
15. 获取出售（接受报价）的 fulfillment data：opensea-fulfill-offer.sh <chain> <order_hash> <seller> <contract> <token_id>。
16. 通用 POST 到 OpenSea API：opensea-post.sh <path> <json_body>。
17. 查询最近事件：opensea events list [--event-type <type>]。
18. 查询集合事件：opensea events by-collection <slug> [--event-type <type>]。
19. 查询特定 NFT 事件：opensea events by-nft <chain> <contract> <token_id>。
20. 查询账户事件：opensea events by-account <address>。
21. 事件类型可选：sale、transfer、mint、listing、offer、trait_offer、collection_offer。
22. 实时事件流：opensea-stream-collection.sh <slug>（需要 websocat）。
23. 列出 drops：opensea drops list [--type <type>]。
24. 获取 drop 详情和阶段：opensea drops get <slug>。
25. 构建 mint 交易：opensea drops mint <slug> --minter <address> [--quantity <n>]。
26. 搜索集合：opensea search <query> --types collection。
27. 搜索 NFTs：opensea search <query> --types nft。
28. 搜索 tokens：opensea search <query> --types token。
29. 搜索 accounts：opensea search <query> --types account。
30. 多类型搜索：opensea search <query> --types collection,nft,token。
31. 搜索时可按链过滤：opensea search "cool cats" --types collection,nft --chains ethereum,base。
32. 解析账户（ENS / 用户名 / 地址）：opensea accounts resolve。
33. 购买 NFT 流程：先用 opensea listings best-for-nft <slug> <token_id> 获取 order_hash，再执行 ./scripts/opensea-fulfill-listing.sh ethereum 0xORDER_HASH 0xYOUR_WALLET 获取 fulfillment 数据，最后通过钱包签名并提交返回的交易数据。
34. 查找集合最便宜挂单：opensea listings best <slug> --limit 1。
35. 获取集合地板价和 24h 成交量：opensea collections stats <slug>。
36. 实时流销售事件：./scripts/opensea-stream-collection.sh <slug>，并通过 jq 格式化输出。
37. 在 listings best-for-nft / offers best-for-nft 与履行调用之间保留 order_hash，不要丢失。
38. 如果未安装 websocat，回退到轮询 opensea events by-collection <slug> [--event-type <type>] 并应用相同过滤器。
39. 区分 slug 和地址：集合用 slug（如 boredapeyachtclub），NFT 用 (chain, contract, tokenId)，不要混用。
40. 安全：不要在客户端代码暴露 OPENSEA_API_KEY 或 Privy 凭据，仅服务端使用。
41. 如果已处于 NFT 购买流程且涉及代币兑换，可使用 opensea swaps quote；但纯跨链 swap 优先 lifi。

适用边界 · 注意事项

• 不适用于通用 NFT 元数据读取（name、image、traits、ownership）以及代币价格、钱包余额、转账历史、通用代币元数据；这些应使用 alchemy-api。
• 不适用于纯跨链 token 交换（无 NFT 市场上下文）；应优先使用 lifi 生态技能。
• 不适用于实时 RPC 读取、gas 查询、交易模拟、账户抽象、智能钱包/嵌入式钱包流程；应使用 alchemy-cli、alchemy-api 或 agentic-gateway。