Get Crypto Transactions

Retrieve the confirmed crypto deposit/withdrawal ledger for the authenticated user.

warning

For all transactions related to the private endpoint, you must authorize before sending your request.

For more information you can check our Authentication V1 article. This endpoint requires the Account API key permission.

• Only entries with a Confirmed crypto status are returned, newest first, at most 200.
• If type is omitted, every type is returned, deposits and withdrawals included.
• The date range applies to each record's timestamp (its last update). With both dates, that range is used. With only endDate, the range is the 30 days before it. With only startDate, the range ends 30 days later or now, whichever is earlier. With neither, it is the last 30 days. startDate after endDate returns 400.

info

The startDate and endDate parameters must be Unix timestamps in milliseconds.

Crypto

GET /api/v1/users/transactions/crypto

Query Parameters

Name	Type	Description
type	array	deposit, withdrawal. When omitted, every type is returned.
symbol	array	Currency symbols, e.g. btc, usdt.
startDate	long	Unix time in milliseconds. Defaults to 30 days before endDate, or 30 days before now.
endDate	long	Unix time in milliseconds. Defaults to 30 days after startDate or now, whichever is earlier.

Headers

Name	Type	Description
X-PCK*	string	API public key.
X-Stamp*	integer	Current time in milliseconds since the Unix epoch (UTC).
X-Signature*	string	HMAC-SHA256 signature. See Authentication V1.
X-Nonce	integer	Optional. Backward tolerance for X-Stamp in milliseconds. Default 5000, maximum 60000.

200

{
  "success": true,
  "message": "SUCCESS",
  "code": 0,
  "data": [
    {
      "id": 48705286,
      "timestamp": 1648301802887,
      "amount": "0.5",
      "preciseAmount": 0.5,
      "fee": "0",
      "tax": "0",
      "balanceType": "deposit",
      "currencySymbol": "USDT",
      "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "tag": null,
      "txHash": "0xabc...",
      "confirmationCount": 12,
      "isConfirmed": true
    }
  ]
}

preciseAmount is the amount as a JSON number. confirmationCount is set for deposits and is null for withdrawals.

Code Example

curl

curl -X GET "https://api.global.btcturk.com/api/v1/users/transactions/crypto?type=deposit&symbol=usdt" \
  -H "X-PCK: YOUR_API_PUBLIC_KEY" \
  -H "X-Stamp: 1735866257711" \
  -H "X-Signature: COMPUTED_SIGNATURE"

C#

using var client = new HttpClient { BaseAddress = new Uri("https://api.global.btcturk.com") };
client.DefaultRequestHeaders.Add("X-PCK", apiKey);
client.DefaultRequestHeaders.Add("X-Stamp", stamp);
client.DefaultRequestHeaders.Add("X-Signature", signature);

var response = await client.GetAsync("/api/v1/users/transactions/crypto?type=deposit&symbol=usdt");
Console.WriteLine(await response.Content.ReadAsStringAsync());