FAQ (Frequently Asked Questions)

White label exchange API Frequently Asked Questions

The documentation for frequently asked questions of BTCTrader's white label exchange platform API.

Why do I receive 401 - Unauthorized error

You need to authorize before sending your request on all user related operations like buy/sell/cancel orders, user balances, open orders etc.

Please check and confirm that you've created the API key from PRO website. Also, check the API Key's permissions. If you don't have the necessary permissions, your requests will be unauthorized. Also if you had limited API with an IP address and your server has a different address, your API requests won't be authorized.

401 Unauthorized - Invalid Signature

You might compute a wrong signature. You might not set the signature in the headers. You might use this signature before so the time is changed and therefore you cannot use it anymore. Please check your public/private keys are correct. You may need to encode the key as UTF-8 in some languages.

401 Unauthorized - Unauthorized - Headers are missing

Your request does not have requested headers.

401 Unauthorized - Invalid Request

Your current account could be unverified yet you should contact support. Your private key (API Secret) might be wrong. Please check your private key is correct. You may need to decode the key as base64 in some languages.

401 Unauthorized - Invalid Nonce

Nonce should not be different than the current timestamp we are giving a tolerance ±5 seconds.

Please check your server's timezone and timestamp output. It should be in milliseconds format and you need to declare your server's timezone to match UTC.

You can check the server time from here.

In addition, this error can be received in visual studio 2015 versions.

Why do I receive Invalid nonce error

Nonce is a regular integer number. It must be Unix Timestamp in milliseconds format. We do have a 5 seconds tolerance in timestamps within the requests but your server’s current time must be synced with the API server time which is in milliseconds format. Our servers are using UTC timezone.

You can check the server time from here.

Why do I receive 502 - Not enough balance error

For TRY pairs, you need to calculate the commission and deduct from the total amount. For example, if you would like to order 1.00000000 BTC for 50,000TRY, your free balance must be at least 50,090TRY (Maker/Taker commissions are being calculated after your order executed. If your order matches immediately you'll be charged as Taker. Otherwise, you'll be charged as Maker and the commission difference will be added to your balance)

Why do I receive 429 - Too many requests

This means you exceeded the rate limit. Refer to Rate Limits section. Also please check the Retry-After response HTTP header. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After It indicates how long the user agent should wait before making a follow-up request.

What is the difference between API versions and which one is suitable for me

There are two versions V1 and V2.

  • V1 is used for all authentication required requests like checking balances, listing open orders, creating or canceling orders etc. with HMAC authentication.

  • V2 is used for all public requests like ticker, OHLC (open, high, low, close) data, orderbook etc.

If you would like to request a data, related to your user account, you should use V1 with HMAC authentication. All public data is being served on V2.

How to connect to WebSocket channels?

You can connect with HMAC Authentication. For more information, you can view our article by clicking here.

How are rate limits set?

Rate limits for private endpoints are account based. For public endpoints, rate limits are per ip.

For more information, you can view rate limit article by clicking here.

What is the location of your data centers?

BtcTurk data centers are located in Azure West Europe.

You can follow the updates on this page.

What are commission rates?

You can view up-to-date commission information on this page.

What is the minimum transaction limit?

You can check the minimum transaction limits on our exchangeInfo endpoint. Minimum transaction limits can be displayed with the "minExchangeValue" parameter. You can click here for more information.

What is the meaning of hasFraction field in ExchangeInfo endpoint?

The denominatorScale parameter describes how many characters the precision is. If hasFraction is false you shouldn't care denominatorScale, this override it. If true you should care denominatorScale and you can write just denominatorScale lenght.

Have more questions

If you have more questions please feel free to send your questions to issues section.

Last updated