Panoramica

L’API x402 consente agli agenti IA e agli script di acquistare e gestire proxy di venditori proxy senza un account o una chiave API. Ogni richiesta a pagamento viene regolata in USDC sulla rete Base tramite il protocollo di pagamento aperto x402 (versione 2): il portafoglio che effettua il pagamento è quello dell’acquirente.

L’API x402 è un prodotto distinto dall’API Proxy-seller. Gli ordini acquistati qui vengono gestiti esclusivamente tramite l’API x402, utilizzando il token di accesso dell’ordine.

Se non hai trovato la risposta alla tua domanda, contattaci direttamente: [email protected]

Come funziona

Richiedi un preventivo
Invia l’ordine senza pagamento e ricevi 402 Payment Required con l’importo esatto, l’indirizzo del destinatario e un preventivo valido per 15 minuti.
Retribuzione
Firmare un'autorizzazione al trasferimento USDC EIP-3009 con il proprio portafoglio e ripetere la stessa richiesta con il PAYMENT-SIGNATURE intestazione. Si ottiene 202 Accepted, l’ID dell’ordine e un token di accesso.
Ottenere i proxy
Interrogare l’ordine con il token di accesso. Quando il pagamento viene confermato sulla rete e vengono emessi i proxy, l’ordine diventa active e contiene i dettagli di connessione.
Non si invia mai una transazione personalmente: l’autorizzazione firmata viene inviata alla rete per conto dell’utente e non è necessario alcun ETH per il gas. I fondi vengono prelevati una sola volta ed esclusivamente per l’importo esatto del preventivo.

Inizia

Requisiti

Un portafoglio con USDC su Base. Il titolare dell’indirizzo indicato per il pagamento è il proprietario dell’ordine.
Un client x402. Qualsiasi client HTTP che supporti x402 versione 2 con il exact scheme ed EIP-3009, oppure il proprio codice di firma (vedere Intestazioni di pagamento).
I termini attuali. Ogni ordine conferma le versioni dei termini di servizio e dell’informativa sulla privacy pubblicate nel catalogo.

URL di base

https://proxy-seller.com/api/x402/v1

Rete e risorse

Rete	Risorsa	Decimali
Base (`eip155:8453`)	USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`	6

Prendere sempre la rete, la risorsa, l’importo e il destinatario dal 402 risposta piuttosto che da questa pagina.

Descrizioni leggibili da un sistema informatico

GET /catalog — prodotti, paesi, periodi, prezzi, termini e parametri di protocollo (Catalogo).
GET /openapi.json — Contratto OpenAPI 3.1 dell’intera API, generato dal servizio stesso.