Catalogue

Le catalogue répertorie tout ce que vous pouvez acheter : produits, pays, périodes, prix unitaires, conditions en vigueur et paramètres de protocole. Aucune autorisation n'est requise.

Les prix indiqués dans le catalogue sont donnés à titre indicatif. Le prix ferme correspond uniquement au montant figurant dans le 402 Réponse correspondant exactement à votre commande.

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

Paramètres de requête

Nom	Type	Description
produit	Chaîne de caractères	Facultatif. Ne renvoyez que ce produit, par exemple `?product=IPv4`. Produit inconnu ou non commercialisé — `400`

Mise en cache

Le catalogue est actualisé toutes les 5 minutes. La réponse contient Cache-Control: public, max-age=300 et ETag: "<catalog_version>"; envoyer If-None-Match avec cette valeur pour obtenir 304 Not Modified. Avec ?product=P L'ETag est "<catalog_version>:P".

Réponse

Nom	Type	Description
generated_at	Chaîne de caractères	Lors de la création du catalogue
catalog_version	Chaîne de caractères	Modifications uniquement en cas de changement de contenu
monnaie	Objet	`{asset, network, decimals}` de l'actif de paiement
termes	Objet	`offer_version`, `offer_url`, `privacy_version`, `privacy_url`, `aup_summary`, `on_expiry`, `refund_policy`. Les versions sont détaillées dans `accept_terms` d'une nouvelle commande
utilisation_prévue	Objet	`{required: true, allowed: [{value, label}]}` — utilisations autorisées
produits	Tableau	Blocs de produit, voir ci-dessous
guide_produit	Objet	Une brève description de chaque produit et `recommendation_by_use` — produits recommandés pour chaque usage
protocole	Objet	`x402_versions`, `schemes`, `networks`, `extensions`, `quote_ttl_seconds`, `max_timeout_seconds`, `poll`, `rate_limits`, et `sandbox_url` le cas échéant

Seuls les produits disponibles à l'achat sont publiés. Un produit absent du catalogue ne peut pas être commandé.

Blocs de produit

Nom	Type	Description
produit	Chaîne de caractères	`IPv4`, `ISP` ou `IPv6`
display_name, description	Chaîne de caractères	Nom et description lisibles par l'utilisateur
attributs	Objet	`dedicated`, `rotating`, `ip_version`, `asn_type` (`datacenter` ou `isp`), `protocols`, `auth_methods`, `min_quantity`
suitable_for	Tableau	Objectifs recommandés
pays	Tableau	`[{country, periods: [{days, unit_price_usd, unit_price_atomic}]}]` — prix d'une adresse pour la période, pour la quantité minimale
options	Tableau	Toujours vide

Le même bloc pour IPv4_UPTIME et ISP_UPTIME, avec display_name se terminant par 100% uptime et attributes.uptime: true, attributes.gateways: true, auth_methods: ["userpass"]. Seuls les pays et les périodes où une disponibilité de 100 % est assurée sont répertoriés.

Nom	Type	Description
produit	Chaîne de caractères	`RESIDENT`
attributs	Objet	`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	Tableau	`[{gb, period_days, price_usd, price_atomic}]` — packs de trafic disponibles à l'achat
connexion	Objet	Hôtes, ports, protocoles et syntaxe du suffixe de connexion pour le ciblage géographique et les sessions (sans identifiants)
locations_url	Chaîne de caractères	Où trouver des informations sur les régions, les villes et les FAI, lorsqu'elles sont disponibles

Nom	Type	Description
produit	Chaîne de caractères	`MOBILE`
attributs	Objet	Par ailleurs `max_quantity_per_line`, `shared_host: true`, `volume_discounts: false`
options	Tableau	Descriptions des options de ligne : `operator` et `rotation_min` (obligatoire), `service_type` (par défaut `dedicated`)
pays	Tableau	`[{country, operators: [{operator, name, traffic, service_types: [{service_type, rotations: [{rotation_min, ip_change, periods: [{days, unit_price_usd, unit_price_atomic}]}]}]}]}]` — uniquement les combinaisons disponibles à la vente. `ip_change`: `timer` ou `link`

Nom	Type	Description
produit	Chaîne de caractères	`MIX` (adresses IPv4) ou `MIX_ISP` (Adresses IP)
distribution	Chaîne de caractères	Répartition des adresses entre les pays d'un colis
paquets	Tableau	`[{mix, name, group: {id, name}, countries: [{country, share_pct}], sizes, periods: [{days, totals_usd}]}]`. `totals_usd` suit `sizes`; `null` signifie « pas de prix pour cette taille et cette période »

Exemple

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

Produit inconnu

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

Le catalogue est en cours de constitution juste après un redémarrage. Veuillez réessayer après Retry-After secondes.

Remarques

Les prix unitaires sont calculés sur la base de la quantité minimale d'un produit. Les remises sur volume ne figurent pas dans le catalogue ; elles sont appliquées dans le 402 prix.
Le catalogue ne contient aucune information sur les stocks. Si les adresses sont épuisées, cela n'est connu qu'après le paiement ; voir Obtenir la commande.