General information
API URL: https://api.livecoin.net/
The method parameters are in GET or POST format (depending on the method type).
All responses from the server are 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 services are available without authorization, but most require an API key and digital signature to sign the request data. The API key and signature are sent as HTTP headers "API-key" and "Sign".Signature is a HMAC-SHA256 encoded message. The HMAC-SHA256 code is 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 construct a signature string, parameters should be ordered alphabetically by initials of 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
All times in our API are UTC timestamps expressed as milliseconds (or seconds multiplied by 1000) 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