Swap assets

curl --request POST \
  --url https://api.etherfuse.com/ramp/swap \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "blockchain": "solana",
  "orderId": "9c7b3f1a-2e4d-4b6a-8c1d-0f9e8d7c6b5a",
  "publicKey": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
  "targetWallet": null
}
'

Swaps

Swap assets

Swaps two different crypto assets. Asynchronous — returns 200 OK with an empty body; track progress via webhooks.

Flow:

Call POST /ramp/quote with quoteAssets.type: "swap" to get pricing.
Call this endpoint with the returned quoteId to initiate the swap.
Listen for swap_updated webhook events to track progress and receive the transaction to sign.

Webhooks: because the response body is empty, register a swap_updated webhook (via POST /ramp/webhook) to receive SwapResponse payloads as the swap progresses: swap_created → swap_funded → swap_completed (or swap_failed).

POST

ramp

swap

Swap assets

curl --request POST \
  --url https://api.etherfuse.com/ramp/swap \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "blockchain": "solana",
  "orderId": "9c7b3f1a-2e4d-4b6a-8c1d-0f9e8d7c6b5a",
  "publicKey": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
  "targetWallet": null
}
'

Authorizations

Authorization

string

header

required

API key sent in the Authorization header.

Body

application/json

Request body for initiating an asset swap from a swap-type quote.

blockchain

enum<string>

required

Blockchain the swap executes on.

Available options:

stellar,

solana,

base,

polygon,

monad

orderId

string<uuid>

required

Client-generated order ID (UUID) for this swap.

publicKey

string

required

Customer's wallet public key on blockchain.

quoteId

string<uuid>

required

Quote ID from a prior /ramp/quote call made with quoteAssets.type: "swap".

targetWallet

string | null

Optional destination wallet; defaults to publicKey when omitted.

Response

Swap accepted; track completion via swap_updated webhooks

Search customer orders Regenerate swap tx

⌘I