General information

Method's parameters are expected in GET or POST format (depending on type of the method). All responses from the server are received in JSON format.

In case of successful execution you receive the following response:

{"success":true,{<response>}}

Response in case of an error:

{"success":false,{<error>}}

Authorization

Some of the services are available without authorization but most of the services require an API key and digital signature for the data transmitted in queries. The API key and signature should be sent as HTTP headers "Api-key" and "Sign".

A signature is a HMAC-SHA256 encoded message. The HMAC-SHA256 code must be generated using a secret key that was generated with your API key. Generated signatures must be converted into hexadecimal format and uppercase characters.

Important (!) To build a string for a signature, parameters should be concatenated in strict alphabetical order of the parameter names. Otherwise the e-signature verification process will fail.

Restrictions

Please, note, there are limitations for API requests as follows:
1. Only 60 requests to API are allowed over a period of 60 seconds from one IP address.
2. Only 10 simultaneous requests to API for opening/cancelling orders are allowed.

Points system is applied when using API. You start with 0 points. Opening a new order or cancelling an existing one adds 1 point to your score. Maximum 10 points is allowed, at 11 points your API will be locked for 2 seconds to allow the counter to drop to 10 points. Every 2 seconds your counter drops by 1 point.

If you exceed the limit of 10 points and do not send any new requests, the counter will drop to 0 within 10 seconds.

If your IP exceeds the limit of 60 requests per 60 seconds, it will be blocked for 20 minutes. Both private and public requests are counted. IP will be automatically unlocked after 20 minutes.

API Error codes

Error code

Description

1

Unknown error

2

System error

10

Authentication error

11

Authentication is required

12

Authentication failed

20

Signature incorrect

30

Access denied

31

API disabled

32

API restricted by IP

100

Incorrect parameters

101

Incorrect API key

102

Incorrect User ID

103

Incorrect currency

104

Incorrect amount

150

Unable to block funds

Input and output data formats

Boolean

Possible values:

true

,

false

Integer

Example values:

12

,

10

,

100

BigDecimal, Long

Example values:

12

,

10.32

,

0.000022

String

Just a string :)

Unix Time

In our API it's defined as the number of milliseconds (or seconds multiplied by a thousand) that have passed since 00:00:00 UTC January 1, 1970 Example values: