Get User Trade Transactions

Retrieve trade (fill) history 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.

• If orderId is set, it must be sent alone — combining it with startDate, endDate, type, symbol or pairSymbol returns a validation error.
• You cannot combine symbol and pairSymbol in the same request.
• pairSymbol accepts BTCUSDT or BTC_USDT. An unknown pair returns 400 PAIR_NOT_FOUND_ERROR (1027).
• At most 200 trades are returned, newest first.
• 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.

info

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

Trade

GET /api/v1/users/transactions/trade

Query Parameters

Name	Type	Description
orderId	long	Optional. Cannot be combined with any other parameter below.
type	array	buy, sell (repeat the query param for multiple values)
symbol	array	Currency symbols, e.g. btc, try. Cannot be combined with pairSymbol.
pairSymbol	string	e.g. BTCUSDT or BTC_USDT. Cannot be combined with symbol.
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": "1181163798924649598",
      "timestamp": 1663848223334,
      "amount": "-0.3384",
      "preciseAmount": -0.3384081100000000,
      "fee": "-0.06297817",
      "tax": "-0.01133607",
      "price": "122.00",
      "numeratorSymbol": "ETHW",
      "denominatorSymbol": "TRY",
      "orderType": "sell",
      "role": "taker",
      "orderId": 10938696222,
      "orderClientId": null
    }
  ]
}

role is maker or taker; it is null when the role is not known.

Code Example

curl

curl -X GET "https://api.global.btcturk.com/api/v1/users/transactions/trade?type=buy&type=sell&symbol=btc&symbol=try" \
  -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/trade?type=buy&type=sell&symbol=btc&symbol=try");
Console.WriteLine(await response.Content.ReadAsStringAsync());

info

For crypto deposit/withdrawal ledger entries, see Get Crypto Transactions. BtcTurk Global API does not expose a fiat transactions endpoint.