General information

API URL: https://api.livecoin.net/

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.

Restrictions

Please, note, there are limitations for API requests as follows:

Scoring system is applied for trading API. You're allowed to make 1 call per second. Each new call to trading API will add 1 point to your allowed calls counter. Maximum allowed number is 40, after that your API key will be blocked for 80 seconds, then you can use API again. Your API counter drops by 1 every 2 second until it reaches 0.

The following API calls are counted in the scoring system:
GET /exchange/trades
GET /exchange/client_orders
GET /exchange/order
GET /exchange/commission
GET /exchange/commissionCommonInfo
POST /exchange/buylimit
POST /exchange/selllimit
POST /exchange/buymarket
POST /exchange/sellmarket
POST /exchange/cancellimit

For example, you can make 70 calls per minute to the trading API, because you're allowed to make 40 calls according to the limitations and your counter will drop by 30 scores for the next 60 seconds, thus you can make 40 initial calls and 30 additional calls.

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:

1341090000000

- Sun Jul 01 2012 00:00:00 GMT+0300

1440840720000

- Sat Aug 29 2015 12:32:00 GMT+0300