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.
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: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, 1970Example values:
1341090000000- Sun Jul 01 2012 00:00:00 GMT+0300
1440840720000- Sat Aug 29 2015 12:32:00 GMT+0300