API Documentation

Интегрируйте мощные возможности нативного кросс-чейн обмена MakeSwap непосредственно в ваше приложение. Наш API предоставляет доступ к базовому протоколу, обеспечивая безопасные, некастодиальные обмены между основными блокчейнами, такими как Bitcoin, Ethereum, Polkadot и другими.

Безопасно и Некастодиально

Все обмены выполняются через MPC-валидаторов. Мы никогда не храним средства пользователей.

Быстрое исполнение

Оптимизированная маршрутизация через JIT-провайдеров ликвидности.

Поддерживаемые активы

Используйте правильный идентификатор актива при взаимодействии с эндпоинтом Quote. Идентификаторы следуют формату Chain.Ticker.

Список поддерживаемых активов

Формат идентификатора актива

Активы идентифицируются строковым форматом: CHAIN.TICKER или CHAIN.TICKER-CONTRACT

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

Нативные активы: e.g., ETH.ETH (Ethereum), BTC.BTC (Bitcoin)
Токен-активы: e.g., ETH.USDC-0xA0b8... (USDC on Ethereum)

Идентификатор	Имя	Цепь	Десятичные
Активы не найдены.

GETПолучить токены

Получить полный список поддерживаемых активов программно.

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

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

POSTПолучить котировку

Получить доступные маршруты обмена и котировки для заданной пары. Этот эндпоинт оптимизирован для возврата действительных маршрутов для поддерживаемых нативных активов через провайдера 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"}'

Интерактивная песочница - Получить котировку

Актив продажи

Актив покупки

Сумма

Параметры

Поле	Тип	Обязательно	Описание
sellAsset	string	Yes	Идентификатор актива (например, 'BTC.BTC')
buyAsset	string	Yes	Идентификатор актива (например, 'ETH.ETH')
sellAmount	string	Yes	Сумма для обмена в нативных единицах

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

Ответ:

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

POSTОтследить обмен

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

Ответ:

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