用途：通过 OpenSea 的 REST API 与实时 Stream API 访问 NFT 市场数据，用于获取 NFT 元数据、集合信息、挂单、报价、事件，以及构建 NFT 看板、分析工具和实时监控应用。
主要能力：按链、合约与 token ID 查询单个 NFT；按集合、合约或账户列出 NFT；获取集合详情、统计（地板价、成交量）与全部特征；查询 NFT 最优/全部挂单、最优/全部报价及特征报价；按 NFT、集合、账户查询销售、转移、挂单、报价、取消等事件；查询账户资料；通过 WebSocket Stream API 订阅 item.listed、item.sold、item.transferred、item.metadata_updated、item.cancelled、item.received_bid 等实时事件；通过 Seaport 协议与 opensea-js 创建挂单、报价和成交订单。
使用方式：需先在 OpenSea 开发者门户创建开发者账号并获取 API Key，设置为环境变量，例如 export OPENSEA_API_KEY="your-api-key"，并确保 curl 与 jq 可用；Stream API 需安装 @opensea/stream-js（npm install @opensea/stream-js）或 Python 的 opensea-stream（pip install opensea-stream）。API 基础地址为 https://api.opensea.io，请求需携带请求头 -H "X-API-KEY: $OPENSEA_API_KEY"。示例：curl -X GET "https://api.opensea.io/api/v2/chain/ethereum/contract/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/nfts/1" -H "X-API-KEY: $OPENSEA_API_KEY"。
适用场景：NFT 数据展示与分析、地板价监控、销售与活动追踪、钱包持仓查询、实时行情推送、程序化挂单与报价。
限制：GET 请求限 4 次/秒，POST 请求限 2 次/秒，超出可返回 429；更高限额需向 OpenSea 开发者门户申请；需处理 400、401、403、404、500 等错误并实现指数退避重试；建议缓存元数据、使用分页、以 Stream API 替代轮询，并在后端代理中保护 API Key，避免前端暴露。具体免费额度、收费与更高限额政策资料未给出，暂未提供。