Koinju Data API v.1
Search…
⌃K

Market pair candle

Candles (also called OHLCV) are a summary, on a specific time frame, of a market (specific to an exchange).

candle list

Get the latest candles of a time frame from the current timestamp or the one you specify. The list is ordered from the latest to the oldest candle.
https://api.koinju.io/candles/:exchange/:market/:time_frame/:timestamp

Path parameters

Parameter
Format
Description
exchange
(required)
string
The name of the exchange of which you wish to get the candle. The exchange list can be found here https://api.koinju.io/exchanges
market
(required)
string
The name of the market of which you wish to get the market list. The market list of a specific exchange can be found here https://api.koinju.io/markets
time_frame
(optional)
string
Time frame of the candles chosen between all available : '15s', '1m', '5m', '15m', '30m', '1h', '2h', '4h', '8h', '1d'. Default is '15s'
timestamp
(optional)
number
Unix timestamp (in nanoseconds) from which you want the candles. Default is the current timestamp.

Output format 🧬

Variable
Format
Description
count
number
The number of tickers.
payload
object
The list of ticker objects.
payload variables
Variable
Format
Description
exchange
string
Exchange name.
market
string
Market name.
time_frame
string
Timeframe name.
open
string
First price value registered within the timeframe.
high
string
Highest price value registered within the timeframe.
low
string
Lowest price value registered within the timeframe.
close
string
Last price value registered within the timeframe.
vwap
object
Volume weighed average price value.
twap
object
Time weighted average price value.
timestamp
number
Timestamp of the candle.
volume
string
Total volume exchange within the timeframe.
number_of_trades
number
Number of trades within the timeframe.
twap variables
Variable
Format
Description
multiplier
string
Sum of the prices of every trade multiplied by the number of occurrences in the timeframe.
evaluated_segments
string
Number of occurrences in the timeframe.
twap
string
Time weighted average price.
vwap variables
Variable
Format
Description
multiplier
string
Sum of prices multiplied by the volume of every trade.
divider
string
Sum of the volumes of every trade.
vwap
string
Volume weighted average price.

Example of reply

200 : OK
Server is happy to server you :-)
Here is you example :
{
"count": 2,
"payload": [
{
"exchange": "kraken",
"market": "BTC-USD",
"time_frame": "1d",
"open": "10676.40000",
"close": "10799.00000",
"low": "10632",
"high": "10799",
"vwap": {
"multiplier": "24371541.001814825",
"divider": "2273.92917894",
"vwap": "10717.81004770592884100651"
},
"twap": {
"multiplier": "128504.95",
"evaluated_segment": "12",
"twap": "10708.74583333333333333333"
},
"timestamp": 1601856000000000000,
"volume": "2273.92917894",
"number_of_trades": "9493",
"hash": "167f72fa4d8a76b07fb07b632eea79261fed885e"
},
{
"exchange": "kraken",
"market": "BTC-USD",
"time_frame": "1d",
"open": "10553.00000",
"close": "10676.40000",
"low": "10531.2",
"high": "10690",
"vwap": {
"multiplier": "13111377.867515379",
"divider": "1234.25174381",
"vwap": "10622.93647407942162087404"
},
"twap": {
"multiplier": "127315.15",
"evaluated_segment": "12",
"twap": "10609.59583333333333333333"
},
"timestamp": 1601769600000000000,
"volume": "1234.25174381",
"number_of_trades": "5796",
"hash": "a98a830acc8dcec71a2b4aa7c07f5fcc064638e8"
}
]
}