Entwickler

Swapoon-API

Öffentliche Endpunkte für Assets und Kurse sowie eine authentifizierte Partner-API.

Einführung

Die Swapoon-API besteht aus zwei Teilen. Die öffentlichen Endpunkte sind schreibgeschützt und erfordern keine Authentifizierung — sie listen unterstützte Assets und aktuelle Kurse auf. Die Partner-API wird per Schlüssel authentifiziert und ermöglicht das Erstellen echter Tauschvorgänge, die automatisch Ihrem Partnerkonto gutgeschrieben werden. Alle Endpunkte liegen unter der nachstehenden Basis-URL und liefern JSON.

https://swapoon.io/api/v1

Antwortformat

Öffentliche Endpunkte betten ihre Nutzdaten in eine success/data-Hülle ein. Die Partner-API liefert ein flaches Objekt mit einem ok-Boolean und den relevanten Feldern auf oberster Ebene.

// Public endpoints { "success": true, "data": { ... } } // Affiliate API { "ok": true, ... } // Affiliate API — error { "ok": false, "error": "Human-readable message" }

Öffentliche Endpunkte

GET /pairs öffentlich

Liste der unterstützten Assets mit Limits und Dezimalstellen.

// 200 OK { "success": true, "data": { "pairs": [ { "key": "XMR", "symbol": "XMR", "name": "Monero", "chain": "Monero", "decimals": 12, "min": "0.15", "max": "500", "min_usd": 25 } ] } }

GET /rates öffentlich

Aktuelle Wechselkurse (zwischengespeichert). Basis-Asset ist XMR.

// 200 OK { "success": true, "data": { "rates": [ ... ], "updated_at": "2026-06-30T12:00:00Z", "base": "XMR" } }

Partner-API

Überblick

Mit der Partner-API binden Sie Swapoon in Ihre eigene Website oder App ein. Jeder darüber erstellte Tausch wird automatisch Ihrem Partnerkonto gutgeschrieben — Sie erhalten 0.5 % des Volumens jedes abgeschlossenen Tauschs, manuell in Monero ausgezahlt. Ihren API-Schlüssel erzeugen Sie in Ihrem Partner-Dashboard.

Authentifizierung

Übergeben Sie Ihren geheimen Schlüssel bei jeder Anfrage als Bearer-Token. Halten Sie ihn vertraulich — mit ihm lassen sich echte Tauschvorgänge erstellen. Bei einem Leck widerrufen und erneuern Sie ihn im Dashboard (der alte Schlüssel wird sofort ungültig).

# Header Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Serverseitig wird nur der Hash des Schlüssels gespeichert. Der vollständige Schlüssel wird einmalig bei der Erstellung angezeigt.

GET /coins auth

Unterstützte Token mit ihren Keys, Symbolen, Chains und Dezimalstellen.

// 200 OK { "ok": true, "coins": [ { "key": "XMR", "symbol": "XMR", "name": "Monero", "chain": "Monero", "decimals": 12 }, { "key": "BTC", "symbol": "BTC", "name": "Bitcoin", "chain": "Bitcoin", "decimals": 8 } ] }

GET /rate auth

Angebot für ein Paar. Query-Parameter: from, to (Token-Keys aus /coins), amount (in lesbaren Einheiten).

# Request GET /api/v1/rate?from=XMR&to=BTC&amount=0.5 // 200 OK { "ok": true, "from": "XMR", "to": "BTC", "amount_in": 0.5, "amount_out": "0.00251", "rate": 0.00502, "min": 0.15, "max": 500, "eta": "15–30 min" }

POST /swaps auth

Erstellt einen echten Tausch, der Ihrem Konto gutgeschrieben wird. Body (JSON): from, to, amount, to_address sowie optional refund_address. Senden Sie die Einzahlung an die zurückgegebene Adresse.

# Request body { "from": "XMR", "to": "BTC", "amount": 0.5, "to_address": "bc1q...", "refund_address": "4A..." // optional } // 201 Created { "ok": true, "id": "a1b2c3d4e5f6...", "status": "awaiting_deposit", "deposit_address": "4B...", "deposit_amount": "0.5", "deposit_symbol": "XMR", "expected_output": "0.00251", "to_symbol": "BTC", "to_address": "bc1q..." }

Erzeugt eine echte Transaktion mit echten Mitteln. Prüfen Sie to_address sorgfältig — Tauschvorgänge sind unumkehrbar.

GET /swaps/{id} auth

Status eines Ihrer Tauschvorgänge. Sichtbar sind nur Tauschvorgänge, die mit Ihrem Schlüssel erstellt wurden.

// 200 OK { "ok": true, "id": "a1b2c3d4e5f6...", "status": "completed", "from_symbol": "XMR", "to_symbol": "BTC", "deposit_address": "4B...", "deposit_amount": "0.5", "expected_output": "0.00251", "to_address": "bc1q...", "created_at": "2026-07-08T09:56:56Z" }

Status: awaiting_deposit, deposit_detected, deposit_confirmed, exchanging, sending, completed, expired, refunded.

GET /swaps auth

Paginierte Historie Ihrer Tauschvorgänge. Query-Parameter: per_page (1–50, Standard 20).

// 200 OK { "ok": true, "swaps": [ { "id": "a1b2c3d4...", "status": "completed", "from_symbol": "XMR", "to_symbol": "BTC", "deposit_amount": "0.5", "expected_output": "0.00251", "created_at": "2026-07-08T09:56:56Z" } ], "page": 1, "pages": 3, "total": 42 }

GET /stats auth

Ihre Partner-Summen: Klicks, Tauschvorgänge, Volumen, verdient und ausstehend.

// 200 OK { "ok": true, "stats": { "code": "cryptojoe", "clicks": 128, "swaps": 42, "volume_usd": 15230.50, "earned_usd": 76.15, "paid_usd": 50.00, "pending_usd": 26.15, "payout_mode": "xmr_manual", "active": true } }

Fehler

Fehler verwenden die üblichen HTTP-Statuscodes mit einem ok: false-Body.

`401`	API-Schlüssel fehlt oder ist ungültig.
`404`	Tausch nicht gefunden (oder nicht Ihrer).
`422`	Ungültige Parameter, unbekannter Token oder Betrag außerhalb der Grenzen.
`429`	Ratenlimit überschritten.

Ratenlimits

Öffentliche Endpunkte: 120 Anfragen pro Minute und IP. Partner-Leseabrufe: 120 pro Minute und Schlüssel. Tauscherstellung (POST /swaps): 10 pro Minute und Schlüssel, da dabei echte Mittel bewegt werden. Bei Überschreitung folgt ein 429.

Fragen?

Melden Sie sich, wenn Sie mit der Swapoon-API entwickeln.

Kontakt aufnehmen