Flex Transfer

POST

https://api.kucoin.com/api/v3/accounts/universal-transfer

api-channel:Private

api-permission:FlexTransfers

api-rate-limit-pool:Management

sdk-service:Account

sdk-sub-service:Transfer

sdk-method-name:flexTransfer

api-rate-limit-weight:4

Description

This interface can be used for transfers between master- and sub-accounts and transfers

The API Key needs universal transfer permission when calling.

It supports transfers between master account and sub-accounts, and also supports transfers between different types of accounts.

It supports transfer between master account and sub-accounts (only applicable to master account APIKey).

MARGIN_V2 only supports internal transfers between MARGIN and does not support transfers between master- and sub-accounts.

ISOLATED_V2 only supports internal transfers between ISOLATED and does not support transfers between master- and sub-accounts.

Request

Body Params application/json

Example

//transfer from master-account to sub-account
{
  "clientOid": "64ccc0f164781800010d8c09",
  "type": "PARENT_TO_SUB",
  "currency": "USDT",
  "amount": "0.01",
  "fromAccountType": "TRADE",
  "toUserId": "63743f07e0c5230001761d08",
  "toAccountType": "TRADE"
}

//transfer from sub-account to master-account
// {
//   "clientOid": "64ccc0f164781800010d8c09",
//   "type": "SUB_TO_PARENT",
//   "currency": "BTC",
//   "amount": 1,
//   "fromUserId": "62f5f5d4d72aaf000122707e",
//   "fromAccountType": "TRADE",
//   "toAccountType": "CONTRACT"
// }

// internal transfer
// {
//   "clientOid": "53666633336123",
//   "type": "INTERNAL",
//   "currency": "BTC",
//   "amount": 0.0003,
//   "fromAccountType": "TRADE",
//   "toAccountType": "MAIN"
// }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kucoin.com/api/v3/accounts/universal-transfer' \
--header 'Content-Type: application/json' \
--data-raw '//transfer from master-account to sub-account
{
  "clientOid": "64ccc0f164781800010d8c09",
  "type": "PARENT_TO_SUB",
  "currency": "USDT",
  "amount": "0.01",
  "fromAccountType": "TRADE",
  "toUserId": "63743f07e0c5230001761d08",
  "toAccountType": "TRADE"
}

//transfer from sub-account to master-account
// {
//   "clientOid": "64ccc0f164781800010d8c09",
//   "type": "SUB_TO_PARENT",
//   "currency": "BTC",
//   "amount": 1,
//   "fromUserId": "62f5f5d4d72aaf000122707e",
//   "fromAccountType": "TRADE",
//   "toAccountType": "CONTRACT"
// }

// internal transfer
// {
//   "clientOid": "53666633336123",
//   "type": "INTERNAL",
//   "currency": "BTC",
//   "amount": 0.0003,
//   "fromAccountType": "TRADE",
//   "toAccountType": "MAIN"
// }'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "orderId": "6705f7248c6954000733ecac"
    }
}

Modified at 2025-11-10 09:13:58

Get Transfer Quotas

Get Basic Fee - Spot/Margin