API des Trades

Introduction

Les Trades sont le côté fiat du moteur d'exchange. Les mêmes endpoints, le même flux — juste avec une devise fiat d'un côté (entrée ou sortie en espèces) au lieu de deux actifs crypto. Utilise-le pour permettre aux utilisateurs d'acheter de la crypto avec USD/EUR/AED ou de retirer de la crypto vers un compte bancaire.

Tous les endpoints ci-dessous nécessitent un en-tête api-key de développeur. Contacte-nous pour en obtenir un.

api-key: YOUR_P3P_API_KEY

Comment fonctionne le fiat

Un trade est simplement un exchange où un côté est un actif fiat au lieu d'un token de chaîne. Définis asset_from (ou asset_to) sur une clé fiat comme "usd", "eur", "aed" — et omets les champs chain_* / token_* correspondants de ce côté. Le type de requête bascule automatiquement en "cash".

Endpoints

1. Obtenir les Fiats2. Obtenir les Taux3. Coter le Taux de Trade4. Créer un Trade

---

1. Obtenir les Fiats

GET /fiats api-key requise

Retourne chaque devise fiat actuellement supportée.

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. Obtenir les Taux

GET /rates api-key requise

Le même endpoint /rates que pour Exchanges — retourne les taux de référence pour les actifs crypto et fiat.

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

---

3. Coter le Taux de Trade

POST /exchange/rate api-key requise

Le même endpoint que les exchanges crypto. Mets une clé fiat dans asset_from ou asset_to pour passer en mode trade.

Fiat → Crypto

L'utilisateur veut acheter de la crypto avec de l'argent liquide.

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"
  }'

Crypto → Fiat

L'utilisateur veut retirer de la crypto.

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. Créer un Trade

POST /exchange/create api-key requise

Le même endpoint que les exchanges crypto. Verrouille le taux du trade et reçois des instructions de paiement pour la partie en espèces, ou une adresse de dépôt pour la partie crypto.

Fiat → Crypto

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"
  }'

Crypto → 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..."
  }'

Suis le trade avec le même endpoint Vérifier le Statut de l'Exchange.