Katalog

Der Katalog listet alles auf, was Sie kaufen können: Produkte, Länder, Zeiträume, Stückpreise, die aktuellen Konditionen und die Protokollparameter. Es ist keine Autorisierung erforderlich.

Die Preise im Katalog dienen nur als Anhaltspunkt. Der verbindliche Preis ist ausschließlich der Betrag in der 402 Antwort auf Ihren konkreten Auftrag.

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

Abfrageparameter

Name	Typ	Beschreibung
Produkt	String	Optional. Geben Sie nur dieses Produkt zurück, zum Beispiel `?product=IPv4`. Unbekanntes oder noch nicht veröffentlichtes Produkt — `400`

Zwischenspeicherung

Der Katalog wird alle 5 Minuten neu erstellt. Die Antwort lautet Cache-Control: public, max-age=300 und ETag: "<catalog_version>"; senden If-None-Match mit diesem Wert, um 304 Not Modified. Mit ?product=P Der ETag lautet "<catalog_version>:P".

Antwort

Name	Typ	Beschreibung
generated_at	String	Als der Katalog erstellt wurde
catalog_version	Zeichenkette	Änderungen nur, wenn sich der Inhalt ändert
Währung	Objekt	`{asset, network, decimals}` des Zahlungsmittels
Begriffe	Objekt	`offer_version`, `offer_url`, `privacy_version`, `privacy_url`, `aup_summary`, `on_expiry`, `refund_policy`. Die Versionen gehen in `accept_terms` einer neuen Bestellung
intended_use	Objekt	`{required: true, allowed: [{value, label}]}` — zulässige Verwendungszwecke
Produkte	Array	Produktblöcke, siehe unten
product_guide	Objekt	Eine kurze Beschreibung jedes Produkts und `recommendation_by_use` — Für jeden Zweck empfohlene Produkte
Protokoll	Objekt	`x402_versions`, `schemes`, `networks`, `extensions`, `quote_ttl_seconds`, `max_timeout_seconds`, `poll`, `rate_limits`, und `sandbox_url` sofern verfügbar

Es werden nur Produkte veröffentlicht, die derzeit erhältlich sind. Ein Produkt, das im Katalog fehlt, kann nicht bestellt werden.

Produktblöcke

Name	Typ	Beschreibung
Produkt	String	`IPv4`, `ISP` oder `IPv6`
display_name, description	Zeichenkette	Für Menschen lesbarer Name und Beschreibung
Attribute	Objekt	`dedicated`, `rotating`, `ip_version`, `asn_type` (`datacenter` oder `isp`), `protocols`, `auth_methods`, `min_quantity`
geeignet_für	Array	Empfohlene Verwendungszwecke
Länder	Array	`[{country, periods: [{days, unit_price_usd, unit_price_atomic}]}]` — Preis für eine Adresse für den Zeitraum bei Mindestabnahme
Optionen	Array	Immer leer

Derselbe Block für IPv4_UPTIME und ISP_UPTIME, mit display_name endend auf 100% uptime und attributes.uptime: true, attributes.gateways: true, auth_methods: ["userpass"]. Es werden nur Länder und Zeiträume aufgeführt, in denen eine 100-prozentige Verfügbarkeit gewährleistet ist.

Name	Typ	Beschreibung
Produkt	String	`RESIDENT`
Attribute	Objekt	`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-Pakete, die Sie kaufen können
Verbindung	Objekt	Hosts, Ports, Protokolle und die Syntax für das Login-Suffix für Geo-Targeting und Sitzungen (ohne Anmeldedaten)
locations_url	String	Wo man Regionen, Städte und Internetdienstanbieter nachschlagen kann, sofern verfügbar

Name	Typ	Beschreibung
Produkt	Zeichenkette	`MOBILE`
Attribute	Objekt	Außerdem `max_quantity_per_line`, `shared_host: true`, `volume_discounts: false`
Optionen	Array	Beschreibungen der Zeilenoptionen: `operator` und `rotation_min` (erforderlich), `service_type` (Standard `dedicated`)
Länder	Array	`[{country, operators: [{operator, name, traffic, service_types: [{service_type, rotations: [{rotation_min, ip_change, periods: [{days, unit_price_usd, unit_price_atomic}]}]}]}]}]` — nur Kombinationen, die zum Verkauf stehen. `ip_change`: `timer` oder `link`

Name	Typ	Beschreibung
Produkt	Zeichenkette	`MIX` (IPv4-Adressen) oder `MIX_ISP` (ISP-Adressen)
Verbreitung	Zeichenkette	Wie Adressen auf die Länder eines Pakets aufgeteilt werden
Pakete	Array	`[{mix, name, group: {id, name}, countries: [{country, share_pct}], sizes, periods: [{days, totals_usd}]}]`. `totals_usd` folgt `sizes`; `null` bedeutet: kein Preis für diese Größe und diesen Zeitraum

Beispiel

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

Unbekanntes Produkt

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

Der Katalog wird direkt nach einem Neustart erstellt. Versuchen Sie es später erneut. Retry-After Sekunden.

Hinweise

Einzelpreise werden auf Basis der Mindestmenge eines Produkts berechnet. Mengenrabatte werden im Katalog nicht ausgewiesen; sie werden im 402 Preis.
Der Katalog enthält keine Bestandsangaben. Sollte ein Artikel ausverkauft sein, wird dies erst nach der Zahlung bekannt; siehe Auftrag annehmen.