Guides

Pre-request for transfer [Private]

Transfer pre-request, to get restrictions and fees for transfer operations.

Suggest Edits
Method name:/v2/transfer/pre-request
Request type:POST

📘

To call private endpoints, you need to get a JWT token or an API key for authentication.

Here you can learn in detail how to successfully authenticate.

A pre-request for a transfer operation return fees values for that operation type as well as minimum and maximum possible transfer amount.

By default (if the walletType is not specified in the request), the response will return information that is relevant only for wallets of the Customer type. If you need to obtain fees and restrictions related to other wallet types (such as Institution or Wallet), you should include the walletType field in the request and specify the type of wallet for which the transaction is intended.

Data dictionary

NameTypeParameter typeRequiredRangeDescription
assetstringBODYYES-Asset(Currency) code, e.g. BTC - Bitcoin, ETH - Ethereum.

Exemplary request

const url = BASE_URL;
const path = "/v2/transfer/pre-request";

const body = { asset: "USDT" };

const options = {
  method: "POST",
  headers: {
    accept: "application/json",
    "Content-Type": "application/json",
    "Authorization": `Bearer ${data.accessToken}` // data.accessToken - generated a JWT token via /v2/auth/login.
  },
  body: JSON.stringify(body),
};

fetch(url + path, options)
  .then((response) => response.json())
  .then((showResponse) => console.log(showResponse.data));

import requests

url = BASE_URL
path = "/v2/transfer/pre-request"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": "Bearer " + data.accessToken # data.accessToken - generated a JWT token via /v2/auth/login.
}
body = { "asset": "USDT" }

request = requests.post(url + path, headers=headers, json=body)
print(request.json())

How to call private endpoints here

Swagger here

Response

{
  "data": {
    "feeFixed": "0.0",                   // Fixed Fee.
    "feeRate": "2.0",                    // Percentage fee.
    "feeStrategy": "internal",           // external - commission paid by customer; internal - commission paid by the merchant.
    "maxAmount": "99999999999999999",    // Maximum deposit amount.
    "minAmount": "0.000001"              // Minimum deposit amount.
  }
}

Updated about 2 months ago