API dei Trade

Introduzione

I Trade sono il lato fiat del motore di exchange. Stessi endpoint, stesso flusso — solo con una valuta fiat da un lato (incasso o uscita in contanti) invece di due asset cripto. Usalo per permettere agli utenti di acquistare cripto con USD/EUR/AED o incassare cripto su un conto bancario.

Tutti gli endpoint sottostanti richiedono un header api-key di sviluppatore. Contattaci per ottenerne uno.

api-key: YOUR_P3P_API_KEY

Come funziona il fiat

Un trade è semplicemente un exchange dove un lato è un asset fiat invece di un token di catena. Imposta asset_from (o asset_to) su una chiave fiat come "usd", "eur", "aed" — e salta i corrispondenti campi chain_* / token_* su quel lato. Il tipo di richiesta passa automaticamente a "cash".

Endpoint

1. Ottieni Fiat2. Ottieni Tassi3. Quota Tasso di Trade4. Crea Trade

---

1. Ottieni Fiat

GET /fiats api-key richiesta

Restituisce ogni valuta fiat attualmente supportata.

curl https://api.p3p.xyz/fiats \
  -H "api-key: YOUR_P3P_API_KEY"

{
  "usd": { "key": "usd", "name": "US Dollar",         "enabled": true },
  "eur": { "key": "eur", "name": "Euro",              "enabled": true },
  "aed": { "key": "aed", "name": "UAE Dirham",        "enabled": true }
}

---

2. Ottieni Tassi

GET /rates api-key richiesta

Stesso endpoint /rates come per Exchange — restituisce i tassi di riferimento sia per asset cripto che fiat.

curl https://api.p3p.xyz/rates \
  -H "api-key: YOUR_P3P_API_KEY"

---

3. Quota Tasso di Trade

POST /exchange/rate api-key richiesta

Stesso endpoint degli exchange cripto. Metti una chiave fiat in asset_from o asset_to per passare in modalità trade.

Fiat → Cripto

L'utente vuole comprare cripto con contanti.

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth",
    "token_to": "usdt"
  }'

Cripto → Fiat

L'utente vuole incassare cripto.

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth",
    "token_from": "usdt",
    "amount_from": "100",
    "asset_to": "aed"
  }'

---

4. Crea Trade

POST /exchange/create api-key richiesta

Stesso endpoint degli exchange cripto. Blocca il tasso di trade e ricevi istruzioni di pagamento per la parte contanti, o un indirizzo di deposito per la parte cripto.

Fiat → Cripto

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth", "token_to": "usdt",
    "wallet_to": "0xRecipient...address"
  }'

Cripto → Fiat

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth", "token_from": "usdt", "amount_from": "100",
    "asset_to": "aed",
    "wallet_to": "iban:AE07..."
  }'

Traccia il trade con lo stesso endpoint Verifica Stato Exchange.