Die Agentenschnittstelle ist ein programmatisches Spiegelbild unseres menschlichen Checkouts: Ein Agent liest eine Discovery-Datei, erstellt ein Konto, um ein Bearer-Token zu erhalten, fordert eine Guthabenaufladung an, empfängt ein HTTP 402 mit einem accepts-Block, signiert eine USDC-Zahlung auf Base, sendet die Anfrage mit einem X-PAYMENT-Header erneut und gibt dann das aufgeladene Guthaben für eines unserer 18 Länder und 43 Anbieter aus. Keine Karte, kein PayPal, kein menschlicher Freigabeschritt.
Wofür ist die x402- + MCP-Schnittstelle gedacht?
x402 erweckt den ruhenden Statuscode HTTP 402 Payment Required als echten Zahlungs-Handshake wieder zum Leben: Eine nicht authentifizierte oder nicht aufgeladene Anfrage gibt 402 zusammen mit einem strukturierten accepts-Block zurück, der genau beschreibt, wie zu zahlen ist; der Agent zahlt und sendet dieselbe Anfrage mit Nachweis erneut. Proxy4G implementiert dies für die eine Aktion, die Geld erfordert – das Aufladen eines Wallet-Guthabens –, sodass ein autonomer Agent 4G-Mobile-Proxys von Anfang bis Ende kaufen kann.
Dies ist dasselbe Guthaben, das in unserem Krypto-Checkout beschrieben wird: Menschen laden mit Bitcoin, Ethereum, Solana oder USDT auf, während Agenten mit USDC auf Base über x402 aufladen. Nach dem Aufladen kauft das Guthaben über dieselbe Bestelllogik dedizierte oder SOCKS5-Tarife. Wenn Sie autonome Infrastruktur aufbauen, siehe den Anwendungsfall KI-Agenten und Automatisierung für Laufzeitmuster.
Die Agentenschnittstelle auf einen Blick
Wie entdeckt ein Agent die API?
Vor einer Transaktion sollte ein Agent die maschinenlesbaren Deskriptoren abrufen, damit er den Ablauf planen kann, ohne HTML zu scrapen. Drei Dateien werden im Site-Root bereitgestellt:
- /.well-known/agent.json – die Agent-Karte: Fähigkeiten, die
/agent-api.php-Basis und das Zahlungsschema (x402,exact, USDC auf Base). - /openapi.json – die vollständige OpenAPI-Definition jeder Aktion (
account,topup, Bestell-Endpunkte) mit Request-/Response-Strukturen. - /llms.txt – eine Klartext-Karte der Site für Sprachmodell-Crawler, mit einer begleitenden /pricing.md für die Preistabelle pro Land.
Die Discovery erfolgt schreibgeschützt und ohne Authentifizierung, sodass ein Agent entscheiden kann, ob und was er kauft, bevor er überhaupt ein Konto erstellt oder Geld bewegt.
Der Kaufablauf: konfigurieren → Angebot → zahlen → bereitstellen
- 1
Konfigurieren
Der Agent liest agent.json und pricing.md und wählt dann einen Tarif aus 18 Ländern / 43 Anbietern – z. B. einen dedizierten US-T-Mobile-5G-Port oder eine geteilte France-Free-Mobile-IP, die alle 5 Minuten rotiert.
- 2
Konto
POST /agent-api.php?action=account erstellt beim ersten Aufruf ein No-KYC-Konto und gibt ein Bearer-Token zurück. Es sind keine Verifizierung von Name, Adresse, Telefon oder E-Mail erforderlich.
- 3
Angebot
POST /agent-api.php?action=topup mit dem Header X-Payment-Mode: x402 und ohne Zahlungsnachweis gibt HTTP 402 plus einen accepts-Block zurück (Schema exact, Asset USDC, Netzwerk Base, Betrag, payTo-Adresse, Nonce/Gültigkeit).
- 4
Zahlen
Der Agent signiert eine EIP-3009 transferWithAuthorization für den angebotenen USDC-Betrag an die payTo-Adresse auf Base und erzeugt damit eine signierte Autorisierungs-Payload.
- 5
Abwickeln
Senden Sie dieselbe topup-Anfrage erneut, diesmal mit dem X-PAYMENT-Header, der die signierte Autorisierung trägt. Nach erfolgreicher Verifizierung wird das Guthaben gutgeschrieben und die Antwort gibt 200 zurück.
- 6
Bereitstellen
Das aufgeladene Guthaben kauft den gewählten Tarif. Die Zugangsdaten (HOST, PORT, Benutzername, Passwort) werden innerhalb von Minuten per E-Mail zugesandt, und der HTTP/HTTPS/SOCKS5-Zugang ist mit einer Carrier-IP mit 100 % Trust-Score live.
Schritt 1 – ein Konto erstellen, ein Bearer-Token erhalten
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=account' \
-H 'Content-Type: application/json'
# 200 OK
# {
# "account_id": "acct_...",
# "token": "BEARER_TOKEN",
# "balance_usdc": "0.00"
# }Schritt 2 – eine Aufladung anfordern, das 402-Angebot erhalten
curl -s -i -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
-H 'Authorization: Bearer BEARER_TOKEN' \
-H 'X-Payment-Mode: x402' \
-H 'Content-Type: application/json' \
-d '{"amount_usd": 27}'
# HTTP/1.1 402 Payment Required
# {
# "x402Version": 1,
# "accepts": [{
# "scheme": "exact",
# "network": "base",
# "asset": "USDC",
# "maxAmountRequired": "27000000",
# "payTo": "0xYOUR_PAYTO_ADDRESS",
# "resource": "/agent-api.php?action=topup",
# "nonce": "0x...",
# "validUntil": 1748505600
# }]
# }Schritt 3 – EIP-3009 signieren und mit X-PAYMENT erneut senden
# Sign an EIP-3009 transferWithAuthorization for the quoted USDC
# amount to payTo on Base, then base64 the payload into X-PAYMENT.
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
-H 'Authorization: Bearer BEARER_TOKEN' \
-H 'X-Payment-Mode: x402' \
-H 'X-PAYMENT: <base64 signed authorization>' \
-H 'Content-Type: application/json' \
-d '{"amount_usd": 27}'
# 200 OK -> balance credited; spend it on any plan.
# Verify a provisioned proxy:
# curl -x http://USER:PASS@HOST:PORT https://api.ipify.orgWas der Agentenablauf vom menschlichen übernimmt
- No-KYC: kein amtlicher Ausweis, kein Name oder keine Adresse, kein Telefon, keine E-Mail-Verifizierung – das Konto wird beim ersten Aufruf automatisch erstellt
- Echte Carrier-IPs auf physischen SIM-Karten in 18 Ländern und über 43 Anbieter, 100 % Trust-Score
- Gleiche Tariflogik: dediziert (Rotation auf Abruf oder automatisch alle 1–60 Min.) oder geteilt (automatische Rotation alle 5 Min.)
- Alle drei Protokolle: HTTP, HTTPS und SOCKS5, mit Authentifizierung per Benutzername/Passwort oder IP-Whitelist
- Wir protokollieren keinen Zielverkehr – agentenbasierte Käufe bringen keine zusätzliche Telemetrie mit sich
Mit der Agentenschnittstelle bauen
KI-Agenten & Automatisierung
Laufzeitmuster für autonome Agenten, die Mobile-Proxys kaufen und rotieren.
Proxys mit Krypto kaufen
Die menschliche Seite desselben Guthabens: Aufladungen mit BTC, ETH, SOL und USDT.
Preise pro Land
Dediziert ab $27/mo, geteilt ab $10.80/mo – vollständige Tabelle, maschinenlesbar unter /pricing.md.
Häufige Fragen
x402 ist ein Zahlungsprotokoll, das auf dem Statuscode HTTP 402 Payment Required aufbaut. Eine Anfrage, die Geld erfordert, gibt 402 mit einem strukturierten accepts-Block zurück, der beschreibt, wie zu zahlen ist; der Client zahlt und sendet die Anfrage mit Nachweis erneut. Proxy4G verwendet es, damit autonome Agenten ein Guthaben mit USDC auf Base aufladen und Mobile-Proxys ohne menschlichen Checkout-Schritt kaufen können.
Das Schema ist exact, das Asset ist USDC, und die Abwicklung erfolgt im Base-Netzwerk. Der Agent signiert eine EIP-3009-transferWithAuthorization für den angebotenen Betrag an die payTo-Adresse, die in der 402-Antwort zurückgegeben wird, und sendet die Anfrage dann mit dieser signierten Autorisierung im X-PAYMENT-Header erneut.
Nein. Der Agentenablauf übernimmt unser No-KYC-Modell: kein amtlicher Ausweis, kein Name oder keine Adresse, kein Telefon und keine E-Mail-Verifizierung. Das Konto wird beim ersten action=account-Aufruf automatisch erstellt, und wir protokollieren keinen Zielverkehr.
Rufen Sie die im Site-Root bereitgestellten Deskriptoren ab: /.well-known/agent.json für die Agent-Karte und das Zahlungsschema, /openapi.json für die vollständigen Aktionsschemata sowie /llms.txt und /pricing.md für die Site-Karte und Preistabelle. Die gesamte Discovery ist schreibgeschützt und ohne Authentifizierung.
Dasselbe, was ein menschlicher Käufer erhält: Proxy-Zugangsdaten – Host, Port, Benutzername und Passwort – innerhalb von Minuten nach der Bestellung per E-Mail. Der Proxy unterstützt HTTP, HTTPS und SOCKS5, mit Authentifizierung per Benutzername/Passwort oder IP-Whitelist, auf einer echten Carrier-IP aus einem von 18 Ländern und 43 Anbietern.
Ja. Die Aufladung schreibt ein Wallet-Guthaben gut, nicht eine einzelne Bestellung. Sobald es mit USDC auf Base aufgeladen ist, kann ein Agent mehrere Bestellungen gegen dieses Guthaben aufgeben – zum Beispiel mehrere dedizierte Ports in verschiedenen Ländern – und es jederzeit, wenn das Guthaben zur Neige geht, mit einem weiteren x402-Zyklus erneut aufladen.