---
title: "Create a blockchain transfer"
method: POST
path: "/open-api/v3/cryptoconnect/transfers"
tags: ["Blockchain Transfer"]
---

# Create a blockchain transfer

`POST /open-api/v3/cryptoconnect/transfers`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/cryptoconnect/transfers`
- Auth: API key in header `x-access-token`

A transfer can be made from an existing funded wallet to a blockchain address or another wallet.

## Headers

- `Idempotency-Key` string

## Request body

- CreationBlockchainTransferRequest
  - `referenceId` string, uuid, required
  - `accountId` string, uuid, required
  - `source` WalletSourceLocation, required: CryptoConnect wallet
    - `type` 'WALLET', required
    - `id` string, required: The id of the wallet.
  - `destination` BlockchainLocation, required: Blockchain wallet address
    - `type` 'BLOCKCHAIN', required
    - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'BTC' | 'ETH' | 'MATIC' | 'OP' | 'SOL' | 'TON' | 'TRX', required
    - `address` string, required: An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.
  - `amount` Money, required
    - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'WUSD', required
    - `amount` string, number, required: The transaction amount.

## Response `200`

The request has succeeded.

- object
  - `code` string, required: Code
  - `message` string, required: Message
  - `data` BlockchainTransfer, required
    - `id` string, uuid, required
    - `accountId` string, uuid, required
    - `referenceId` string, uuid, required
    - `source` union, required: A source of funds.
      - WalletSourceLocation: CryptoConnect wallet
        - `type` 'WALLET', required
        - `id` string, required: The id of the wallet.
      - BlockchainLocation: Blockchain wallet address
        - `type` 'BLOCKCHAIN', required
        - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'BTC' | 'ETH' | 'MATIC' | 'OP' | 'SOL' | 'TON' | 'TRX', required
        - `address` string, required: An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.
    - `destination` union, required: A blockchain address.
      - BlockchainLocation: Blockchain wallet address
        - `type` 'BLOCKCHAIN', required
        - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'BTC' | 'ETH' | 'MATIC' | 'OP' | 'SOL' | 'TON' | 'TRX', required
        - `address` string, required: An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.
      - WalletDestinationLocation: CryptoConnect wallet
        - `type` 'WALLET', required
        - `id` string, required: The id of the wallet.
        - `address` string, required: An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.
    - `amount` Money, required
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'WUSD', required
      - `amount` string, number, required: The transaction amount.
    - `fees` BlockchainTransferFee[], required: An array of fees applied to a transaction.
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'WUSD', required
      - `amount` string, number, required: The transaction amount.
      - `type` 'GAS' | 'CROSS_CHAIN' | 'SERVICE', required
    - `status` 'PENDING' | 'COMPLETE' | 'FAILED' | 'ONHOLD' | 'IN_PROGRESS' | 'REFUNDED', required
    - `transactionHash` string: A hash that uniquely identifies an on-chain transaction.
    - `riskLevel` 'LOW' | 'MIDDLE' | 'HIGH' | 'SEVERE': KYT risk level.
    - `createTime` string, timestamp, required: Timestamp.
    - `completeTime` string, timestamp, required: Timestamp.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `403`: Access is forbidden.
- `409`: The request conflicts with the current state of the server.

---

[API](https://skmtc.dev/interlace/apis/crypto-connect.md) - [All operations](https://skmtc.dev/interlace/apis/crypto-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/crypto-connect/revisions/9d40c2545370?raw)