Deposit Generation

POST /leokit/deposit

Generate unsigned transaction(s) for executing a swap based on a previously obtained quote.

Request Body

{
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "selected_protocol": "thorchain"
}

Field	Type	Required	Description
`quote_id`	string	Yes	UUID from quote response
`selected_protocol`	string	Yes	Protocol to use (must exist in quote)

Validation Rules

Quote Existence - Quote must exist in database
Client Ownership - Quote must belong to requesting client (API key match)
Protocol Availability - Selected protocol must be in quote’s available protocols
Quote Expiry - Quote must not be expired (protocol-specific rules)
Ecosystem Support - Blockchain ecosystem must be supported

Response Formats by Ecosystem

The response format varies based on the source blockchain ecosystem.

UTXO Chains (Bitcoin, Litecoin, Dogecoin, Dash)

Supported Chains: BTC, LTC, DOGE, DASH

PSBT Format (BTC, LTC, DOGE)

{
  "type": "UTXO",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "from_asset": "BTC.BTC",
    "to_asset": "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amount": "100000000",
    "decimals": 8,
    "memo": "=:ETH.USDC-0xA0b86991:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb:198500000"
  },
  "unsigned_transaction": {
    "psbt_hex": "cHNidP8BAH0CAAAAAR...",
    "selected_utxos": [
      {
        "txid": "a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890",
        "vout": 0,
        "value": 105000000,
        "script": "0014751e76e8199196d454941c45d1b3a323f1433bd6"
      }
    ],
    "chain": "BTC"
  }
}

Raw Transaction Format (DASH)

For DASH, raw_unsigned_tx is provided instead of psbt_hex:

{
  "type": "UTXO",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "Xy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "from_asset": "DASH.DASH",
    "to_asset": "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amount": "100000000",
    "decimals": 8,
    "memo": "=:ETH.USDC-0xA0b86991:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb:198500000"
  },
  "unsigned_transaction": {
    "raw_unsigned_tx": "0200000001a1b2c3d4...",
    "selected_utxos": [
      {
        "txid": "a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890",
        "vout": 0,
        "value": 105000000,
        "script": "76a914751e76e8199196d454941c45d1b3a323f1433bd688ac"
      }
    ],
    "chain": "DASH"
  }
}

Key Features

PSBT Format: Bitcoin, Litecoin, Dogecoin use Partially Signed Bitcoin Transaction format
OP_RETURN Memo: Embedded in transaction for THORChain/MAYA swaps
UTXO Selection: Automatic selection with fee estimation
Change Outputs: Only created if above dust threshold (546 sats for BTC/LTC, 1 DOGE for DOGE)

Memo Length Limits

BTC/LTC: 150 bytes (OP_RETURN limit: 80 bytes)
DOGE: 80 bytes

EVM Chains (Ethereum, BSC, Arbitrum, etc.)

Supported Chains: ETH, BSC, ARB, AVAX, BASE, POLYGON, OPTIMISM, FANTOM

Native Token Transfer (ETH, BNB, etc.)

{
  "type": "EVM",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "to_address": "0x1234567890AbcdEF1234567890aBcdef12345678",
    "from_asset": "ETH.ETH",
    "to_asset": "BTC.BTC",
    "amount": "1000000000000000000",
    "decimals": 18,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh:9850000000"
  },
  "unsigned_transactions": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "to": "0xD37BbE5744D730a1d98d8DC97c42F0Ca46aD7146",
      "value": "0xde0b6b3a7640000",
      "data": "0x44bc937b0000000000000000000000001234567890abcdef1234567890abcdef12345678...",
      "nonce": 42,
      "chainId": 1,
      "gasLimit": "150000",
      "maxFeePerGas": "50000000000",
      "maxPriorityFeePerGas": "2000000000"
    }
  ]
}

ERC20 Token Transfer with Approval

{
  "type": "EVM",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "to_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "from_asset": "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "to_asset": "BTC.BTC",
    "amount": "2000000000",
    "decimals": 6,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "unsigned_transactions": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "to": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "value": "0x0",
      "data": "0x095ea7b3000000000000000000000000d37bbe5744d730a1d98d8dc97c42f0ca46ad714600000000000000000000000000000000000000000000000000000000773594000",
      "nonce": 42,
      "chainId": 1,
      "gasLimit": "60000",
      "maxFeePerGas": "50000000000",
      "maxPriorityFeePerGas": "2000000000"
    },
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "to": "0xD37BbE5744D730a1d98d8DC97c42F0Ca46aD7146",
      "value": "0x0",
      "data": "0x44bc937b...",
      "nonce": 43,
      "chainId": 1,
      "gasLimit": "180000",
      "maxFeePerGas": "50000000000",
      "maxPriorityFeePerGas": "2000000000"
    }
  ]
}

Key Features

Multiple Transactions: ERC20 swaps require approval + deposit transactions
USDT Special Case: Allowance reset to 0 before setting new amount
Nonce Sequencing: Sequential nonce for each transaction in array
EIP-1559: Supports both legacy (gasPrice) and EIP-1559 (maxFeePerGas) formats
Router Contracts: THORChain/MAYA use depositWithExpiry function
Direct Transfers: Chainflip and NEAR use simple transfers to deposit addresses

QR Code Enrichment (Chainflip & NEAR)

When the selected protocol is chainflip or near, the deposit response is automatically enriched with a deposit_address, payment_uri, and qr_url. These allow users to complete swaps by scanning a QR code from any wallet app.

{
  "type": "EVM",
  "protocol": "chainflip",
  "quote_id": "01936b4a-...",
  "details": { ... },
  "unsigned_transactions": [ ... ],
  "deposit_address": "0x8a3c1f...",
  "payment_uri": "ethereum:0x8a3c1f...@1?value=500000000000000000",
  "qr_url": "https://cdn.leokit.dev/qr/01936b4a-....png"
}

Field	Type	Description
`deposit_address`	string	The generated deposit address (Chainflip channel or NEAR)
`payment_uri`	string	Chain-specific payment URI (BIP-21, EIP-681, Solana Pay, etc.)
`qr_url`	string	CDN URL of a QR code PNG encoding the `payment_uri`

These fields are only present for chainflip and near protocols. Other protocols (thorchain, relay, etc.) do not include them.

NEAR Protocol

Native NEAR Transfer

{
  "type": "NEAR",
  "protocol": "near",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "alice.near",
    "to_address": "bob.near",
    "from_asset": "NEAR.NEAR",
    "to_asset": "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amount": "5000000000000000000000000",
    "decimals": 24
  },
  "unsigned_transaction": {
    "receiverId": "swap.1click.near",
    "actions": [
      {
        "type": "Transfer",
        "params": {
          "deposit": "5000000000000000000000000"
        }
      }
    ]
  }
}

NEP-141 Token Transfer

{
  "type": "NEAR",
  "protocol": "near",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "alice.near",
    "to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "from_asset": "NEAR.USDC-a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.factory.bridge.near",
    "to_asset": "ETH.ETH",
    "amount": "2000000000",
    "decimals": 6
  },
  "unsigned_transaction": {
    "receiverId": "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.factory.bridge.near",
    "actions": [
      {
        "type": "FunctionCall",
        "params": {
          "methodName": "ft_transfer",
          "args": {
            "receiver_id": "swap.1click.near",
            "amount": "2000000000",
            "memo": null
          },
          "gas": "30000000000000",
          "deposit": "1"
        }
      }
    ]
  }
}

Key Features

YoctoNEAR: All amounts in yoctoNEAR (10^24 for native NEAR)
Fixed Gas: 30 TGas for ft_transfer calls
Attached Deposit: 1 yoctoNEAR required for token transfers
Contract Parsing: Extracts contract address from asset format

Cosmos Chains

Supported Chains: Cosmos Hub, Kujira, THORChain (native RUNE)

MsgSend (Standard Cosmos Transfer)

{
  "type": "COSMOS",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "cosmos1xyz...",
    "to_address": "thor1abc...",
    "from_asset": "GAIA.ATOM",
    "to_asset": "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amount": "1000000",
    "decimals": 6,
    "memo": "=:ETH.USDC:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  },
  "unsigned_transaction": {
    "msgs": [
      {
        "typeUrl": "/cosmos.bank.v1beta1.MsgSend",
        "value": {
          "fromAddress": "cosmos1xyz...",
          "toAddress": "cosmos1depositaddress...",
          "amount": [
            {
              "denom": "uatom",
              "amount": "1000000"
            }
          ]
        }
      }
    ],
    "fee": {
      "gas": "200000",
      "amount": [
        {
          "denom": "uatom",
          "amount": "5000"
        }
      ]
    },
    "memo": "=:ETH.USDC:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "chainId": "cosmoshub-4",
    "accountNumber": 12345,
    "sequence": 67
  }
}

MsgDeposit (THOR.RUNE Native Swaps)

{
  "type": "COSMOS",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "thor1abc...",
    "to_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "from_asset": "THOR.RUNE",
    "to_asset": "BTC.BTC",
    "amount": "100000000",
    "decimals": 8,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "unsigned_transaction": {
    "msgs": [
      {
        "typeUrl": "/types.MsgDeposit",
        "value": {
          "coins": [
            {
              "asset": "THOR.RUNE",
              "amount": "100000000"
            }
          ],
          "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
          "signer": "thor1abc..."
        }
      }
    ],
    "fee": {
      "gas": "250000",
      "amount": [
        {
          "denom": "rune",
          "amount": "2000000"
        }
      ]
    },
    "chainId": "thorchain-mainnet-v1",
    "accountNumber": 12345,
    "sequence": 67
  }
}

Key Features

Gas Simulation: Real-time estimation with 30% buffer
Dynamic Fees: Based on recommended_gas_rate from inbound_addresses API
Account Lookup: Fetches sequence and account number automatically
Fixed RUNE Fee: 0.02 RUNE for THORChain transactions

Other Ecosystems

TRON

{
  "type": "TRON",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "TXyz123...",
    "to_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "from_asset": "TRON.TRX",
    "to_asset": "BTC.BTC",
    "amount": "1000000",
    "decimals": 6,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "unsigned_transaction": {
    "raw_data": {...},
    "raw_data_hex": "0a02...",
    "txID": "abc123..."
  }
}

Cardano

{
  "type": "CARDANO",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "addr1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh...",
    "to_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "from_asset": "CARDANO.ADA",
    "to_asset": "BTC.BTC",
    "amount": "1000000",
    "decimals": 6,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "unsigned_transaction": {
    "cbor_hex": "84a40081..."
  }
}

XRP

{
  "type": "XRP",
  "protocol": "thorchain",
  "quote_id": "01936b4a-7c8e-7890-abcd-ef1234567890",
  "details": {
    "from_address": "rXyz123...",
    "to_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "from_asset": "XRP.XRP",
    "to_asset": "BTC.BTC",
    "amount": "1000000",
    "decimals": 6,
    "memo": "=:BTC.BTC:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "unsigned_transaction": {
    "tx_blob": "120000228000000024...",
    "hash": "ABC123..."
  }
}

Core Endpoints

Endpoint Details

Explorer API

POST /leokit/deposit

Request Body

Validation Rules

Response Formats by Ecosystem

UTXO Chains (Bitcoin, Litecoin, Dogecoin, Dash)

PSBT Format (BTC, LTC, DOGE)

Raw Transaction Format (DASH)

Key Features

Memo Length Limits

EVM Chains (Ethereum, BSC, Arbitrum, etc.)

Native Token Transfer (ETH, BNB, etc.)

ERC20 Token Transfer with Approval

Key Features

QR Code Enrichment (Chainflip & NEAR)

NEAR Protocol

Native NEAR Transfer

NEP-141 Token Transfer

Key Features

Cosmos Chains

MsgSend (Standard Cosmos Transfer)

MsgDeposit (THOR.RUNE Native Swaps)

Key Features

Other Ecosystems

TRON

Cardano

XRP

​POST /leokit/deposit

​Request Body

​Validation Rules

​Response Formats by Ecosystem

​UTXO Chains (Bitcoin, Litecoin, Dogecoin, Dash)

​PSBT Format (BTC, LTC, DOGE)

​Raw Transaction Format (DASH)

​Key Features

​Memo Length Limits

​EVM Chains (Ethereum, BSC, Arbitrum, etc.)

​Native Token Transfer (ETH, BNB, etc.)

​ERC20 Token Transfer with Approval

​Key Features

​QR Code Enrichment (Chainflip & NEAR)

​NEAR Protocol

​Native NEAR Transfer

​NEP-141 Token Transfer

​Key Features

​Cosmos Chains

​MsgSend (Standard Cosmos Transfer)

​MsgDeposit (THOR.RUNE Native Swaps)

​Key Features

​Other Ecosystems

​TRON

​Cardano

​XRP

POST /leokit/deposit

Request Body

Validation Rules

Response Formats by Ecosystem

UTXO Chains (Bitcoin, Litecoin, Dogecoin, Dash)

PSBT Format (BTC, LTC, DOGE)

Raw Transaction Format (DASH)

Key Features

Memo Length Limits

EVM Chains (Ethereum, BSC, Arbitrum, etc.)

Native Token Transfer (ETH, BNB, etc.)

ERC20 Token Transfer with Approval

Key Features

QR Code Enrichment (Chainflip & NEAR)

NEAR Protocol

Native NEAR Transfer

NEP-141 Token Transfer

Key Features

Cosmos Chains

MsgSend (Standard Cosmos Transfer)

MsgDeposit (THOR.RUNE Native Swaps)

Key Features

Other Ecosystems

TRON

Cardano

XRP