API Documentation

Integrieren Sie die leistungsstarken nativen Cross-Chain-Swap-Funktionen von MakeSwap direkt in Ihre Anwendung. Unsere API bietet Zugriff auf das zugrunde liegende Protokoll und ermöglicht sichere, non-custodial Swaps zwischen großen Blockchains wie Bitcoin, Ethereum, Polkadot und mehr.

Sicher & Non-Custodial

Alle Swaps werden über MPC-Validatoren ausgeführt. Wir halten niemals Nutzergelder.

Schnelle Ausführung

Optimiertes Routing durch JIT-Liquiditätsanbieter.

Unterstützte Assets

Verwenden Sie die korrekte Asset-Kennung, wenn Sie mit dem Quote-Endpunkt interagieren. Kennungen folgen dem Format Chain.Ticker.

Liste unterstützter Assets

Format der Asset-Kennung

Assets werden durch ein String-Format identifiziert: CHAIN.TICKER oder CHAIN.TICKER-CONTRACT

Supported Asset List is intentionally curated to major assets only. Long-tail and scam-token candidates are excluded.

Native Assets: e.g., ETH.ETH (Ethereum), BTC.BTC (Bitcoin)
Token-Assets: e.g., ETH.USDC-0xA0b8... (USDC on Ethereum)

Kennung	Name	Chain	Dezimalstellen
Keine Assets gefunden.

GETToken abrufen

Rufen Sie die vollständige Liste der unterstützten Assets programmgesteuert ab.

GEThttps://makeswap.io/api/v1/tokens

curl -X GET "https://makeswap.io/api/v1/tokens"

POSTAngebot abrufen

Abrufen verfügbarer Swap-Routen und Angebote für ein bestimmtes Paar. Dieser Endpunkt ist optimiert, um gültige Routen für die unterstützten nativen Assets über den Chainflip-Anbieter zurückzugeben.

POSThttps://makeswap.io/api/v1/quote

curl -X POST "https://makeswap.io/api/v1/quote" \
-H "Content-Type: application/json" \
-d '{"sellAsset":"BTC.BTC", "buyAsset":"ETH.ETH", "sellAmount":"0.1"}'

Interaktiver Spielplatz - Angebot abrufen

Verkaufs-Asset

Kauf-Asset

Betrag

Parameter

Feld	Typ	Erforderlich	Beschreibung
sellAsset	string	Yes	Asset-Kennung (z.B. 'BTC.BTC')
buyAsset	string	Yes	Asset-Kennung (z.B. 'ETH.ETH')
sellAmount	string	Yes	Zu tauschender Betrag in nativen Einheiten

POSTSwap

Create swap transaction details from a previously selected route. This endpoint proxies SwapKit v3 /v3/swap.

POSThttps://makeswap.io/api/v1/swap

curl -X POST "https://makeswap.io/api/v1/swap" \
-H "Content-Type: application/json" \
-d '{ "routeId": "uuid", "sourceAddress": "bc1...", "destinationAddress": "0x123..." }'

Antwort:

{
  "routeId": "uuid",
  "targetAddress": "bc1...",
  "tx": "base64_or_hex",
  "swapId": "uuid"
}

POSTSwap verfolgen

Track swap status using hash + chainId, depositChannelId, or depositAddress.

POSThttps://makeswap.io/api/v1/track

curl -X POST "https://makeswap.io/api/v1/track" \
-H "Content-Type: application/json" \
-d '{ "hash": "0x...", "chainId": "1" }'

Antwort:

{
  "id": "12345",
  "status": "deposit_received", // waiting_deposit, sending, complete
  "depositAddress": "...",
  "txHash": null,
  "outAmount": null
}

POSTIntegration Token

Issue short-lived tokens for iframe, SDK, or wallet integrations. You can authenticate with partner credentials or an internal signed request.

POSThttps://makeswap.io/api/v1/integrations/token

curl -X POST "https://makeswap.io/api/v1/integrations/token" \
-H "Content-Type: application/json" \
-d '{ \"origin\": \"https://partner.example\", \"affiliateFeeBps\": 100 }'

Partner mode headers

x-makeswap-key-id
x-makeswap-key-secret

Internal wallet mode headers

x-makeswap-internal-key-id
x-makeswap-internal-timestamp (unix seconds)
x-makeswap-internal-signature (HMAC-SHA256 hex of METHOD\\nPATH\\nTIMESTAMP\\nSHA256(BODY))
x-makeswap-internal-body-sha256 (optional integrity check)

Embed quickstart

<iframe
  src="https://makeswap.io/embed?token=INTEGRATION_TOKEN"
  style="width:100%;min-height:640px;border:0"
  title="MakeSwap Widget"
/>

No-SDK partner onboarding

<iframe
  src="https://makeswap.io/embed/PARTNER_ID?sellAsset=BTC.BTC&buyAsset=ETH.ETH"
  style="width:100%;height:760px;border:0"
  title="MakeSwap Widget"
/>

The partner route validates parent website origin against allowed origins configured in admin.