Get Single Order

Get a single order by orderId.

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 Trade API key permission. The order must belong to the authenticated user, otherwise a 400 Bad Request (ORDER_NOT_FOUND) is returned.

Get Single Order

GET /api/v1/order/{orderId}

Path Parameters

Name	Type	Description
orderId*	long	orderId of the order

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: OK Success

{
  "success": true,
  "message": null,
  "code": 0,
  "data": {
    "id": 61912740,
    "price": "85400.00",
    "amount": "0.12345678",
    "quantity": "0.12345678",
    "stopPrice": "0",
    "pairSymbol": "BTCUSDT",
    "pairSymbolNormalized": "BTC_USDT",
    "type": "sell",
    "method": "limit",
    "orderClientId": "my-order-1",
    "time": 1647883449587,
    "updateTime": 1647883449587,
    "status": "Untouched",
    "leftAmount": "0.1234567800000000"
  }
}

400: Bad Request Order not found

{
  "success": false,
  "message": "ORDER_NOT_FOUND",
  "code": 1152
}

type and method are lowercase in every order endpoint: type is buy or sell, and method is limit or market. status is Untouched, Partial, Closed or Canceled.

Stop orders cannot be placed through the API, but orders you place on the BtcTurk Global website can be stop orders: their method is stoplimit or stopmarket and stopPrice is the trigger price. For other orders stopPrice is "0".

Code Example

curl

curl -X GET "https://api.global.btcturk.com/api/v1/order/61912740" \
  -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/order/61912740");
Console.WriteLine(await response.Content.ReadAsStringAsync());