Saltar al contenido principal
Windscribe

La API de VPNpara tusLa API de VPNpara tus agentes.

Dales a tus agentes de IA su propia VPN WireGuard. La compran con USDC en una sola llamada a la API, bloquean dominios maliciosos con filtrado DNS y nunca necesitan una cuenta.

Agentes: empiecen en llms.txt. URL base https://api.windscribe.com/vpn

Casos de uso

Lo que hacen los agentes con su propia VPN

Los agentes actúan en la web abierta por ti. Estas son las tareas en las que importa una conexión privada y controlable.

  • Privacidad

    Navega en privado

    Los sitios ven una IP de Windscribe, nunca la red de tu casa u oficina.

  • Pruebas geográficas

    Mira otro país

    Consulta precios locales y resultados de búsqueda tal como los ve la gente de allí.

  • Seguridad

    Protege cualquier red

    El Wi-Fi de hotel, los robots y los dispositivos edge obtienen un túnel WireGuard cifrado.

  • Plataformas

    Un túnel por cliente

    Una clave y un periodo por espacio de trabajo o tarea. Sin cuentas que gestionar.

Filtrado DNS con ROBERT

Limita lo que tu agente puede alcanzar

Bloquea dominios de malware y phishing para que nadie pueda dirigir a un agente hacia ellos, o elimina anuncios y rastreadores para reducir el ruido y el consumo de datos. Una sola solicitud a la API cambia las listas de una clave, y el resolvedor DNS del túnel las aplica.

Listas de filtros
Consultas DNS3 de 9 bloqueadas
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleAnuncios + rastreadoresBLOQUEADO
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleMalwareBLOQUEADO
  8. ads.network.exampleAnuncios + rastreadoresBLOQUEADO
  9. cdn.images.example

PUT /vpn/wireguard/settings{"robert": ["malware","ads"]}→ wireguard.dns = 10.255.255.3

Barreras de seguridad para agentes autónomos

Un agente que sigue un enlace malicioso o una instrucción inyectada sigue sin poder resolver dominios conocidos de malware, phishing o botnets.

Menos datos, menos ruido

Bloquear anuncios y rastreadores aligera las páginas, así que los agentes gastan menos tokens y menos ancho de banda en contenido inútil.

Configurado por clave, mediante la API

Las claves nuevas empiezan con el bloqueo de malware activado. Cambia las listas cuando quieras con:

PUT /vpn/wireguard/settings

Privacidad y control

Nada que registrar, nada que filtrar

Identidad

Cero cuentas

La API nunca pregunta quién eres. Tu agente genera un par de claves WireGuard, y la clave pública es toda la identidad. La clave privada nunca sale de la máquina, y cada solicitud que gestiona la conexión se firma con ella, así que mantenla tan privada como la propia conexión.

correocontraseñatarjetasesiónwg_pubkey ✓
Pagos x402

Tu agente paga por su cuenta

USDC en Base, liquidado por solicitud mediante el estándar abierto x402. Sin página de pago, sin tarjeta guardada, y reintentar un pago nunca cobra dos veces.

WireGuard estándar

Funciona con cualquier cliente WireGuard

Una solicitud firmada con tu clave devuelve la dirección, el resolvedor DNS y la clave precompartida, así que crear una configuración de wg-quick requiere una sola plantilla.

Control total por API

Renueva, transfiere o cancela el acceso

Compra más tiempo, transfiere el acceso a una clave nueva o revócalo al instante, cada cosa con una sola solicitud firmada.

Cómo compra un agente una VPN con x402

De cero a un túnel en cuatro pasos

HTTP simple y el estándar de pago abierto x402. Cualquier cliente x402 v2 puede pagar sin código personalizado.

  1. 402

    Pide un periodo

    Envía una clave pública WireGuard y un número de meses. La respuesta es el precio exacto, la red y el beneficiario.

    POST /vpn/wireguard

  2. x402

    Paga el presupuesto

    Firma una autorización de transferencia de USDC y vuelve a enviar la misma solicitud con ella.

    PAYMENT-SIGNATURE: …

  3. 201

    Crea la configuración

    Una solicitud firmada devuelve la dirección, el resolvedor DNS y la clave precompartida. Elige una salida de la lista de ubicaciones.

    GET /vpn/wireguard/locations

  4. WG

    Conéctate

    Levanta el túnel con cualquier cliente WireGuard y configura los filtros que necesite la tarea.

    wg-quick up ./windscribe.conf

Precios

Un solo precio, pagado en USDC

Pagado en USDC en Base con x402. Sin suscripción ni renovación automática: vuelve a comprar con la misma clave para añadir tiempo, hasta 12 meses por adelantado. Los pagos son definitivos.

Mensual$0
AnualAhorra $39$0

Documentación para desarrolladores y agentes

Todo lo que un agente necesita para empezar

La especificación OpenAPI describe cada endpoint. llms.txt es la versión corta para agentes.

Dale esto a tu agente
Lee https://windscribe.com/vpn-api/llms.txt.
Crea un par de claves WireGuard en esta máquina, compra un mes de acceso a la VPN de Windscribe para ella con x402, activa el bloqueo de malware y anuncios, y luego escribe una configuración de wg-quick para la ubicación más cercana. Mantén la clave privada en esta máquina.
De un vistazo
URL base
https://api.windscribe.com/vpn
Descubrimiento
GET /vpn
Pago
x402 v2, esquema exact, USDC en Base
Autenticación
Solicitudes firmadas con la clave WireGuard (wg-xeddsa-v1)
Explora la API9 endpoints, campos de solicitud y respuesta, código en cURL, Python y JavaScriptAbrir
POST/vpn/wireguard

Buy time for a WireGuard key

Creates a new entitlement, extends an active or expired one from max(now, expires), or reactivates a revoked one with a fresh PSK and a term starting now. Send without PAYMENT-SIGNATURE for an x402 quote, then retry the identical body with PAYMENT-SIGNATURE. A wg-xeddsa-v1 signature by the key in the body is optional; when sent it must verify, and a signed quote also checks that the key can buy the term now. The response carries `psk` only when the request is signed by the key: anyone can pay for any key. Retrying the same PAYMENT-SIGNATURE never pays twice.

Firma opcionalx402 · USDC en BasebuyWireGuardTime

Encabezados

Encabezado
Obligatorio
Descripción
PAYMENT-SIGNATURE
no
Base64 x402 v2 PaymentPayload. Omit to receive a quote. Its authorization's validBefore must be at most maxTimeoutSeconds, plus 30 seconds of clock skew, from now.
X-Windscribe-WireGuard-Key
no
Part of the optional purchase signature.
Content-Digest
no
Part of the optional purchase signature.
Signature-Input
no
Part of the optional purchase signature.
Signature
no
Part of the optional purchase signature.

Cuerpo de la solicitud · application/json

Campo
Tipo
Descripción
wg_pubkeyobligatorio
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
monthsobligatorio
integer
123456712

Respuestas

Payment settled and time bought

Campo
Tipo
Descripción
pubkeyobligatorio
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
statusobligatorio
string
activeexpiredrevoked
expiresobligatorio
integer
Unix seconds; access ends exactly then.
ipv4obligatorio
string
ipv6obligatorio
string
robertobligatorio
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguardobligatorio
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addressobligatorio
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6obligatorio
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnsobligatorio
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipsobligatorio
"0.0.0.0/0, ::/0"
wireguard.endpoint_portobligatorio
443
purchasable_termsobligatorio
integer[]
Terms that a purchase would accept now without exceeding the 12-month cap.
123456712
psk
string
WireGuard preshared key for the [Peer] section. Only when the request is signed by the key; otherwise read it with a signed GET /vpn/wireguard.
successobligatorio
1
payment_idobligatorio
string | null
Null when rotate moved an active entitlement.
settlement_referenceobligatorio
string | null
Base transaction hash of the settlement.

Los campos mostrados están dentro de data.

Solicitud
# 1. Quote. The x402 PaymentRequired object is in the PAYMENT-REQUIRED header (base64).
curl -si https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'

# 2. Pay with any x402 v2 client, or build the payload as in the Python tab,
#    then send the same request with the payment.
curl -s https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -H "PAYMENT-SIGNATURE: $PAYMENT" \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'
Respuesta de ejemplo · 201
{
  "data": {
    "pubkey": "j0DFrbaPJWJK5bIU6nZ6bslNgp09e14a0bpvPiE4KF8=",
    "status": "active",
    "expires": 1797207705,
    "ipv4": "100.88.12.34",
    "ipv6": "fd54:4::5c0c:2a2",
    "robert": [
      "malware"
    ],
    "wireguard": {
      "address": "100.88.12.34/32",
      "address_v6": "fd54:4::5c0c:2a2/128",
      "dns": "10.255.255.2",
      "allowed_ips": "0.0.0.0/0, ::/0",
      "endpoint_port": 443
    },
    "purchasable_terms": [
      1,
      2,
      3,
      4,
      5,
      6,
      7
    ],
    "psk": "EXAMPLEexampleEXAMPLEexampleEXAMPLEexample0=",
    "success": 1,
    "payment_id": "6c1f0e9a2b7d4c3e8f5a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e",
    "settlement_reference": "0xeb0c71793e4e18a80c8123e34c8f908404f4ee107d3c8dfea4c742ad73e01ccf"
  }
}
All Your Devices
Stars

Dales a tus agentes su propia VPN.

Pide presupuesto con POST /vpn/wireguard, paga con x402 y conéctate con WireGuard.

All Your Devices

Preguntas

Antes de comprar

¿Qué es la API de VPN de Windscribe?

Una API HTTP que vende acceso a la VPN WireGuard de Windscribe directamente a una clave pública WireGuard. Los agentes de IA, los scripts y los dispositivos pueden comprar, usar y gestionar una conexión sin una cuenta de Windscribe.

¿Puede un agente de IA comprar una VPN por su cuenta?

Sí. El agente envía su clave pública WireGuard y un periodo, recibe un presupuesto HTTP 402, lo paga en USDC con x402 y obtiene los valores para una configuración de WireGuard. Ninguna persona tiene que registrarse ni confirmar nada.

¿Necesito una cuenta de Windscribe?

No. La API nunca pide correo, contraseña ni sesión. Tu clave pública WireGuard identifica la compra, y las solicitudes que la gestionan se firman con la clave privada correspondiente.

¿Cómo pago?

Con USDC en Base, mediante x402 v2. La primera solicitud devuelve el importe exacto y la dirección de recepción; tu cliente firma una autorización de transferencia de USDC y vuelve a enviar la solicitud.

¿Es una suscripción?

No. Cada pago compra un periodo fijo de 1 a 7 o 12 meses. Vuelve a comprar con la misma clave para añadir tiempo, hasta 12 meses por adelantado.

¿Puedo obtener un reembolso?

No. Los pagos son definitivos. Revocar una clave termina el acceso al instante y pierdes el tiempo restante; comprar tiempo de nuevo reactiva la clave.

¿Puedo controlar a qué dominios accede mi agente?

Sí. Cada clave tiene listas de filtros DNS de ROBERT: Malware (incluidos servidores de phishing y botnets), Anuncios + rastreadores, Redes sociales, Porno, Apuestas, Ciberanzuelos, Cripto y Otras VPN. Las claves nuevas empiezan con Malware activado, y PUT /vpn/wireguard/settings cambia las listas en cualquier momento. No se admiten reglas de dominio personalizadas.

¿Qué protocolo VPN usa?

WireGuard. La API devuelve la dirección de la interfaz, el resolvedor DNS, la clave precompartida y el puerto del endpoint, así que cualquier cliente WireGuard, incluido wg-quick, puede conectarse.

¿Qué almacena Windscribe?

La clave pública, una clave precompartida generada, la fecha de caducidad, tus filtros de ROBERT y, para cada pago, los detalles del producto, su estado y el hash de la transacción de liquidación. Windscribe no almacena la dirección de tu billetera, pero la liquidación es pública en Base y muestra la billetera que pagó.

¿Y si mi clave WireGuard ya está en uso?

Una clave que pertenece a una cuenta de Windscribe o a un socio se rechaza con wireguard_key_exists antes de que se mueva dinero. Genera una clave nueva y vuelve a intentarlo.

¿Qué servidores puedo usar?

Las ubicaciones WireGuard premium que devuelve GET /vpn/wireguard/locations mientras tu acceso esté activo. Los servidores de IP estática no están incluidos.