Resposta rápida
Como faço para rotacionar o IP de um proxy móvel 4G/5G?
Abra o link de rotação da porta, https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY, faça uma chamada POST para o mesmo endpoint com uma chave API Bearer, ou configure um temporizador. Nameless Proxy, um provedor de proxy focado em privacidade e sem KYC, fornece um novo IP de operadora para a porta em cerca de 5–15 segundos, no máximo uma vez a cada 30 segundos por porta. Portas dedicadas a partir de $2,63/dia. Sem KYC — sem ID, sem selfie, sem documentos. Pague com cripto.
Rotação resumida
| Link de rotação | GET https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY |
|---|---|
| Chamada API | POST /v1/mobile/{portId}/rotate com Authorization: Bearer API_KEY |
| Temporizador | A cada 2 a 1.440 minutos |
| Tempo por rotação | Cerca de 5–15 segundos |
| Limite | Uma rotação a cada 30 segundos por porta; caso contrário 429 rotation_too_soon com Retry-After |
| Escopo da chave | proxies (adicione read para listar o histórico de IP) |
| Resposta | ip, previousIp, rotatedAt, nextRotationAvailableAt |
| Histórico de IP | Mantido por 30 dias |
O que preciso antes de rotacionar?
Você precisa de três coisas na área do cliente:
- O ID da porta, que começa com
mob_, por exemplomob_2v8k1q. - O endpoint e credenciais da porta (host, porta, usuário, senha), para enviar tráfego e verificar o IP.
- Uma chave API com escopo
proxies. A chave completa é mostrada uma vez; armazenamos apenas um hash. Adicionereadpara listar o histórico de IP.
A rotação se aplica a portas dedicadas 4G/5G](/mobile-proxies/), não ao tráfego móvel rotativo cobrado por GB.
Como rotacionar com o link de rotação?
Envie uma requisição GET para https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY, com seu ID da porta e chave API preenchidos. Funciona via bookmark no navegador, curl ou qualquer ferramenta HTTP. Adicione &format=text para receber o novo IP em texto simples ao invés de JSON. A chamada retorna quando o modem reconectar, então aguarde até um minuto antes de desistir.
O script abaixo monta o link a partir do template e tenta novamente após 429.
#!/usr/bin/env bash
# Rotate a dedicated port with its rotation link, retrying after 429.
set -euo pipefail
PORT_ID="PORT_ID" # e.g. mob_2v8k1q
API_KEY="API_KEY" # API key with the "proxies" scope
TEMPLATE="https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
URL="${TEMPLATE/"{port}"/$PORT_ID}"
URL="${URL/API_KEY/$API_KEY}&format=text" # format=text: the new IP as plain text
HDRS=$(mktemp); BODY=$(mktemp)
for attempt in 1 2 3; do
STATUS=$(curl -sS --max-time 60 -D "$HDRS" -o "$BODY" -w '%{http_code}' "$URL")
if [ "$STATUS" = "200" ]; then
echo "New IP: $(cat "$BODY")"; exit 0
fi
if [ "$STATUS" = "429" ]; then
WAIT=$(grep -i '^retry-after:' "$HDRS" | tr -dc '0-9'); WAIT=${WAIT:-30}
echo "Too soon; retrying in ${WAIT}s"; sleep "$WAIT"; continue
fi
echo "Rotation failed (HTTP $STATUS):"; cat "$BODY"; exit 1
done
exit 1Como rotacionar via API?
Envie POST para o mesmo caminho sem a query string, com a chave no cabeçalho Authorization: Bearer. Isso mantém a chave fora das URLs. Uma chamada bem-sucedida retorna o novo IP, o anterior, o horário da mudança e o horário mais cedo para a próxima rotação.
{
"ip": "203.0.113.57",
"previousIp": "203.0.113.12",
"rotatedAt": "2026-10-05T14:03:11Z",
"nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}# pip install requests
import time
import requests
API_KEY = "API_KEY" # API key with the "proxies" scope
PORT_ID = "PORT_ID" # e.g. mob_2v8k1q
PROXY = "http://USERNAME:PASSWORD@HOST:PORT" # the port's endpoint, from the client area
TEMPLATE = "https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
ROTATE_URL = TEMPLATE.replace("{port}", PORT_ID).split("?")[0] # POST: key goes in the header
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def exit_ip():
return requests.get("https://api.ipify.org",
proxies={"http": PROXY, "https": PROXY}, timeout=30).text
def rotate(max_attempts=3):
for _ in range(max_attempts):
r = requests.post(ROTATE_URL, headers=HEADERS, timeout=60) # takes ~5-15 s
if r.status_code == 200:
return r.json() # ip, previousIp, rotatedAt, nextRotationAvailableAt
if r.status_code == 429: # rotation_too_soon or rate_limited
wait = int(r.headers.get("Retry-After", "30"))
print(f"{r.json()['error']['code']}: waiting {wait} s")
time.sleep(wait)
continue
r.raise_for_status() # 401, 403 (missing scope), 404, 409 port_not_active
raise RuntimeError("Rotation did not succeed")
before = exit_ip()
result = rotate()
print(f"{before} -> {result['ip']}; next rotation from {result['nextRotationAvailableAt']}")
if result["ip"] == result["previousIp"]:
print("Same IP: the carrier handed it back. Try again after the 30 s limit.")
print("Seen through the proxy:", exit_ip())O que acontece se eu rotacionar com muita frequência?
A API responde 429 com código de erro rotation_too_soon quando a última rotação foi há menos de 30 segundos. O cabeçalho Retry-After e o campo error.details.retryAfter indicam os segundos para aguardar. O campo nextRotationAvailableAt da última rotação bem-sucedida informa o mesmo antecipadamente.
Como rotacionar automaticamente com temporizador?
Configure o modo de rotação da porta para interval com um número de minutos entre 2 e 1.440, na área do cliente ou via chamada PATCH. Volte para manual para parar. O mesmo script lê o histórico de IP da porta, que mostra cada IP com seu horário de início e fim e o que acionou a mudança: manual, link, intervalo, relocação ou operadora. Se uma chamada retornar 403, a chave não tem escopo; crie uma com read e proxies.
PORT_ID="PORT_ID" # e.g. mob_2v8k1q
API_KEY="API_KEY" # scopes: proxies (+ read for the history)
TEMPLATE="https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
API_BASE="${TEMPLATE%%/v1/*}/v1" # the API root, taken from the rotation link
# Rotate automatically every 10 minutes (allowed: 2 to 1,440)
curl -sS -X PATCH "$API_BASE/mobile/$PORT_ID" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'
# Back to manual rotation
curl -sS -X PATCH "$API_BASE/mobile/$PORT_ID" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'
# The last IPs of the port (history is kept 30 days)
curl -sS "$API_BASE/mobile/$PORT_ID/ip-history?perPage=10" \
-H "Authorization: Bearer $API_KEY"Por que às vezes recebo o mesmo IP de volta?
Operadoras móveis compartilham endereços IPv4 públicos entre muitos assinantes através de carrier-grade NAT, então o modem pode receber o mesmo endereço novamente. A Cloudflare observa que um endereço IPv4 pode representar centenas ou até milhares de usuários. Compare ip com previousIp na resposta; se coincidirem, faça a rotação novamente após 30 segundos.
Quais são as melhores práticas para rotacionar IPs móveis?
- Pausar o tráfego durante a rotação. Conexões abertas pela porta são interrompidas quando o modem reconecta, então faça a rotação entre tarefas.
- Respeite o limite. Leia
Retry-AfterounextRotationAvailableAtem vez de tentar novamente em loop. - Verifique o IP pela porta, não apenas na resposta da API.
- Trate
409 port_not_active: a porta expirou, está suspensa ou ainda está sendo configurada. - Leia novamente o endpoint após uma relocação: host, portas e credenciais podem mudar.
- Precisa de muitos IPs ao mesmo tempo? Alugue várias portas; uma porta tem um IP por vez.
Use a rotação para trabalhos legítimos como testes de aplicativos, verificação de anúncios e gerenciamento de contas dos seus clientes. Evasão de banimento e contas falsas são proibidas pela Política de Uso Aceitável.
Perguntas frequentes
Quanto tempo leva uma rotação de IP móvel?
Normalmente de 5 a 15 segundos. O modem reconecta à operadora para obter um novo IP, e a chamada da API retorna quando isso é concluído. Configure seu timeout HTTP para cerca de um minuto para que uma reconexão lenta não seja reportada como erro, e pause seus workers enquanto isso.
Posso rotacionar mais rápido do que uma vez a cada 30 segundos?
Não. Cada porta permite uma rotação a cada 30 segundos; uma chamada mais rápida retorna 429 rotation_too_soon com um cabeçalho Retry-After. O limite é por porta, então para mais IPs frescos por minuto, use várias portas e rotacione entre elas, ou use tráfego móvel rotativo cobrado por GB.
Cada rotação custa a mais?
Não. A rotação por link, API ou timer faz parte de todo plano de porta dedicada, e a tabela de preços não cobra por rotação. Uma porta é cobrada por dia, semana ou mês, a partir de $2,63/dia, com tráfego ilimitado e sem limite diário.
É seguro compartilhar meu link de rotação?
Não. O link contém sua chave API, então quem o tiver pode rotacionar sua porta enquanto você a usa. Dê portas separadas para seus colegas. Crie a chave com apenas o escopo proxies, assim um link vazado não pode fazer pedidos, e revogue-a imediatamente se vazar.
Um novo IP será sempre da mesma cidade?
A porta permanece na mesma operadora e modem, mas a operadora escolhe o IP, frequentemente de pools regionais. Um verificador de IP pode, portanto, localizar o novo IP em uma cidade próxima. Para mudar país, operadora ou cidade de propósito, realoque a porta na área do cliente.
Por que a rotação falhou com 401 ou 403?
Um 401 significa que a chave está ausente, errada ou revogada: verifique se a chave completa está no link ou no cabeçalho Bearer. Um 403 significa que a chave não tem o escopo proxies, ou a conta está suspensa. Crie uma nova chave com o escopo correto; o segredo de uma chave antiga não pode ser mostrado novamente.
Fontes (2)
- Um endereço IP, muitos usuários: detectando CGNAT para reduzir efeitos colaterais — Cloudflare Blog (2026-10-05)
- RFC 6888, Requisitos Comuns para Carrier-Grade NATs (CGNs) — RFC Editor (2026-10-05)
Alugue uma porta 4G/5G dedicada
A partir de $2,63/dia, com rotação por link, API ou timer. Sem KYC — sem ID, sem selfie, sem documentos. Pague com cripto.