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 usually 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

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