SwapSpace API vs. Changelly API: ein vollständiger Entwicklervergleich

Das Hinzufügen von Swap-Funktionalität zu einer Wallet oder einem Web3-Produkt beeinflusst weit mehr als nur die Benutzererfahrung. Die ausgewählte API bestimmt, wie das Backend Quotes anfragt, mit abgelaufenen Kursen umgeht, Transaktionen nachverfolgt und reagiert, wenn ein Pfad nicht verfügbar ist. Sie prägt auch den Support-Aufwand, wenn ein Exchange verzögert wird, erstattet wird oder zur Verifizierung pausiert ist.

Dieser Vergleich zwischen Changelly API und SwapSpace API untersucht die technischen Unterschiede, die für Entwickler beim Aufbau von Wallets, Exchanges und anderen Web3-Produkten relevant sind.

Der Vergleich stützt sich auf die öffentliche Dokumentation der jeweiligen Anbieter und deren aktuelle B2B-Seiten. Verfügbarkeit von Assets, Anfrage-Limits, kommerzielle Bedingungen und Compliance-Regeln können sich ändern. Bestätige sie vor dem Launch über die Live-API und deine Partnervereinbarung.

Was ist die Changelly API?

Changelly API v2 ist eine White-Label-Krypto-Exchange-API, die einen Changelly-Quote- und Transaktionsdienst bereitstellt.

• Protokoll: JSON-RPC 2.0 über signierte POST-Anfragen.
• Authentifizierung: X-Api-Key plus RSA-SHA256-Signatur, mit Partnerkonto und Registrierung des öffentlichen Schlüssels.
• Kursmodelle: separate Methoden für feste und variable Kurse.
• Asset-Abdeckung: mehr als 1.000 Assets auf der öffentlichen B2B-Seite, wobei der live aktivierte Satz von der API zurückgegeben wird.
• Verwandte Produkte: separate Fiat-API-, Widget- und Checkout-Dienste.

Die API hält die Anbieterauswahl außerhalb der Anwendung. Feste und variable Schätzungen verwenden unterschiedliche Methoden, und feste Quotes haben ein kurzes Gültigkeitsfenster. Diese Unterschiede werden bei der Erstellung in die Transaktion übernommen. Der wichtigste Implementierungsunterschied ist die Signierung der Anfrage statt der Routenpriorisierung.

Was ist die SwapSpace API?

SwapSpace API v2 ist eine REST-API, die Angebote mehrerer Exchange-Partner über eine einzige Integration bereitstellt.

• Protokoll: ressourcenspezifische REST-Endpunkte für Währungen, Partner, Beträge, Exchange-Erstellung und Status.
• Authentifizierung: ein API-Schlüssel im Authorization-Header, mit für jedes Affiliate-Konto konfigurierten Anfrage-Limits.
• Kursmodelle: feste und variable Angebote, Partnerfilter und eine Best-Amount-Option.
• Asset-Abdeckung: mehr als 3.600 Assets über 675 Netzwerke und über 40 Liquiditätsquellen auf der öffentlichen B2B-Seite, mit erforderlicher Live-Routenvalidierung.
• Verwandte Produkte: ein Exchange-Widget und private Transfers, wobei der Zugang zu privaten Transfers separat bestätigt wird.

Jedes Angebot enthält Partner- und Routendaten. Eine Anwendung kann mehrere Angebote anzeigen, sie filtern oder eine einfachere Auswahlmethode verwenden. Angebots-IDs können nur kurz gültig sein, und Anbieter-Metadaten können Anforderungen an die Rückerstattungsadresse ändern. Diese daten auf Routenebene sind der wichtigste architektonische Unterschied zum Single-Service-Vertrag von Changelly.

Changelly API vs SwapSpace API auf einen Blick

Dieser Vergleich von Exchange-APIs konzentriert sich auf die Integrationsoberfläche, die ein Entwickler in der öffentlichen Dokumentation verifizieren kann.

Liquiditätsarchitektur: Single-Provider-API vs Aggregator

Quote-Auswahl und Transparenz

Changelly kann Liquidität über die eigene Infrastruktur beziehen, aber die Partner-API stellt Changelly als Servicegrenze dar. Deine Anwendung fragt einen Estimate an und erhält ein Ergebnis für die angeforderte Methode und das Paar. Das hält das Quote-Modell kompakt. Das Produkt muss keine Anbieter ranken oder erklären, warum zwei Anbieter unterschiedliche Limits zurückgegeben haben.

SwapSpace stellt die Liquiditätsaggregation direkt bereit. Der Amounts-Endpunkt kann Angebote aller verfügbaren Partner oder einer ausgewählten Partnerliste zurückgeben. Die Antwort kann feste und variable Routen für dasselbe Paar enthalten. Das gibt einer Wallet oder einem Exchange mehr Kontrolle über das Sorting. Ein Produkt kann nach Zielbetrag, geschätzter Dauer, Provider-Richtlinien oder eigenen Geschäftsregeln ranken.

Wenn ein Publikum Wert auf Anbieterauswahl oder Routen-Transparenz legt, kann eine SwapSpace-Integration mehrere Angebote anzeigen und produktspezifische Auswahlregeln anwenden. Ein einfacheres Produkt kann eine ausgewählte Route anzeigen. Anbieteridentität, Kurstyp, Limits und erwartete Dauer bleiben verfügbar, wenn die Oberfläche sie benötigt.

Verfügbarkeit und Fallback-Verhalten

Bei Changelly gilt: Wenn eine Währung deaktiviert ist oder ein Estimate fehlschlägt, stellt die API keinen anderen namentlich benannten Anbieter über denselben Vertrag bereit. Die Anwendung benötigt eine separate Integration, um eine andere Route auszuwählen.

Vor der Exchange-Erstellung kann SwapSpace Angebote anderer verfügbarer Partner zurückgeben. Sobald ein Exchange erstellt wurde, bleibt der ausgewählte Provider an diese Transaktion gebunden. Changelly konzentriert daher die Routenabhängigkeit in einem Dienst. SwapSpace bietet Fallback vor der Transaktion innerhalb derselben API.

Compliance- und Support-Grenzen

Beide APIs können verifizierungsbezogene Zustände anzeigen, aber die Verantwortung ist unterschiedlich aufgeteilt. 

Changelly dokumentiert einen Hold-Status und verweist den Partner darauf, Benutzer an sein Security-Team weiterzuleiten. 

SwapSpace stellt einen Verifying-Status bereit, während der ausgewählte Exchange-Provider die Prüfungen steuern kann. Anbieteridentität und Support-Anweisungen sind daher im aggregierten Modell wichtiger.

Entwicklererfahrung

Zugang und Authentifizierung

Die Authentifizierung ist der klarste Implementierungsunterschied und prägt die erste Phase einer Krypto-Swap-Integration.

Changelly:

• Partnerkonto und Registrierung des öffentlichen Schlüssels.
• RSA-SHA256-Signatur über jeden JSON-RPC-Request-Body.
• Serverseitige Integration zum Schutz des privaten Schlüssels.

SwapSpace:

• Affiliate-Konto und API-Schlüssel im Authorization-Header.
• Für das Affiliate-Konto während des Onboardings konfigurierte Anfrage-Limits.
• Serverseitige Speicherung des API-Schlüssels.

Changelly erfordert mehr Setup und Signing-Code. SwapSpace verwendet ein leichteres Credential-Modell, während die Produktionskapazität von der Affiliate-Konfiguration abhängt.

Dokumentation und Fehlerbehandlung

Changelly Dokumentation:

• Anfrage-Schemas auf Methodenebene und Fehlerbeispiele.
• Authentifizierungsbeispiele in mehreren Programmiersprachen.
• Migrationshinweise und eine detaillierte Statusreferenz.

SwapSpace Dokumentation:

• Ein kurzer REST-Flow von Währungen und Partnern bis zum Exchange-Status.
• Validierungsregeln für Beträge, Kurs-IDs, Extra-IDs, Benutzer-IPs und bedingte Rückerstattungsadressen.

Changelly bietet ausführlicheres Material zu Authentifizierung und Fehlern. SwapSpace dokumentiert einen kürzeren Ablauf mit mehr Daten zur Routenauswahl.

Die JSON-RPC-Antworten von Changelly enthalten methodenspezifische Codes und Nachrichten. Der REST-Flow von SwapSpace dokumentiert Validierungsfelder wie Netzwerk-IDs, Rate-IDs, Extra-IDs, Benutzer-IPs und bedingte Rückerstattungsadressen. Ordne diese Fehler aus dem Upstream in stabile interne Kategorien ein, bevor sie die Oberfläche erreichen. Bewahre den ursprünglichen Fehlercode und die Exchange-ID in den Logs auf, damit der Support eine Route nachvollziehen kann, ohne rohe Provider-Nachrichten für den Nutzer anzuzeigen.

Leistungs- und Skalierbarkeitsaspekte

Changelly veröffentlicht ein Standardlimit von 10 Anfragen pro Sekunde für relevante Methoden. Höhere Durchsatzgrenzen sind in der öffentlichen Referenz nicht angegeben.

SwapSpace veröffentlicht keine standardmäßige numerische Obergrenze, da die Anfrage-Limits für jedes Affiliate-Konto konfiguriert werden. Die Kapazitätsplanung hängt daher von der vereinbarten Partnerkonfiguration ab und nicht von einem öffentlichen Standardwert.

Beide öffentlichen Abläufe stellen statusbasierte Polling-Endpunkte bereit. Die für diesen Vergleich geprüften öffentlichen Referenzen definieren keinen allgemeinen Webhook-Vertrag, daher bleibt die Verfügbarkeit von Webhooks Teil des Partner-Onboardings.

Auch das Polling-Verhalten wirkt sich auf die Kapazitätsplanung aus. Cache Währung- und Partner-Metadaten für ein definiertes Intervall, vermeide das Aktualisieren von Quotes, auf die Nutzer nicht reagieren können, und reduziere die Häufigkeit von Statusprüfungen, nachdem eine Transaktion ihre zeitkritischen Phasen verlassen hat. Lasttests sollten Quote-Spitzen, abgelaufene IDs, deaktivierte Paare und Fehler auf Anbieter-Seite abdecken. Miss den gesamten Fehlerpfad statt nur eines einzelnen Latenzwerts: Das Produkt sollte reaktionsfähig bleiben, wenn Routen verschwinden oder Upstream-Antworten langsamer werden.

Support und Eskalation

Für eine Krypto-Exchange-API für Entwickler ist der Support besonders wichtig, wenn eine Transaktion hängt oder in die Verifizierung übergeht. 

Changelly verweist technische Fragen an eine Partner-E-Mail oder einen dedizierten Account Manager. Die Dokumentation beschreibt ein Eskalationsmodell, in dem der Partner First-Line-Support übernimmt und ungelöste Fälle über einen dedizierten Slack-Kanal an das Second-Level-Team von Changelly weiterleitet.

SwapSpace bietet eine Partner-E-Mail und ein B2B-Kontaktformular sowie 24/7-Nutzersupport. Eskalationspfade und Reaktionszusagen hängen von der Partnervereinbarung ab.

Vor der Integration einer der beiden APIs solltest du Supportzeiten, Benachrichtigungen bei Vorfällen, Zugriff auf die Statusseite und die Daten bestätigen, die zur Untersuchung eines hängenden Exchangs benötigt werden.

Kommerzielle Bedingungen und Umsatzmodell

Keine der Krypto-Exchange-APIs erhebt eine öffentliche Integrationsgebühr. Beide unterstützen die Monetarisierung über eine zusätzliche Gebühr oder ein Revenue-Sharing-Modell.

Changelly erlaubt API-Partnern, dem Wechselkurs eine Gebühr hinzuzufügen. Die Business-FAQ nennt 0,1 % bis 5 % als typischen Bereich, während die aktuelle API-Dokumentation sagt, dass die Gebühr über das Partnerteam konfiguriert wird.

Der Exchange-Erstellungs-Endpunkt von SwapSpace enthält einen optionalen affiliateFee-Parameter. Die Affiliate-Gebühr hängt vom ausgewählten Liquiditätsanbieter und der Partnervereinbarung ab.

Integrations-Workflow

Die folgenden Schritte vergleichen beide Krypto-Swap-API-Abläufe und den jeweiligen Engineering-Aufwand für die Krypto-API-Integration.

Typische Changelly-Integration

1. 1. Erstelle ein Changelly-Partnerkonto und generiere den öffentlichen und privaten Schlüssel.
2. 2. Registriere den öffentlichen Schlüssel bei Changelly und bewahre den privaten Schlüssel in einem serverseitigen Secret Store auf.
3. 3. Implementiere die Serialisierung von JSON-RPC-2.0-Anfragen und die RSA-SHA256-Signierung.
4. 4. Rufe die aktivierten Währungsdaten ab und ordne Ticker, Netzwerke, Memo-Felder und Validierungsregeln zu.
5. 5. Fordere einen variablen oder festen Estimate an und validiere anschließend den zurückgegebenen Betrag und die Limits.
6. 6. Erstelle den richtigen Transaktionstyp, bevor das Quote- oder Zahlungsfenster abläuft.
7. 7. Speichere die Transaktions-ID und frage getStatus oder getTransactions mit Backoff ab.
8. 8. Ordne jeden Endzustand, Refund-, Ablauf- und Verifizierungsstatus einer Nutzermeldung und einem Support-Prozess zu.

Changelly setzt zwei Protokollbeschränkungen durch: Die Signatur muss exakt zum serialisierten Body passen, und v2-Estimates müssen mit v2-Transaktionsmethoden gekoppelt bleiben.

💡 Wichtig! Feste und variable Abläufe verwenden unterschiedliche Methoden und sollten daher separat getestet werden.

Typische SwapSpace-Integration

1. 1. Erstelle ein Affiliate-Konto, hole den API-Schlüssel und bestätige die Anfragekapazität für die Zielumgebung.
2. 2. Rufe die Währungsliste ab und bewahre die separaten Asset- und Netzwerk-IDs auf.
3. 3. Rufe die Partnerliste ab und speichere Routenvorgaben wie Regeln für Rückerstattungsadressen.
4. 4. Fordere verfügbare Beträge für das Paar, den Betrag, die Netzwerke und die erforderlichen Kurstypen an.
5. 5. Ranke die zurückgegebenen Angebote oder verwende den Best-Amount-Endpunkt gemäß der Auswahlrichtlinie des Produkts.
6. 6. Validiere Mindest- und Höchstwerte und erstelle dann den Exchange, bevor eine zurückgegebene Rate-ID abläuft.
7. 7. Speichere die SwapSpace-Exchange-ID, den ausgewählten Provider und die nutzerseitigen Transaktionsdaten.
8. 8. Rufe den Status-Endpunkt mit Backoff ab und behandle abgeschlossene, fehlgeschlagene, erstattete, verifizierende und abgelaufene Zustände.

SwapSpace bindet das ausgewählte Angebot an den erstellten Exchange. Ein neues Quote oder ein anderer Provider erzeugt eine neue Exchange-Anfrage.

💡 Wichtig! Wenn ein Quote vor der Exchange-Erstellung abläuft, sollte der Nutzer das aktualisierte Angebot bestätigen.

Welche API passt zu welchen Produkten?

Teams, die eine Krypto-API für Wallets bewerten, sollten zuerst entscheiden, ob Nutzer eine einzige Exchange-Beziehung oder eine sichtbare Anbieterauswahl benötigen.

Die Tabelle betrachtet die Produktpassung als Ausgangshypothese. Kommerzielle Bedingungen, Regionen, Asset-Nachfrage, Traffic und interne Engineering-Kapazitäten können das Ergebnis ändern.

Wann die Changelly API sinnvoll ist

Die Changelly API passt zu Produkten, die einen Exchange-Dienst und eine kompakte Quote-Antwort bevorzugen.

Die ausführlichen Beispiele zur Signierung und die Fehlerdokumentation auf Methodenebene helfen Teams, die eine klar spezifizierte Authentifizierungsebene schätzen. Sie kann auch für Unternehmen geeignet sein, die Changellys separate Fiat- oder Checkout-Produkte unter derselben B2B-Beziehung evaluieren wollen.

Der Nachteil ist die Sichtbarkeit der Route. Die API gibt einen Changelly-Estimate zurück statt einer Liste namentlich benannter Exchange-Provider. Die Integration erfordert außerdem während des Onboardings die Registrierung eines öffentlichen Schlüssels.

Wann die SwapSpace API sinnvoll ist

SwapSpace passt besser, wenn der Vergleich von Anbietern Teil des Produkts ist. Sie bietet mehrere Angebote, feste und variable Optionen, Partnerfilter und Routenmetadaten über eine REST-API. Die B2B-Seite listet mehr als 40 Liquiditätsquellen und 3.600+ Assets über 675 Netzwerke. Der Mehrwert liegt in einer breiteren Long-Tail- und Cross-Chain-Routenabdeckung über einen einzigen Vertrag.

Wenn ein Produkt mehrere Angebote abruft und eine Route selbst auswählt, kann die Integration explizite Auswahlkriterien, die Behandlung von Quote-Abläufen und anbieterspezifische Exchange-Daten benötigen. Produkte, die Best Amount oder einen einfacheren Flow verwenden, können mehr von dieser Routing-Logik außerhalb der Benutzeroberfläche halten.

Fazit

Es gibt keine universell beste Swap-API. 

Changelly verwendet JSON-RPC 2.0, RSA-SHA256-Request-Signierung und ein Single-Provider-Quote-Modell. Es bietet ausführliche Methoden- und Fehlerdokumentation, stellt aber keine konkurrierenden Provider-Routen über dieselbe API bereit. 

SwapSpace verwendet REST mit API-Key-Authentifizierung und gibt Angebote von mehreren Exchange-Partnern zurück, wodurch Produkte mehr Kontrolle über die Routenwahl und eine breitere Asset-Abdeckung erhalten.

Wähle Changelly für Produkte, die eine Beziehung zu einem einzelnen Provider, einen kompakten Quote-Flow und ausführliche Dokumentation auf Methodenebene bevorzugen. Wähle SwapSpace für Wallets, Exchanges und Web3-Produkte, die Anbietervergleich, Liquiditätsaggregation oder eine breitere Long-Tail-Routenabdeckung benötigen.

Starte deine SwapSpace API-Integration

Sende das Formular auf der SwapSpace-B2B-Seite ab, um mit den Produkt- und Business-Development-Teams über Zugang, Anfrage-Limits und Integrationsanforderungen zu sprechen. 

Häufig gestellte Fragen

Was ist der Unterschied zwischen SwapSpace API und Changelly API?

Changelly stellt einen White-Label-Exchange-Dienst über JSON-RPC 2.0 bereit. Die Anwendung erhält Changelly-Estimates und erstellt Changelly-Transaktionen. SwapSpace stellt mehrere Partnerangebote über eine REST-API bereit und ermöglicht es der Anwendung, Routen vor der Exchange-Erstellung zu vergleichen oder zu filtern.

Aggregiert die SwapSpace API mehrere Liquiditätsanbieter?

Ja. Der Amounts-Endpunkt kann Angebote aller verfügbaren Partner zurückgeben oder nach ausgewählten Partnern filtern. Die öffentliche B2B-Seite listet mehr als 40 Liquiditätsquellen. Die Verfügbarkeit variiert je nach Asset, Netzwerk, Betrag, Kurstyp und aktuellen Bedingungen des Anbieters.

Welche API ist besser für Krypto-Wallets?

Das hängt vom Produktdesign der Wallet ab. Changelly passt zu einer Wallet, die einen einzelnen Quote und eine Provider-Beziehung möchte. SwapSpace passt zu einer Wallet, die Providervergleich, breitere Routenabdeckung oder eine eigene Logik zum Ranken von Angeboten möchte. Die Eignung hängt auch davon ab, wie gut die üblichen und Long-Tail-Paare der Wallet abgedeckt sind.

Kann ich Krypto-Swaps integrieren, ohne meine eigene Exchange zu bauen?

Ja. Beide APIs erlauben es einem Produkt, die Exchange-Ausführung auszulagern und gleichzeitig die Kontrolle über die Oberfläche und die Backend-Orchestrierung zu behalten. Adressvalidierung, Statusbehandlung und Support bleiben Teil der Produktintegration.

Unterstützt die SwapSpace API feste und variable Kurse?

Ja. Der Amounts-Endpunkt akzeptiert Fixed- und Float-Filter und kann beide Typen in einer Anfrage zurückgeben. Die Unterstützung hängt vom Partner und vom Paar ab. Einige Angebote enthalten eine kurzlebige Rate-ID, die bei der Exchange-Erstellung verwendet werden muss.

Wie lange dauert eine typische API-Integration?

Öffentliche Marketing-Schätzungen sind kein verlässlicher Projektplan. Ein einfacher Proof of Concept kann Tage dauern, während der Produktionszeitpunkt von Key-Freigaben, Security-Review, UI-Arbeit, Compliance-Status, Analytics und Support-Tools abhängt.

_______

Dieser Vergleich dient nur zu Informationszwecken. API-Funktionen, Asset-Abdeckung, Limits, Gebühren und Compliance-Anforderungen können sich ändern. Prüfe die aktuelle Dokumentation und die Vertragsbedingungen, bevor du eine produktive Krypto-Exchange-API einsetzt.