Skip to content

Introduzione

L'API p3p è un'interfaccia HTTP/JSON pubblica per l'exchange cross-chain p3p. Ti permette di:

  • Recuperare catene, token e tassi di mercato in tempo reale supportati
  • Quotare ed eseguire swap attraverso più fonti di liquidità aggregate
  • Accettare pagamenti come merchant tramite fatture, con fondi regolati direttamente al tuo wallet

p3p è non custodial: l'API non detiene mai i fondi dell'utente oltre i pochi secondi necessari per instradare uno swap, e non devi mai condividere chiavi private o eseguire KYC.

URL base

https://api.p3p.xyz

Modello di autenticazione

p3p ha due tipi distinti di utenti con requisiti di autenticazione differenti.

Sviluppatori

Gli sviluppatori che costruiscono applicazioni che eseguono swap in modo programmatico (recuperare catene, token, tassi, creare exchange) devono includere un header api-key valido in ogni richiesta.

http
api-key: your_api_key_here
Caso d'usoCosa ti serve
Recuperare catene, token, tassiHeader api-key
Quotare uno swapHeader api-key
Eseguire uno swapHeader api-key
Guadagnare revenue share sugli swapHeader api-key + opts.partner_id impostato al tuo wallet

Per ottenere una chiave API, contattaci su Telegram.

Merchant

I merchant accettano pagamenti in cripto tramite fatture. Nessuna chiave API richiesta — il tuo indirizzo wallet è la tua identità.

Caso d'usoCosa ti serve
Creare una fatturaIl tuo indirizzo wallet come wallet_merchant nel body
Visualizzare fatture / guadagniIl tuo indirizzo wallet nell'URL degli endpoint partner

Nessuna registrazione. Nessun token. Usa solo il tuo wallet. Vedi la guida Merchant.

Formato della risposta

Ogni endpoint restituisce JSON.

Successo:

json
{ "id": "ex_...", "status": "waiting", "...": "..." }

Errore:

json
{ "error": "wallet_to_invalid", "message": "wallet_to has invalid address: ..." }

Limiti di velocità

Se ricevi HTTP 429, rallenta o contattaci per aumentare il limite per il tuo progetto.

Dove andare dopo