目录 | Proxy-seller

该目录列出了所有可购买的项目：产品、国家、时期、单价、当前条款及协议参数。无需授权。

目录中的价格仅供参考。最终价格仅以402 针对您具体订单的回复。

GEThttps://proxy-seller.com/api/x402/v1/catalog

查询参数

名称	类型	描述
产品	字符串	可选。仅返回此产品，例如`?product=IPv4`. 未知或未发布的产品 —`400`

缓存

该目录每5分钟更新一次。响应内容为Cache-Control: public, max-age=300 以及ETag: "<catalog_version>"; 发送If-None-Match 使用此值以获得304 Not Modified。使用?product=P ETag 是"<catalog_version>:P".

名称	类型	描述
生成时间	字符串	在构建该目录时
catalog_version	字符串	仅在内容变更时进行修改
货币	对象	`{asset, network, decimals}` 支付资产的
术语	对象	`offer_version`,`offer_url`,`privacy_version`,`privacy_url`,`aup_summary`,`on_expiry`,`refund_policy`。各版本内容如下：`accept_terms` 新订单
intended_use	对象	`{required: true, allowed: [{value, label}]}` — 允许的使用目的
产品	数组	产品模块，详见下文
product_guide	对象	每款产品的简要描述以及`recommendation_by_use` — 针对不同用途的推荐产品
协议	对象	`x402_versions`,`schemes`,`networks`,`extensions`,`quote_ttl_seconds`,`max_timeout_seconds`,`poll`,`rate_limits`，以及`sandbox_url` 如有提供

仅发布当前可购买的产品。目录中未列出的产品无法订购。

产品模块

名称	类型	描述
产品	字符串	`IPv4`,`ISP` 或`IPv6`
display_name, description	字符串	易于理解的名称和描述
属性	对象	`dedicated`,`rotating`,`ip_version`,`asn_type` (`datacenter` 或`isp`),`protocols`,`auth_methods`,`min_quantity`
适用对象	数组	推荐用途
国家	数组	`[{country, periods: [{days, unit_price_usd, unit_price_atomic}]}]` — 该期间内单个地址的最低数量价格
选项	数组	始终为空

同一段落用于IPv4_UPTIME 以及ISP_UPTIME，其中display_name 以……结尾100% uptime 以及attributes.uptime: true,attributes.gateways: true,auth_methods: ["userpass"]。此处仅列出可实现100%在线率的国家及时间段。

名称	类型	描述
产品	字符串	`RESIDENT`
属性	对象	`rotating`,`asn_type: residential`,`protocols`,`auth_methods: ["userpass"]`,`geo_selection: per_request_login_suffix`,`unused_traffic: expires`,`one_package_per_account: true`,`topup_resets_period: true`
traffic_tiers	数组	`[{gb, period_days, price_usd, price_atomic}]` — 可购买的流量套餐
连接	对象	用于地理定位和会话（不含凭据）的服务器、端口、协议及登录后缀语法
locations_url	字符串	如有相关信息，应查阅哪些来源以获取地区、城市及互联网服务提供商（ISP）的信息

名称	类型	描述
产品	字符串	`MOBILE`
属性	对象	此外`max_quantity_per_line`,`shared_host: true`,`volume_discounts: false`
选项	数组	各选项的说明：`operator` 以及`rotation_min` （必填），`service_type` (默认`dedicated`)
国家	数组	`[{country, operators: [{operator, name, traffic, service_types: [{service_type, rotations: [{rotation_min, ip_change, periods: [{days, unit_price_usd, unit_price_atomic}]}]}]}]}]` — 仅限正在销售的组合。`ip_change`:`timer` 或`link`

名称	类型	描述
产品	字符串	`MIX` (IPv4 地址) 或`MIX_ISP` （ISP 地址）
分发	字符串	如何将地址按包裹所涉及的国家进行拆分
包	数组	`[{mix, name, group: {id, name}, countries: [{country, share_pct}], sizes, periods: [{days, totals_usd}]}]`.`totals_usd` 如下`sizes`;`null` 表示此尺寸和期间无价格

示例

https://proxy-seller.com/api/x402/v1/catalog?product=IPv4

{
    "generated_at": "2026-11-02T10:00:44Z",
    "catalog_version": "df92823171697caa9dc15a42",
    "currency": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "network": "eip155:8453",
        "decimals": 6
    },
    "terms": {
        "offer_version": "2026-07-01",
        "offer_url": "https://proxy-seller.com/terms-of-service",
        "privacy_version": "2026-07-01",
        "privacy_url": "https://proxy-seller.com/privacy-policy",
        "aup_summary": ["no CSAM", "no DDoS", "no spam", "no credential stuffing"],
        "on_expiry": "access is disabled on the expiry date, no grace period",
        "refund_policy": "no refund on AUP suspension"
    },
    "intended_use": {
        "required": true,
        "allowed": [
            { "value": "web-scraping", "label": "Web scraping / data collection" },
            { "value": "price-monitoring", "label": "Price and marketplace monitoring" },
            { "value": "seo-monitoring", "label": "SERP and SEO monitoring" },
            { "value": "ads-verification", "label": "Ad verification" }
        ]
    },
    "products": [
        {
            "product": "IPv4",
            "display_name": "Dedicated IPv4",
            "description": "Dedicated datacenter IPv4 address, not shared.",
            "attributes": {
                "dedicated": true,
                "rotating": false,
                "ip_version": 4,
                "asn_type": "datacenter",
                "protocols": ["http", "https", "socks5"],
                "auth_methods": ["userpass", "ip"],
                "min_quantity": 1
            },
            "suitable_for": ["web-scraping", "price-monitoring", "seo-monitoring"],
            "countries": [
                {
                    "country": "US",
                    "periods": [
                        { "days": 7, "unit_price_usd": "0.90", "unit_price_atomic": "900000" },
                        { "days": 30, "unit_price_usd": "1.80", "unit_price_atomic": "1800000" },
                        { "days": 60, "unit_price_usd": "3.49", "unit_price_atomic": "3490000" }
                    ]
                }
            ],
            "options": []
        }
    ],
    "product_guide": {
        "IPv4": "Cheapest dedicated option with the highest throughput, easiest to detect. Best for tolerant targets.",
        "recommendation_by_use": { "web-scraping": ["ISP", "MIX_ISP", "IPv4", "MIX", "RESIDENT", "MOBILE"] }
    },
    "protocol": {
        "x402_versions": [2],
        "schemes": ["exact"],
        "networks": [
            {
                "network": "eip155:8453",
                "assets": ["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],
                "asset_transfer_methods": ["eip3009"],
                "payment_flow": "upfront"
            }
        ],
        "extensions": ["bazaar"],
        "quote_ttl_seconds": 900,
        "max_timeout_seconds": 900,
        "poll": { "default_interval_seconds": 10, "max_wait_seconds": 1800 },
        "rate_limits": { "unpaid_orders_per_min": 30 }
    }
}

未知产品

{
    "error": "invalid_request",
    "message": "Request is invalid",
    "retryable": false,
    "retry_action": "abandon",
    "detail": "/product: unknown product, see /catalog"
}

该目录正在重启后构建中。请稍后再试Retry-After 秒。

注释

单价按产品的最低订购量计算。目录中不显示批量折扣；这些折扣将在402 价格。
该目录不包含库存信息。若地址用尽，则需在付款后方能得知；详见获取订单.

目录

查询参数

缓存

回复

产品模块

示例

注释

On this page