GET /trade/v1/{chainId}/quote/cross 1

Parameters

This is the list of important params for BTC trade

Name	Description
fromTokenAddress*	Zero address, as we only support trade from native Bitcoin to Ethereum on the Ethereum mainnet or Avax on the Avax network. Example: 0x0000000000000000000000000000000000000000
toTokenAddress*	Zero address, as we only support trade from native Bitcoin to Ethereum on the Ethereum mainnet or Avax on the Avax network. Example: 0x0000000000000000000000000000000000000000
amount*	Amount of tokens being traded. Example: 1 BTC → 100000000, 1 ETH → 1000000000000000000
destinationChainId*	The chain ID of the destination network. Available values: 1, 43114, -3980891822
sender*	The address of the sender. If trading from BTC to EVM, the sender is your BTC address. If trading from EVM to BTC, the sender is your EVM address. Example: 0x54c47034887C582Fc1Af4a9a3b68180a8a9eF2d2
receiver*	The address of the receiver. If trading from BTC to EVM, the receiver is your EVM address. If trading from EVM to BTC, the receiver is your BTC address. Example: bc1qf7cd6pvs9sqnkr0nadsuhgecy8prnc9t8k0jny
isExactOut	For BTC trade, we don't support exact out trade. isExactOut is false for this trade
chainId*	The chain ID of the chain to quote on. Available values: 1, 43114, -3980891822

Response

200: OK The response is an array of objects. Currently, we only support Thorchain for native BTC trade, so this array will have only one item for Thorchain.

[
    {
        "srcTradeList": [],
        "dstTradeList": [],
        "srcTrade": {
            "protocol": {
                "name": "Thorchain",
                "logo": "<https://thorchain.org/images/logos/full-dark.png>",
                "website": "<https://thorchain.org/>",
                "docsLink": "<https://thorchain.org/integrate>",
                "description": "THORChain is a network that facilitates native asset settlement between Bitcoin, Ethereum, BNB Chain, Avalanche, Cosmos Hub, Dogecoin, Bitcoin Cash & Litecoin"
            }
        },
        "dstTrade": {
            "toTokenAmount": "18478666090000000000",
            "deltaAmount": "18478666090000000000",
            "protocol": {
                "name": "Thorchain",
                "logo": "<https://thorchain.org/images/logos/full-dark.png>",
                "website": "<https://thorchain.org/>",
                "docsLink": "<https://thorchain.org/integrate>",
                "description": "THORChain is a network that facilitates native asset settlement between Bitcoin, Ethereum, BNB Chain, Avalanche, Cosmos Hub, Dogecoin, Bitcoin Cash & Litecoin"
            }
        },
        "transactionData": {
            "dust_threshold": "10000",
            "expected_amount_out": "1847866609",
            "expected_amount_out_streaming": "",
            "expiry": 1706758452,
            "fees": {
                "affiliate": "4652412",
                "asset": "ETH.ETH",
                "liquidity": "4040448",
                "outbound": "360000",
                "slippage_bps": 21,
                "total": "9052860",
                "total_bps": 48
            },
            "inbound_address": "bc1qkttu0a6gljrrswzyw3rwp59sunjep7zfqgyvr9",
            "inbound_confirmation_blocks": 1,
            "inbound_confirmation_seconds": 600,
            "max_streaming_quantity": 0,
            "memo": "=:ETH.ETH:0x207ca4370639120f9A049aF9CAB4fCaa608F2445::zcx-com:25",
            "notes": "First output should be to inbound_address, second output should be change back to self, third output should be OP_RETURN, limited to 80 bytes. Do not send below the dust threshold. Do not use exotic spend scripts, locks or address formats (P2WSH with Bech32 address format preferred).",
            "outbound_delay_blocks": 103,
            "outbound_delay_seconds": 618,
            "recommended_min_amount_in": "222000",
            "slippage_bps": 21,
            "streaming_slippage_bps": 21,
            "streaming_swap_blocks": 0,
            "total_swap_seconds": 1218,
            "warning": "Do not cache this response. Do not send funds after the expiry.",
            "amount": "100000000",
            "tradeType": "BTC_TO_NATIVE",
            "tradeProtocol": "CROSS_CHAIN_THORCHAIN"
        },
        "nativeValue": "100000000",
        "nativeValueFee": "0",
        "tradeProtocol": "CROSS_CHAIN_THORCHAIN",
        "sourceChainId": -3980891822,
        "destinationChainId": 1
    }
]