API de Trades

Introducción

Los Trades son el lado fiat del motor de exchange. Los mismos endpoints, el mismo flujo — solo con una moneda fiat en un lado (entrada o salida de efectivo) en lugar de dos activos cripto. Úsalo para permitir que los usuarios compren cripto con USD/EUR/AED o retiren cripto a una cuenta bancaria.

Todos los endpoints a continuación requieren un encabezado api-key de desarrollador. Contáctanos para obtener uno.

api-key: YOUR_P3P_API_KEY

Cómo funciona el fiat

Un trade es simplemente un exchange donde un lado es un activo fiat en lugar de un token de cadena. Establece asset_from (o asset_to) en una clave fiat como "usd", "eur", "aed" — y omite los campos correspondientes chain_* / token_* en ese lado. El tipo de solicitud cambia automáticamente a "cash".

Endpoints

1. Obtener Fiats2. Obtener Tasas3. Cotizar Tasa de Trade4. Crear Trade

---

1. Obtener Fiats

GET /fiats api-key requerida

Devuelve cada moneda fiat actualmente soportada.

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. Obtener Tasas

GET /rates api-key requerida

El mismo endpoint /rates que en Exchanges — devuelve tasas de referencia tanto para activos cripto como fiat.

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

---

3. Cotizar Tasa de Trade

POST /exchange/rate api-key requerida

El mismo endpoint que los exchanges cripto. Pon una clave fiat en asset_from o asset_to para cambiar al modo trade.

Fiat → Cripto

El usuario quiere comprar cripto con efectivo.

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

El usuario quiere retirar 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. Crear Trade

POST /exchange/create api-key requerida

El mismo endpoint que los exchanges cripto. Bloquea la tasa del trade y recibe instrucciones de pago para la parte en efectivo, o una dirección de depósito para 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..."
  }'

Rastrea el trade con el mismo endpoint Verificar Estado de Exchange.