Create an exchange connection

​

How it works

1. Your backend requests a signed Connect URL for the user’s account.
2. Your app shows the URL in an iframe or in-app browser.
3. The user chooses an exchange and completes the transfer in Swapped’s hosted flow.
4. Swapped sends provider-order updates as the transfer progresses.
5. The funded crypto lands on the account and enters the standard deposit pipeline.

​

Prerequisites

• The account is registered. Minting a Connect URL for an account that is not registered to your project returns 403 Unauthorized.
• A webhook URL is configured if you want order updates pushed rather than polled.
• Calls are made from your backend. The endpoints require your API key, which never ships in client-side code.

const DEPOSIT_SERVICE_URL =
  "https://v1.orchestrator.rhinestone.dev/deposit-processor";
const API_KEY = "YOUR_RHINESTONE_API_KEY";

​

Mint a Connect URL

const response = await fetch(`${DEPOSIT_SERVICE_URL}/onramp/swapped/connect-url`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-key": API_KEY },
    body: JSON.stringify({
        smartAccount: "0xUSER_ACCOUNT_ADDRESS",
        connection: "binance",
    }),
});

​

Show the hosted connection flow

<iframe src={url} allow="payment; camera; microphone; clipboard-write" />