Koinju API 2.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.