Crypto Deposit Addresses

List and inspect the crypto deposit addresses generated for your account.

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 Crypto Asset Withdrawal API key permission group.

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.

List Deposit Addresses

GET /api/v1/crypto-deposit-addresses

Query Parameters

Name	Type	Description
currencyChannelId*	long	id from Get Currency Channels (for example 43 for USDT on Tron).

Response is a raw JSON array (not wrapped in a data envelope).

Deposit addresses are created in the BtcTurk Global app. If the list is empty for a network, create the address in the app first.

200

[
  {
    "id": 1029384,
    "address": "bc1qxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "tag": null
  }
]

400: unknown channel

{
  "title": "Currency Channel Not Found",
  "type": "currency-channel-not-found",
  "status": 400,
  "detail": "Currency channel not found"
}

An unknown currencyChannelId returns 400 currency-channel-not-found.

Get Deposit Address by Id

GET /api/v1/crypto-deposit-addresses/{id}

Path Parameters

Name	Type	Description
id*	long	Deposit address id (must be > 0)

200

{
  "id": 1029384,
  "address": "bc1qxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "tag": null
}

404: not found

{
  "title": "Not Found",
  "type": "crypto-deposit-address-not-found",
  "status": 404,
  "detail": "Not found"
}

An address that exists but belongs to another account returns the same 404 as one that does not exist — the endpoint does not distinguish the two.

Code Example

curl

curl -X GET "https://api.global.btcturk.com/api/v1/crypto-deposit-addresses?currencyChannelId=2" \
  -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/crypto-deposit-addresses?currencyChannelId=2");
Console.WriteLine(await response.Content.ReadAsStringAsync());

info

currencyChannelId values come from the Currency Channels endpoint.