Rubic Documents
  • RUBIC
    • Overview
    • Rubic's Ecosystem
    • Security
    • Tokenomics
    • Roadmap
    • Rubic Discord Roles
    • “Swap to Earn” Program on Rubic
    • MEV-bot Protection
    • B2B Cross-Chain Toolkit
      • Use Cases
      • Why Rubic?
    • Refund Guidelines for Stuck Transactions
  • ⚒️Integrate SDK
    • SDK Overview
    • SDK Architecture
    • SDK Advantages
    • SDK Integration
    • 1️⃣Install SDK
    • 2️⃣Set up SDK
    • 3️⃣Trade calculation
    • 4️⃣Swap Execution
    • 📜Advanced documentation
    • Migration from V2 to V3
    • Contact Us
  • Integrate Widget
    • Widget Overview
    • Instruction
    • White Label Widget Integration Instruction
    • Partners
    • Listing of tokens
  • Rubic API
    • 🔐Tokens API
    • Referrer And Rate Limits
    • Rubic API
      • Supported chains
      • Supported providers
      • Request Quote
      • Request Data
      • Get Cross-Chain Status
      • Integration example
        • Swaps from EVM
        • Swaps from Solana
        • Swaps from TON
        • Swaps from Tron
        • Swaps from Bitcoin
        • Swaps VIA deposit
      • Swagger
      • Models
        • OnChainTradeType
        • CrossChainTradeType
        • FeesDto
        • RoutingDto
        • TransactionDto
        • ErrorDto
      • Errors
    • Monetization And Fees
  • FAQ
    • What is Rubic?
    • How to start using Rubic?
    • Who can use our service?
    • Is KYC required?
    • What are the minimum and maximum trade sizes?
    • Should I list my token before using your service?
    • How to create a Swap?
    • How long does it take to complete a transaction?
    • How is the privacy and security of the transaction ensured?
    • How does Rubic unite different DEX platforms?
    • Why does Rubic offer a choice between different providers?
    • How do I add the BNB Smart Chain and Polygon networks to MetaMask?
    • What should I do when I see the message: “Trading on Uniswap is not available?”
    • What should I do if Uniswap doesn’t display any rates?
    • How can we integrate the Rubic Relay widget?
    • How do we get listed on Rubic?
    • How to Complete swaps to/from TON network using Rubic
  • Contacts
    • Community
    • PR Marketing
    • Business Development
    • Support
    • Influencers Collaboration Requests
  • Legal Documentation
    • Privacy Policy
    • Terms of Use
    • Third-Party Software
  • Audits
    • MixBytes Audit
  • Pitch Deck
Powered by GitBook
On this page
  • Connecting a Web3 Wallet
  • Retrieving Token Quotes
  • Retrieving Data to Execute a Transaction
  • Rubic API can return 2 kinds of data for transaction: data for transfer and data for psbt transaction.
  • 1. Transfer transaction:
  • 2. PSBT transaction:
  • Executing a Transaction with the API Response Data
  • 1. Transfer transaction:
  • 2. PSBT transaction:
  • Track your transaction

Was this helpful?

  1. Rubic API
  2. Rubic API
  3. Integration example

Swaps from Bitcoin

Connecting a Web3 Wallet and Executing a Transaction through Rubic API

This page explains how to connect a Web3 wallet, retrieve token quotes and execute a transaction using Rubic API, with examples using CTRL wallet extension

Connecting a Web3 Wallet

To interact with the blockchain, we first need to connect a wallet.

Here are examples using CTRL wallet.

async function connectWallet() {
    if (window?.xfi?.bitcoin) {
       const wallet = this.window?.xfi?.bitcoin;
       const accounts = wallet.getAcccounts();
       
       return accounts[0];
    } else {
        console.error("Bitcoin provider not found. Please install Ctrl wallet.");
    }
}

Retrieving Token Quotes

Now that the wallet is connected, we can request token quotes from Rubic API.

Endpoint: POST https://api-v2.rubic.exchange/api/routes/quoteBest

async function quoteBest() {
    const response = await fetch("https://api-v2.rubic.exchange/api/routes/quoteBest", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: {
            "srcTokenAddress": "0x0000000000000000000000000000000000000000",
            "srcTokenAmount": "0.01",
            "srcTokenBlockchain": "BITCOIN",
            "dstTokenAddress": "0x0000000000000000000000000000000000000000",
            "dstTokenBlockchain": "ETH",
            "referrer": "rubic.exchange"
          }
    });
    const data = await response.json();
    const { estimate, transaction, id } = data;
    console.log(estimate);
    // {
    //     This is an estimated amount you will get after the swap.
    //     "destinationTokenAmount": "0.42498305",
    //     "destinationTokenMinAmount": "0.4122335585",
    //
    //     "destinationUsdAmount": 835.39,
    //     "destinationUsdMinAmount": 810.33,
    //
    //     "destinationWeiAmount": "425207819398076439",
    //     "destinationWeiMinAmount": "412451584816134146",
    //
    //     "durationInMinutes": 5,
    //     "priceImpact": 0.61,
    //     "slippage": 0.03
    // }
    
    console.log(id);
    // This is the swap ID. It will be needed later for swap request.
    return data;
}

You get more information about quote endpoint here:

Retrieving Data to Execute a Transaction

To perform a token swap through Rubic API, we need to get the necessary data for the transaction.

Endpoint: POST https://api-v2.rubic.exchange/api/routes/swap

Rubic API can return 2 kinds of data for transaction: data for transfer and data for psbt transaction.

1. Transfer transaction:

async function getSwapData() {
    const response = await fetch("https://api-v2.rubic.exchange/api/routes/swap", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: {
            "srcTokenAddress": "0x0000000000000000000000000000000000000000",
            "srcTokenAmount": "0.01",
            "srcTokenBlockchain": "BITCOIN",
            "dstTokenAddress": "0x0000000000000000000000000000000000000000",
            "dstTokenBlockchain": "ETH",
            "referrer": "rubic.exchange"
            "fromAddress": "USER WALLET ADDRESS",
            "id": "ID FROM QUOTE STEP",
            "receiver": "RECEIVER ADDRESS"
          }
    });
    const result = await response.json();
    const { transaction } = result;
    console.log(transaction);
    // {
    //     "to": "bc1ptyhru60vv9q57pqvuet5t3fpcyf7x2t2j83gkz3r3kcrhs9srxls4hcws5",
    //     "value": "1000000",
    // },
    return result;
}

2. PSBT transaction:

async function getSwapData() {
    const response = await fetch("https://api-v2.rubic.exchange/api/routes/swap", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: {
            "srcTokenAddress": "0x0000000000000000000000000000000000000000",
            "srcTokenAmount": "0.01",
            "srcTokenBlockchain": "BITCOIN",
            "dstTokenAddress": "0x0000000000000000000000000000000000000000",
            "dstTokenBlockchain": "ETH",
            "referrer": "rubic.exchange"
            "fromAddress": "USER WALLET ADDRESS",
            "id": "ID FROM QUOTE STEP",
            "receiver": "RECEIVER ADDRESS",
            "publicKey": "PUBLIC KEY OF USER WALLET ADDRESS" 
          }
    });
    const result = await response.json();
    const { transaction } = result;
    console.log(transaction);
    // {
    //     "psbt": "cHNidP8BAL4CAAAAAX7WtwDo7JF8EsZ+...AFgGARv/uOHXKMXpGDtp5ijUAAAAA",
    //     "signInputs": [0],
    // },
    return result;
}

You get more information about swap endpoint here:

Executing a Transaction with the API Response Data

Using the data obtained from the Rubic API, you can now execute the transaction.

1. Transfer transaction:

async function executeSwapViaTransfer(
    // Transaction object, obtained on previous step from Rubic API
    transaction,
    // From wallet address
    fromAddress,
    // Recipient wallet address
    toAddress
) {
    let hash = null;
    await window.xfi.bitcoin.request(
         {
            method: 'transfer',
            params: [
              {
                 feeRate: 10,
                 from: fromAddress,
                 recipient: toAddress,
                 amount: {
                    amount: transaction.value,
                    decimals: 8
                 }
              }
           ]
         },
         (error, txHash) => {
           if(error) {
             console.error(error)
           } else {
              hash = txHash;
             }
         }
    );
     
   if(!hash) throw new Error('Failed to transfer funds');
   
    return hash;
}

2. PSBT transaction:

async function executeSwap(
    // Transaction object, obtained on previous step from Rubic API
    transaction,
    // From wallet address
    fromAddress,
) {
    let hash = null;
    await window.xfi.bitcoin.request(
         {
            method: 'sign_psbt',
            params: {
                 psbt: transaction.psbt,
                 signInputs: {
                    [fromAddress]: transaction.signInputs
                 },
                 allowedSignHash: 1,
                 broadcast: true
              }
           }
         },
         (error, txData) => {
           if(error) {
             console.error(error)
           } else {
              hash = txData.result.txId;
             }
         }
    );
     
    if(!hash) throw new Error('Failed to sign psbt transaction');
   
    return hash;
}

Track your transaction

Now you can track your transaction status

Endpoint: GET https://api-v2.rubic.exchange/api/routes/status

async function getStatus(
    // Your transaction hash, otained while executing transaction
    hash
) {
    const response = await fetch(`https://api-v2.rubic.exchange/api/info/status?srcTxHash=${hash}`);
    const data = await response.json();
    const { status, destinationTxHash } = data;
    console.log(status);
    // Current TX status can be one of
    // 'PENDING' | 'LONG_PENDING' | 'REVERT' |
    // 'REVERTED' | 'FAIL' | 'READY_TO_CLAIM' |
    // 'SUCCESS' | 'NOT_FOUND';
    console.log(status);
    // shows the hash on the target network if the transaction
    // is successfully completed
    return status;
}

You get more information about status endpoint here:

PreviousSwaps from TronNextSwaps VIA deposit

Last updated 2 months ago

Was this helpful?

Request Quote
Request Data
Get Cross-Chain Status