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トークンを取得
サポートされている資産の完全なリストをプログラムで取得します。
curl -X GET "https://makeswap.io/api/v1/tokens"
POST見積もりを取得
特定のペアで利用可能なスワップルートと見積もりを取得します。このエンドポイントは、Chainflipプロバイダーを介してサポートされているネイティブ資産の有効なルートを返すように最適化されています。
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.
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.
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.
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.