Skip to main content

Crypto Withdrawal Addresses

List the whitelisted addresses that Crypto Withdrawals can send funds to.

info

Withdrawal addresses are added and removed only in the BtcTurk Global app, with two-factor authentication. The API lets you list and read them. Withdrawals can be sent only to addresses saved this way.

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​

NameTypeDescription
X-PCK*stringAPI public key.
X-Stamp*integerCurrent time in milliseconds since the Unix epoch (UTC).
X-Signature*stringHMAC-SHA256 signature. See Authentication V1.
X-NonceintegerOptional. Backward tolerance for X-Stamp in milliseconds. Default 5000, maximum 60000.

List Withdrawal Addresses​

GET /api/v1/crypto-withdrawal-addresses

Query Parameters​

NameTypeDescription
currencySymbolstringMax length 10. Filters by asset symbol.
cryptoChannelIdintegerid from Get Crypto Channels. Filters by network.
pageintegerPage number, starting at 1. Default 1.
pageSizeinteger1–100. Default 100.
orderBystringOnly Id is accepted (case-insensitive).
orderstringAsc or Desc.

Response is a raw JSON array.

[
{
"id": 5501,
"address": "bc1qxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"receiverName": "My Cold Wallet",
"currencySymbol": "BTC",
"tag": null,
"cryptoChannelId": 25
}
]

Get Withdrawal Address by Id​

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

{
"id": 5501,
"address": "bc1qxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"receiverName": "My Cold Wallet",
"currencySymbol": "BTC",
"tag": null,
"cryptoChannelId": 25
}

Code Example​

curl -X GET "https://api.global.btcturk.com/api/v1/crypto-withdrawal-addresses?currencySymbol=BTC"   -H "X-PCK: YOUR_API_PUBLIC_KEY"   -H "X-Stamp: 1735866257711"   -H "X-Signature: COMPUTED_SIGNATURE"