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"
    }
  ]
}