Single crypto aggregated ticker

latest ticker of a cryptocurrency

This endpoint allows you to obtain the list of all tickers available for every cryptocurrencies 🤖

https://api.koinju.io/tickers/cryptos/:timeframe/:id

Path parameters

Parameter

Format

Description

id (required)

string

ID of the crypto on which you wish to get details. The IDs can be found here https://api.koinju.io/cryptos

timeframe

string

Timeframe name (15s or 1d, default is 15s)

Output format 🧬

Variable

Format

Description

count

number

The number of tickers.

payload

object

The list of ticker objects.

payload variables

Variable

Format

Description

id

string

ID of the cryptocurrency.

base

string

Symbol of the cryptocurrency.

quote

string

Currency in which calculated values are expressed.

timeframe

string

Timeframe name.

price

object

Average price value of the cryptocurrency in the last 24 hours.

volume

object

Total volume exchanged in the last 24 hours.

marketCap

object

Market cap of the cryptocurrency.

markets

object

List of the markets considered in the ticker calculation.

chart

string

Link to the price variation chart of the cryptocurrency.

timestamp

number

Timestamp of the ticker.

hash

string

Hash of the ticker.

price variables

Variable

Format

Description

value

string

Average price of the cryptocurrency.

vwap

string

Volume weighted average price of the cryptocurrency.

twap

string

Time weighted average price of the cryptocurrency.

change_1h

string

Variation between the current price and the price from 1 hour ago.

change_24h

string

Variation between the current price and the price from 24 hours ago

percent_change_1h

string

Percentage of the variation between the current price and the price from 1 hour ago.

percent_change_24h

string

Percentage of the variation between the current price and the price from 24 hours ago.

volume variables

Variable

Format

Description

value

string

Volume exchanged within the last 24 hours.

change_1h

string

Variation between the current volume and the volume from 1 hour ago.

change_24h

string

Variation between the current volume and the volume from 24 hours ago

percent_change_1h

string

Percentage of the variation between the current volume and the volume from 1 hour ago.

percent_change_24h

string

Percentage of the variation between the current volume and the volume from 24 hours ago.

marketCap variables

Variable

Format

Description

value

string

Market cap value.

change_1h

string

Variation between the current market cap and the market cap from 1 hour ago.

change_24h

string

Variation between the current market cap and the market cap from 24 hours ago

percent_change_1h

string

Percentage of the variation between the current market cap and the market cap from 1 hour ago.

percent_change_24h

string

Percentage of the variation between the current market cap and the market cap from 24 hours ago.

markets variables

Variable

Format

Description

list

object

List of the markets, grouped by exchange, considered in the calculations.

number_of_trades

object

Number of trades considered in the calculations.

number_of_trades variables

Variable

Format

Description

value

string

Number of trades considered in the calculations.

change_1h

string

Variation between the current number of trades and the number of trades from 1 hour ago.

change_24h

string

Variation between the current number of trades and the number of trades from 24 hours ago

percent_change_1h

string

Percentage of the variation between the current number of trades and the number of trades from 1 hour ago.

percent_change_24h

string

Percentage of the variation between the current number of trades and the number of trades from 24 hours ago.

Example of reply

200 : OK, Server is happy to server you :-)

Here is you example :

{
"count": 1,
"payload": [
{
"id": "btc-bitcoin",
"base": "BTC",
"quote": "USD",
"timestamp": 1602000435000000000,
"timeframe": "15s",
"price": {
"value": "10580.19006042600670943927",
"vwap": "10580.19006042600670943927",
"twap": "10629.92046917268345116529",
"change_1h": "-200.83846019869323350969",
"change_24H": "-108.41074476641213728996",
"percent_change_1h": "-1.862887755231128679",
"percent_change_24h": "-1.014265073065010029"
},
"volume": {
"value": "663647.45530816866110155477382278273596593374",
"change_1h": "-427831.50604414445633462261848573343118021026",
"change_24H": "487745.12285149473917135470860170438646788259",
"percent_change_1h": "-39.197412061344060295",
"percent_change_24h": "277.281782475300639188"
},
"marketCap": {
"value": "195719634908.52184520382371067776",
"change_1h": "-3715248013.61603",
"change_24H": "-2005456543.28149",
"percent_change_1h": "-1.862887755231121679",
"percent_change_24h": "-1.0142650730650095"
},
"markets": {
"list": {
"coinbase": [
"XRP-BTC",
"BTC-EUR",
"COMP-BTC",
"BTC-USD",
"NMR-BTC",
],
"bittrex": [
"ADT-BTC",
"ADA-BTC",
"RADS-BTC",
"ADX-BTC",
"AID-BTC",
],
},
"number_of_trades": {
"value": "1799",
"change_1h": "-1697",
"change_24H": "1171",
"percent_change_1h": "-48.541189931350114416",
"percent_change_24h": "186.464968152866242038"
}
},
"chart": "https://koinju-charts-preprod.s3.eu-west-1.amazonaws.com/btc-bitcoin.png",
"hash": "5ec685230812972df991ec5e7ebce37328349e35"
}
]
}