API сделок

Введение

Сделки — это фиатная сторона движка биржи. Те же эндпоинты, тот же процесс — просто с фиатной валютой с одной стороны (внесение или вывод наличных) вместо двух крипто активов. Используйте это, чтобы позволить пользователям покупать крипто за USD/EUR/AED или выводить крипто на банковский счёт.

Все эндпоинты ниже требуют заголовок разработчика api-key. Свяжитесь с нами, чтобы получить его.

api-key: YOUR_P3P_API_KEY

Как работает фиат

Сделка — это просто обмен, где одна сторона является фиатным активом вместо токена сети. Установите asset_from (или asset_to) на фиатный ключ, такой как "usd", "eur", "aed" — и пропустите соответствующие поля chain_* / token_* на этой стороне. Тип запроса автоматически переключается на "cash".

Эндпоинты

1. Получить фиаты2. Получить курсы3. Котировка курса сделки4. Создать сделку

---

1. Получить фиаты

GET /fiats требуется api-key

Возвращает каждую фиатную валюту, поддерживаемую в данный момент.

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. Получить курсы

GET /rates требуется api-key

Тот же эндпоинт /rates, что и для бирж — возвращает референсные курсы как для крипто, так и для фиатных активов.

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

---

3. Котировка курса сделки

POST /exchange/rate требуется api-key

Тот же эндпоинт, что и для крипто обменов. Поместите фиатный ключ в asset_from или asset_to, чтобы переключиться в режим сделки.

Фиат → Крипто

Пользователь хочет купить крипто за наличные.

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

Крипто → Фиат

Пользователь хочет вывести крипто.

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. Создать сделку

POST /exchange/create требуется api-key

Тот же эндпоинт, что и для крипто обменов. Зафиксируйте курс сделки и получите инструкции по оплате для наличной части или адрес депозита для крипто части.

Фиат → Крипто

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

Крипто → Фиат

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

Отслеживайте сделку с помощью того же эндпоинта Проверить статус обмена.