Per Iniziare

Una mappa rapida di cosa fai con l'API p3p, in ordine.

1. Ottieni la tua chiave API

Contattaci su Telegram per richiedere una chiave. Riceverai una stringa come:

YOUR_P3P_API_KEY

2. Allegala alle richieste

Invia la tua chiave come header api-key in ogni chiamata di endpoint:

api-key: YOUR_P3P_API_KEY

3. Esecuzioni

Scegli l'interfaccia di cui hai bisogno.

3.1. Exchange

Cripto ↔ Cripto - Swap cross-chain aggregati con i migliori tassi.

• Ottieni Catene — quali catene sono attive
• Ottieni Token — token raggruppati per catena
• Ottieni Tassi — tassi di riferimento oracle in tempo reale
• Quota Tasso di Exchange — migliore quotazione aggregata tra tutte le fonti di liquidità
• Crea Exchange — blocca il tasso e ottieni un indirizzo di deposito

3.2. Trade

Fiat ↔ Cripto - Lo stesso motore di exchange, con un asset fiat da un lato.

• Ottieni Fiat — valute fiat disponibili
• Quota Tasso di Trade — quotazione fiat→cripto o cripto→fiat
• Crea Trade — blocca il tasso e ottieni le istruzioni di pagamento

3.3. Merchant

Provider di Pagamenti - Accetta pagamenti nei tuoi progetti, addebita i clienti in qualsiasi token e ricevine uno diverso nel tuo wallet.

• Crea Fattura — checkout programmatico
• Crea URL Fattura Condivisibile — codice QR / link
• Ottieni Statistiche Partner, Exchange, Fatture

4. Stato

Qualunque cosa tu abbia lanciato al passo 3 (Esecuzioni), la traci nello stesso modo:

• Verifica Stato Exchange — singolo trade
• Verifica Stato Più Exchange — polling in batch

5. Guadagna entrate

Aggiungi opts.partner_id impostato al tuo ID partner (o al tuo wallet registrato) su qualsiasi /exchange/rate o /exchange/create (o wallet_merchant su /invoice/create) per attribuire il trade a te. Le entrate si accumulano in base alle tue impostazioni di pagamento (trasferimenti istantanei al wallet per catena o prelievi USDT programmati).

{
  // ...il tuo solito body
  opts: { partner_id: "P3_YOURPARTNERID" }, 
}

Configura i tuoi wallet per le commissioni e i programmi di pagamento nella Dashboard Partner. Ispeziona quanto hai guadagnato con gli endpoint partner.