api.opensea.io 返回 401 或 403
检查 密钥放在 X-API-KEY 请求头里了吗?即时免费密钥是不是已过 7 天?
处理 在 Settings > Developer 创建完整密钥,放进请求头。
国内也能看藏品、地板价和成交——每个研究员、每把密钥固定一个出口,按 OpenSea 的规则来。
OpenSea 在中国大陆打不开:GreatFire 最近一次(2026 年 6 月)测试 opensea.io 被封锁,API 所在的 api.opensea.io 同属被封锁域名,magiceden.io 在 2026 年 8 月的测试中也被封锁,只有 blur.io 最近一次测试可以连接。国内 NFT 研究员需要一条海外出口,才能正常打开市场页面。
OpenSea API 要用自己的密钥。请求在 X-API-KEY 请求头里带上密钥;即时免费密钥 7 天后过期,完整密钥在 Settings > Developer 创建,每个账号最多 3 个,限额会写在响应头里。地板价、持有人数、成交笔数和成交额等藏品统计,来自 /api/v2/collections/{slug}/stats。
OpenSea 的规则决定了怎么配。它在 2026 年 10 月 7 日更新的条款禁止用多个 IP 地址或隐藏流量来源来对抗访问控制、速率限制或流量过滤,API 条款禁止隐藏 API 调用的来源,位于美国制裁国家的用户也不得使用平台。所以每个研究员、每把密钥固定一个出口,控制在限额内;代理是一条线路,不改变你是谁。
可使用方向键横向滚动,阅读完整内容。
| 比较项目 | 选择 | 原因 |
|---|---|---|
| 产品 | 动态住宅代理 | 你选定国家的家庭宽带 IP |
| 计费方式 | 按流量,优质或低价线路 | 藏品页面和 API 返回流量小,按实际 GB 付费 |
| 买几个出口 | 每个研究员、每把 API 密钥一个 | 同一把密钥始终从同一个出口调用 |
| 国家 | 能打开 OpenSea、且你可以使用它的国家 | Web3 场景不会自动预选,生成前自己选 |
| 协议 | HTTP(默认)或 SOCKS5 | 浏览器、Python、curl 都支持 HTTP |
| IP 会变吗 | 在所选国家保持粘性会话,不要开「全球轮换」 | 需要全天固定一个 IP,选静态 ISP |
下面的「配置 OpenSea 代理」按钮会打开 Web3 场景的动态住宅代理,按流量计费。先为所选线路购买流量,生成前选好地区。
可使用方向键横向滚动,阅读完整内容。
| 比较项目 | 静态 ISP | 动态住宅 | 静态机房 |
|---|---|---|---|
| 你得到什么 | 一条租期内固定归你的家庭宽带 IP | 真实家庭宽带 IP:在所选国家保持粘性会话,低价线路也可全球轮换 | 机房固定 IP,控制台里速度最快、价格最低的一档 |
| 价格 | 按 IP 和租期计费,付款前以 PTC 显示(1 PTC = US$1) | 按流量:低价线路 US$1.50/GB、优质线路 US$5.00/GB,1 GB 起 | 按 IP 和租期计费,付款前以 PTC 显示 |
| 最适合 OpenSea | 登录后管理藏品、挂单,一条固定 IP | 在国内查看藏品和统计数据,按 GB 付费 | 服务器全天在密钥限额内读取 API |
价格以美元计,用 PTC 余额支付(1 PTC = US$1)。先充值钱包,再购买需要的线路。自动续费暂未开放,静态 IP 请在到期前到「我的资产」手动续费。
代理要在海外网络下才能连上。在中国大陆,登录 Proxy302 控制台 → 连接工具 → 辅助工具,下载并运行,使用代理期间保持开着;工具和脚本里用辅助工具显示的本地地址和端口代替代理的主机和端口,用户名密码不变。已有能连海外的 VPN 也可以。
点「配置 OpenSea 代理」打开「动态住宅代理」,使用场景已选 Web3。选择线路,在「流量额度」里点「补充流量」,选套餐或填「自定义 GB」并购买。在「连接配置」里出口模式保持「指定地区 / 保持 IP」,选地区和协议,点「确认费用并生成」。
预期结果 「当前配置」显示按流量、Web3、指定地区 / 保持 IP 和地区。
付款后控制台会打开「我的资产」。在新代理上点「查看凭据」,复制出口地址(主机:端口)、用户名和密码。
在 OpenSea 账号里打开 Settings > Developer,验证邮箱后创建密钥,如实填写用途。每个请求都在 X-API-KEY 请求头里带上它。
像下方示例那样通过代理调用藏品统计接口,每把密钥固定一个出口。浏览器里则在使用同一代理的环境中打开 opensea.io。
预期结果 脚本输出该藏品的地板价、持有人数、成交笔数和成交额。
可使用方向键横向滚动,阅读完整内容。
# pip install requests
import requests
PROXY = "http://USERNAME:PASSWORD@HOST:PORT" # residential endpoint from My assets
PROXIES = {"http": PROXY, "https": PROXY}
API_KEY = "YOUR_OPENSEA_API_KEY"
SLUG = "doodles-official" # collection slug from the OpenSea URL
r = requests.get(f"https://api.opensea.io/api/v2/collections/{SLUG}/stats",
headers={"X-API-KEY": API_KEY}, proxies=PROXIES, timeout=30)
r.raise_for_status()
total = r.json()["total"]
print("floor:", total["floor_price"], total["floor_price_symbol"])
print("owners:", total["num_owners"], "sales:", total["sales"])
print("volume:", total["volume"], total["volume_symbol"])
读取某个藏品的地板价、持有人数、成交笔数和成交额。floor_price 要配合 floor_price_symbol、volume 要配合 volume_symbol 看,两者可能是不同币种;每把 API 密钥固定用一个出口。国内本机运行时 HOST:PORT 换成辅助工具的本地地址和端口。
检查 密钥放在 X-API-KEY 请求头里了吗?即时免费密钥是不是已过 7 天?
处理 在 Settings > Developer 创建完整密钥,放进请求头。
检查 离响应头里的限额还有多少?
处理 降低频率、缓存结果。不要把一个任务拆到多个 IP 上——OpenSea 条款禁止这样做。
检查 同一浏览器里 ipinfo.io 显示的是海外出口吗?辅助工具开着吗?
处理 修正浏览器代理或启动辅助工具后刷新;页面弹出安全验证时在浏览器里完成。
opensea.io 在中国大陆被封锁。先打开辅助工具,在浏览器上接入一条海外住宅代理,再访问 OpenSea;脚本通过同一代理调用 API。
最常见的是网络被拦。接入代理后仍加载不全,先用 ipinfo.io 确认出口在海外,再看浏览器里有没有待完成的安全验证。
不能。OpenSea 条款禁止用多个 IP 地址对抗它的速率限制或流量过滤。请在密钥限额内使用,完整密钥的限额高于即时免费密钥。
OpenSea 的 API 条款禁止隐藏 API 调用的来源,但没有专门提到代理。每把密钥固定一个出口(全天运行的任务用静态 IP),创建密钥时如实填写用途;拿不准自己的用法是否符合条款,先问 OpenSea。
代理解决的是你所在网络打不开网站的问题,不改变 OpenSea 的使用资格:位于美国制裁国家的用户和受制裁者不得使用平台。
看公开藏品和统计用粘性模式的动态住宅;登录后管理藏品、挂单用静态 ISP,一条固定 IP。
第三方来源 · 核对于:
2026-10-18 读取:opensea.io 最近一次测试(2026-06-14,之后未再测试)被封锁;api.opensea.io 同属被封锁域名;magiceden.io 被封锁(2026-08-11);blur.io 最近一次有效测试可以连接。
第三方连通性测试,个别网络可能不同。
官方文档 · 核对于:
第 3 条:位于、常住于美国制裁国家或依其法律设立的用户,以及受制裁者,不得使用平台。第 8 条:不得使用未经授权的工具、多个 IP 地址或隐藏流量来源来对抗其访问控制、速率限制或流量过滤。第 10 条(API 条款):不得隐藏 API 调用的来源。条款没有提到代理或 VPN。
官方文档 · 核对于:
密钥放在 X-API-KEY 请求头;即时免费密钥通过 POST https://api.opensea.io/api/v2/auth/keys 获取,7 天后过期;完整密钥在验证邮箱后于 Settings > Developer 创建,每个账号最多 3 个;限额在创建时和响应头中返回。
官方文档 · 核对于:
GET https://api.opensea.io/api/v2/collections/{slug}/stats,带 x-api-key 请求头;返回 total(floor_price、floor_price_symbol、num_owners、sales、volume、volume_symbol)和 intervals。
产品观察 · 核对于:
2026-10-18 核对控制台源码:Web3 场景下的动态住宅页面按流量计费,可选「优质线路」或「低价线路」(用预购流量包,或在账号支持时用「PTC 钱包扣费」),默认出口模式为「指定地区 / 保持 IP」——在所选国家生成粘性会话,不承诺永久固定 IP;「全球轮换」只在低价线路 + 预购流量时可用。协议 HTTP 或 SOCKS5,每次生成一个出口。页面上的 Web3 提示为「公开资料研究:按实际流量 · HTTP CONNECT / SOCKS5 · 自选地区 · 遵守目标服务限额」。
产品观察 · 核对于:
价格页公布:动态住宅低价线路 US$1.50/GB、优质线路 US$5.00/GB,均 1 GB 起;账户以 PTC 结算,1 PTC = US$1.00;静态 ISP 与机房 IP 的租金取决于地区、数量和租期,付款前显示(2026-10-09 已与生产环境商品目录核对)。
产品观察 · 核对于:
教程说明:在中国大陆,代理要在海外网络下才能连上;在控制台「连接工具 → 辅助工具」下载并运行免费的辅助工具,再把它显示的本地地址和端口填进指纹浏览器、浏览器插件或手机,账号密码不变;已有能连海外的 VPN 也可以。
注册账号、一次充值,即可选择动态住宅、静态 ISP 或数据中心出口。动态住宅覆盖 195+ 国家与地区。