Guides
Guides

Get withdraw history [Private]

Get a list of client's withdrawals. Returns a list of withdrawal objects, newest first, 100 withdrawals maximum, but not more than specified by the limit parameter.

📘

To call any private endpoint, headers should include authorization key(s).

You may use a single API key or a public-private key pair based on your current tasks. Here you may find typical Header configurations for both options.

Method name:/v4/withdraw/private/history
Request type:GET

Data dictionary

NameTypeParameter typeRequiredRangeDescription
currencystringQUERYNO-Cryptocurrency code. All available cryptocurrency assets are available through "Get information about available currencies" endpoint.
statusenumQUERYNOCreated, Canceled, PartiallyProcessed, Processing, Processed, WaitForConfirmation, Pending,, AmlCheckingFilter by status.
dateFromstringQUERYNO-Show transactions after a specified date (ISO format).
dateTostringQUERYNO-Show transactions until a specified date (ISO format).
sortFieldenumQUERYNOamount, createdAtamount - sorting by amount; createdAt - sorting by date.
sortOrderenumQUERYNOasc, descSort the resulting list newest-on-top (desc) or oldest-on-top (asc). Parameter sort defaults to desc if not provided.
takeintQUERYNO1 - 100Select the number of transactions. The default return is 20 transactions.
skipintQUERYNO1 - ...Select the number of transactions to skip. The default is 0 transactions to skip.

📘

take and skip fields:

The maximum number of transactions you can get at one time is 100. If you have more than 100 transactions, you need to use the take and skip fields.

For example, you have 300 transactions:

  • at the first call, we get the first 100 transactions: /v4/withdraw/private/history?currency=USDT&take=100&skip=0;
  • to get the second array of the next 100 transactions: /v4/withdraw/private/history?currency=USDT&take=100&skip=100;
  • to get the third array of 100 transactions: /v4/withdraw/private/history?currency=USDT&take=100&skip=200.

Exemplary request

Example pathDescription
/v4/withdraw/private/history?status=Processed&take=10Returns the last 10 successful transactions.
/v4/withdraw/private/history?currency=XRP&take=10Returns the last 10 XRP transactions with all statuses.
/v4/withdraw/private/history?currency=USDT&status=Processed&dateFrom=2023-06-01T00%3A00%3A00.000Z&dateTo=2023-06-10T00%3A00%3A00.000Z&sortField=amount&sortOrder=ascReturns successful transactions from 01.06.2023 to 10.06.2023 sorted by amount from less to more.
const apiKey = "YOUR_API_KEY"; // put here your Api key

const url = "https://api.kuna.io";
const path = "/v4/withdraw/private/history?status=Processed&take=10";
const options = {
  method: "GET",
  headers: {
    accept: "application/json",
    "Content-Type": "application/json",
    "api-key": apiKey,
  },
};

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

import requests

api_key = "YOUR_API_KEY"  # put here your Api key

url = "https://api.kuna.io"
path = "/v4/withdraw/private/history?status=Processed&take=10"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "api-key": api_key,
}

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

How to call private endpoints here

Swagger here

Response

[
    {
      "id": "e9aa15b8-9c19-42eb-800a-026a7a153990",                                 // Unique identifier of withdrawal
      "amount": "10.75",                                                            // Amount deducted from your account
      "asset": "USDT",                                                              // Withdrawal currency
      "merchantId": "16214228-5c0c-5abc-be6a-c90259b21d4e",                         // Internal ID (not for use)
      "paymentCode": "TRX",                                                         // Blockchain name
      "status": "Processed",                                                        // Withdrawal status
      "type": "Withdraw",                                                           // Transaction type
      "reason": [],                                                                 // Reason for manual transaction processing
      "address": "TL3CWAwviQQYSnzHT4RotCWYnarnunQM46",                              // Withdrawal address
      "memo": "",                                                                   // Withdrawal memo
      "txId": "5ecc4e559b528c57be6723ac960a38211fbd3101ef4b59008452b3bd88c84621",   // Withdrawal transaction hash
      "fee": "0.75",                                                                // Withdrawal fee
      "processedAmount": "10",                                                      // Withdrawal amount
      "createdAt": "2023-06-09T11:33:02.383Z",                                      // Withdrawal creation date
      "updatedAt": "2023-06-09T11:34:25.317Z"                                       // Date of final withdrawal status
    },
    {
      "id": "a1c2687e-4df1-4496-8739-343ce8b95b14",
      "amount": "19.75",
      "asset": "USDT",
      "merchantId": "16214228-5c0c-5abc-be6a-c90259b21d4e",
      "paymentCode": "TRX",
      "status": "Processed",
      "type": "Withdraw",
      "reason": [],
      "address": "TL3CWAwviQQYSnzHT4RotCWYnarnunQM46",
      "memo": "",
      "txId": "f654e27a2d99425a631be884b1e2fcca0b68573c068c5d32946b7a8ab4567b6d",
      "fee": "0.75",
      "processedAmount": "19",
      "createdAt": "2023-06-08T11:53:11.530Z",
      "updatedAt": "2023-06-08T11:54:30.649Z"
    }
]

Updated over 1 year ago