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 ​