Trade API

Introduktion

Trades är fiat-sidan av exchange-motorn. Samma endpoints, samma flöde — bara med en fiatvaluta på ena sidan (kontantinsättning eller kontantutsläpp) istället för två kryptotillgångar. Använd det för att låta användare köpa krypto med USD/EUR/AED eller ta ut krypto till ett bankkonto.

Alla endpoints nedan kräver en utvecklar-api-key-header. Kontakta oss för att få en.

api-key: YOUR_P3P_API_KEY

Hur fiat fungerar

En trade är bara en exchange där ena sidan är en fiat-tillgång istället för en kedjetoken. Sätt asset_from (eller asset_to) till en fiatnyckel som "usd", "eur", "aed" — och hoppa över de matchande chain_* / token_*-fälten på den sidan. Begäran-typen växlar automatiskt till "cash".

Endpoints

1. Hämta fiats2. Hämta kurser3. Citera trade-kurs4. Skapa trade

---

1. Hämta fiats

GET /fiats api-key krävs

Returnerar varje fiatvaluta som för närvarande stöds.

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. Hämta kurser

GET /rates api-key krävs

Samma /rates-endpoint som Exchanges — returnerar referenskurser för både krypto- och fiat-tillgångar.

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

---

3. Citera trade-kurs

POST /exchange/rate api-key krävs

Samma endpoint som krypto-exchanges. Sätt en fiatnyckel i asset_from eller asset_to för att växla till trade-läge.

Fiat → Krypto

Användaren vill köpa krypto med kontanter.

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

Krypto → Fiat

Användaren vill ta ut krypto.

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. Skapa trade

POST /exchange/create api-key krävs

Samma endpoint som krypto-exchanges. Lås trade-kursen och få betalningsinstruktioner för kontantbenet, eller en insättningsadress för kryptobenet.

Fiat → Krypto

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

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

Spåra trade med samma Kontrollera exchange-status-endpoint.