Catálogo

O catálogo lista tudo o que você pode comprar: produtos, países, períodos, preços unitários, as condições atuais e os parâmetros do protocolo. Não é necessária nenhuma autorização.

Os preços no catálogo são meramente informativos. O preço definitivo é apenas o valor indicado no 402 Resposta à sua solicitação específica.

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

Parâmetros de consulta

Nome	Tipo	Descrição
produto	String	Opcional. Entregue apenas este produto, por exemplo `?product=IPv4`. Produto desconhecido ou não publicado — `400`

Armazenamento em cache

O catálogo é atualizado a cada 5 minutos. A resposta contém Cache-Control: public, max-age=300 e ETag: "<catalog_version>"; enviar If-None-Match com este valor para obter 304 Not Modified. Com ?product=P o ETag é "<catalog_version>:P".

Resposta

Nome	Tipo	Descrição
generated_at	String	Quando o catálogo foi criado
catalog_version	String	Altere apenas quando o conteúdo for alterado
moeda	Objeto	`{asset, network, decimals}` do ativo de pagamento
termos	Objeto	`offer_version`, `offer_url`, `privacy_version`, `privacy_url`, `aup_summary`, `on_expiry`, `refund_policy`. As versões estão em `accept_terms` de uma nova ordem
uso_previsto	Objeto	`{required: true, allowed: [{value, label}]}` — finalidades de uso permitidas
produtos	Matriz	Blocos de produto, veja abaixo
guia_do_produto	Objeto	Uma breve descrição de cada produto e `recommendation_by_use` — produtos recomendados para cada finalidade
protocolo	Objeto	`x402_versions`, `schemes`, `networks`, `extensions`, `quote_ttl_seconds`, `max_timeout_seconds`, `poll`, `rate_limits`, e `sandbox_url` quando disponível

Somente produtos que possam ser comprados no momento são publicados. Um produto que não conste no catálogo não pode ser encomendado.

Blocos de produto

Nome	Tipo	Descrição
produto	String	`IPv4`, `ISP` ou `IPv6`
display_name, description	String	Nome e descrição legíveis para humanos
atributos	Objeto	`dedicated`, `rotating`, `ip_version`, `asn_type` (`datacenter` ou `isp`), `protocols`, `auth_methods`, `min_quantity`
adequado_para	Matriz	Finalidades recomendadas
países	Matriz	`[{country, periods: [{days, unit_price_usd, unit_price_atomic}]}]` — preço de um endereço para o período, na quantidade mínima
opções	Matriz	Sempre vazio

O mesmo bloco para IPv4_UPTIME e ISP_UPTIME, com display_name terminando em 100% uptime e attributes.uptime: true, attributes.gateways: true, auth_methods: ["userpass"]. Apenas os países e períodos em que o tempo de atividade de 100% está disponível são listados.

Nome	Tipo	Descrição
produto	String	`RESIDENT`
atributos	Objeto	`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	Matriz	`[{gb, period_days, price_usd, price_atomic}]` — pacotes de tráfego que você pode comprar
conexão	Objeto	Hosts, portas, protocolos e a sintaxe do sufixo de login para segmentação geográfica e sessões (sem credenciais)
locations_url	String	Onde consultar regiões, cidades e provedores de internet, quando disponíveis

Nome	Tipo	Descrição
produto	String	`MOBILE`
atributos	Objeto	Além disso `max_quantity_per_line`, `shared_host: true`, `volume_discounts: false`
opções	Matriz	Descrições das opções de linha: `operator` e `rotation_min` (obrigatório), `service_type` (padrão `dedicated`)
países	Matriz	`[{country, operators: [{operator, name, traffic, service_types: [{service_type, rotations: [{rotation_min, ip_change, periods: [{days, unit_price_usd, unit_price_atomic}]}]}]}]}]` — apenas combinações que estejam à venda. `ip_change`: `timer` ou `link`

Nome	Tipo	Descrição
produto	String	`MIX` (endereços IPv4) ou `MIX_ISP` (Endereços de ISP)
distribuição	String	Como os endereços são divididos entre os países de um pacote
pacotes	Matriz	`[{mix, name, group: {id, name}, countries: [{country, share_pct}], sizes, periods: [{days, totals_usd}]}]`. `totals_usd` segue `sizes`; `null` significa que não há preço para este tamanho e período

Exemplo

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

Produto desconhecido

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

O catálogo está sendo criado logo após uma reinicialização. Tente novamente depois de Retry-After segundos.

Notas

Os preços unitários são calculados com base na quantidade mínima de um produto. Os descontos por volume não são exibidos no catálogo; eles são aplicados no 402 preço.
O catálogo não contém informações sobre estoque. Se os endereços se esgotarem, isso só será constatado após o pagamento; consulte Obter pedido.