Koinju REST API 1.0 - Documentation

General description and contexte

General

RESTful endpoint provides the widest range of data, based on HTTP protocol which works in Request-Reply scheme.

Every message is returned in JSON.

Endpoint

Production base endpoint: https://api.koinju.io

Make sure there is no trailing / in any endpoint.

HTTP Success

Successful HTTP responses have the status code 200.

HTTP Errors

All HTTP requests with response status codes different to 200 must be considered as failed and you should expect additional JSON inside the body of the response with the error message encapsulated inside it as shown in the example. We use the following error codes:

Error Code	Meaning
400	Bad Request – There is something wrong with your request
404	Not found – The data you requested can't be found
500	Internal server error – There is something wrong on the server.

Standards & Conventions

Time

For all input and most of the output time values are Unix timestamps. For some of the output time values ISO 8601 standard is used.

Input time values must be formatted as a Unix timestamp in nanoseconds: 1582902030000000000

Output time values are formatted using the following pattern: yyyy-MM-ddTHH:mm:ss.fffffffZ

ISO 8601 standard format specifier	Description
yyyy	The year as a four-digit number.
MM	The month, from 01 through 12.
dd	The day of the month, from 01 through 31.
HH	The hour, using a 24-hour clock from 00 to 23.
mm	The minute, from 00 through 59.
ss	The second, from 00 through 59.
fffffff	The ten millionths of a second in a date and time value.