API Documentation

Intégrez les puissantes capacités d'échange natif inter-chaînes de MakeSwap directement dans votre application. Notre API fournit un accès au protocole sous-jacent, permettant des échanges sécurisés et non dépositaires entre les principales blockchains comme Bitcoin, Ethereum, Polkadot, et plus encore.

Sécurisé et Non Dépositaire

Tous les échanges sont exécutés via des validateurs MPC. Nous ne détenons jamais les fonds des utilisateurs.

Exécution Rapide

Routage optimisé via des fournisseurs de liquidité JIT.

Actifs supportés

Utilisez le bon identifiant d'actif lors de l'interaction avec le point de terminaison Quote. Les identifiants suivent le format Chain.Ticker.

Liste des Actifs Supportés

Format d'Identifiant d'Actif

Les actifs sont identifiés par un format de chaîne : CHAIN.TICKER ou CHAIN.TICKER-CONTRACT

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

Actifs Natifs : e.g., ETH.ETH (Ethereum), BTC.BTC (Bitcoin)
Actifs Jetons : e.g., ETH.USDC-0xA0b8... (USDC on Ethereum)

Identifiant	Nom	Chaîne	Décimales
Aucun actif trouvé.

GETObtenir les jetons

Récupérer la liste complète des actifs supportés par programmation.

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

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

POSTObtenir un devis

Récupérer les routes d'échange disponibles et les devis pour une paire donnée. Ce point de terminaison est optimisé pour renvoyer des routes valides pour les actifs natifs supportés via le fournisseur Chainflip.

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

Terrain de Jeu Interactif - Obtenir un Devis

Actif de Vente

Actif d'Achat

Montant

Paramètres

Champ	Type	Requis	Description
sellAsset	string	Yes	Identifiant de l'actif (ex. 'BTC.BTC')
buyAsset	string	Yes	Identifiant de l'actif (ex. 'ETH.ETH')
sellAmount	string	Yes	Montant à échanger en unités natives

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

Réponse :

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

POSTSuivre l'échange

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

Réponse :

{
  "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.