Skip to main content

​
Overview

BTC and ETH support enables the following flows today:
Use caseProduct
Convert BTC or ETH to USDLiquidation Addresses
Accept USD and deliver BTC or ETHStatic Memos or Virtual Accounts
This functionality is currently in beta and access must be explicitly enabled before use.

​
Supported functionality

​
Offramps

Bridge currently supports the following offramp flows:
  • BTC on bitcoin → USD via Liquidation Address
  • ETH on ethereum → USD via Liquidation Address

​
Onramps

Bridge currently supports the following onramp flows:
  • USD via Virtual Account → BTC on bitcoin
  • USD via Virtual Account → ETH on ethereum

​
Not currently supported

The following flows are not supported today:
  • Prefunded flows for BTC and ETH offramps
  • Transfers for BTC and ETH offramps
  • Chain-to-chain conversions involving BTC or ETH on one side and a stablecoin on the other side, in either direction
  • Any non-USD fiat currency, such as EUR

​
Limitations

​
Supported chains

  • Only the Bitcoin blockchain is supported for BTC
  • Only the Ethereum blockchain is supported for ETH

​
Supported Bitcoin address types

Bridge supports only the following Bitcoin address types:
  • Legacy addresses starting with 1
  • P2SH addresses starting with 3
  • Native SegWit addresses starting with bc1q
Taproot addresses starting with bc1p are not supported.

​
Developer fees

Developer fees are handled differently depending on the flow type:
  • Developer fees are not available for liquidation address offramps involving BTC and ETH
  • For these liquidation address offramps, developer fees are set to 0
  • Developer fees are available for Static Memo and Virtual Account onramps

​
Quotes and pricing

Quote support for BTC and ETH is currently limited.
  • Bridge’s exchange rate API supports ETH → USD
  • Bridge’s exchange rate API does not support USD → ETH
  • Bridge does not currently provide quotes for BTC conversion rates
For unsupported quote directions, trades are executed at the best available market rate at the time of the transaction. If you have questions about pricing, please reach out to your Bridge team.

​
Access

BTC and ETH orchestration is a beta feature.
Access must be explicitly granted before you can use this functionality. Please reach out to a Bridge team member if you would like access enabled.

​
How to use

Use the existing Orchestration APIs with the parameter changes below.

​
Liquidation Addresses

Follow the standard Liquidation Address flow, but set the source chain and currency to match the asset you want to support.

​
BTC

{
  "chain": "bitcoin",
  "currency": "btc"
}

​
ETH

{
  "chain": "ethereum",
  "currency": "eth"
}

​
Virtual Accounts

Follow the standard Static Memo or Virtual Account flow, but set the destination object to match the asset and chain you want Bridge to deliver.

​
BTC

{
  "destination": {
    "payment_rail": "bitcoin",
    "currency": "btc",
    "address": "..."
  }
}

​
ETH

{
  "destination": {
    "payment_rail": "ethereum",
    "currency": "eth",
    "address": "..."
  }
}

​
Summary

BTC and ETH support is intended for a narrow set of orchestration flows today:
  • Offramp BTC or ETH to USD using Liquidation Addresses
  • Onramp USD to BTC or ETH using Static Memos or Virtual Accounts
If your use case requires prefunded flows, transfers, non-USD fiat, Taproot support, or stablecoin-to-BTC/ETH conversions, those are not supported today.