Catalog

The catalog lists everything you can buy: products, countries, periods, unit prices, the current terms and the protocol parameters. No authorization is needed.

Prices in the catalog are for reference. The binding price is only the amount in the 402 response for your exact order.

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

Query parameters

Name	Type	Description
product	String	Optional. Return only this product, for example `?product=IPv4`. Unknown or unpublished product — `400`

Caching

The catalog is rebuilt every 5 minutes. The response has Cache-Control: public, max-age=300 and ETag: "<catalog_version>"; send If-None-Match with this value to get 304 Not Modified. With ?product=P the ETag is "<catalog_version>:P".

Response

Name	Type	Description
generated_at	String	When the catalog was built
catalog_version	String	Changes only when the content changes
currency	Object	`{asset, network, decimals}` of the payment asset
terms	Object	`offer_version`, `offer_url`, `privacy_version`, `privacy_url`, `aup_summary`, `on_expiry`, `refund_policy`. The versions go into `accept_terms` of a new order
intended_use	Object	`{required: true, allowed: [{value, label}]}` — allowed purposes of use
products	Array	Product blocks, see below
product_guide	Object	A short description of every product and `recommendation_by_use` — products recommended for each purpose
protocol	Object	`x402_versions`, `schemes`, `networks`, `extensions`, `quote_ttl_seconds`, `max_timeout_seconds`, `poll`, `rate_limits`, and `sandbox_url` when available

Only products that can be bought right now are published. A product that is missing from the catalog cannot be ordered.

Product blocks

Name	Type	Description
product	String	`IPv4`, `ISP` or `IPv6`
display_name, description	String	Human-readable name and description
attributes	Object	`dedicated`, `rotating`, `ip_version`, `asn_type` (`datacenter` or `isp`), `protocols`, `auth_methods`, `min_quantity`
suitable_for	Array	Recommended purposes
countries	Array	`[{country, periods: [{days, unit_price_usd, unit_price_atomic}]}]` — price of one address for the period at the minimum quantity
options	Array	Always empty

The same block for IPv4_UPTIME and ISP_UPTIME, with display_name ending in 100% uptime and attributes.uptime: true, attributes.gateways: true, auth_methods: ["userpass"]. Only countries and periods where 100% Uptime is available are listed.

Name	Type	Description
product	String	`RESIDENT`
attributes	Object	`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	Array	`[{gb, period_days, price_usd, price_atomic}]` — traffic packages you can buy
connection	Object	Hosts, ports, protocols and the login suffix syntax for geo targeting and sessions (without credentials)
locations_url	String	Where to look up regions, cities and ISPs, when available

Name	Type	Description
product	String	`MOBILE`
attributes	Object	Also `max_quantity_per_line`, `shared_host: true`, `volume_discounts: false`
options	Array	Descriptions of the line options: `operator` and `rotation_min` (required), `service_type` (default `dedicated`)
countries	Array	`[{country, operators: [{operator, name, traffic, service_types: [{service_type, rotations: [{rotation_min, ip_change, periods: [{days, unit_price_usd, unit_price_atomic}]}]}]}]}]` — only combinations that are on sale. `ip_change`: `timer` or `link`

Name	Type	Description
product	String	`MIX` (IPv4 addresses) or `MIX_ISP` (ISP addresses)
distribution	String	How addresses are split between the countries of a package
packages	Array	`[{mix, name, group: {id, name}, countries: [{country, share_pct}], sizes, periods: [{days, totals_usd}]}]`. `totals_usd` follows `sizes`; `null` means no price for this size and period

Example

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 }
    }
}

Unknown product

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

The catalog is being built right after a restart. Retry after Retry-After seconds.

Notes

Unit prices are calculated at the minimum quantity of a product. Volume discounts are not shown in the catalog; they are applied in the 402 price.
The catalog has no stock information. If addresses run out, it becomes known only after the payment; see Get order.