The subscription shows the general setup and statistics of the market. It shows the value of the smallest transaction we can make and the precision of the amount, rate and price. The precision of the amount (amountPrecision) determines how accurately we can determine the quantity of the first currency to buy or sell, the precision of the price (pricePrecision) determines the number of decimal places to which the result of our transaction will be rounded or how accurately we can determine the quantity of the second currency, the precision of the rate (ratePrecision) determines the number of decimal places of the rate with which we want to place an offer. Rate precision can vary over time depending on the exchange rate for a particular currency market. The precisions of amount (amountPrecision) and price (pricePrecision) stay unchanged. The Ticker also returns the current best bid and ask, as well as the last and the previous transaction price.
If you want to get information from all markets just use path without market symbol:
"path": "ticker"
{
"action": "subscribe-public",
"module": "trading",
"path": "ticker/{market_code}"
}{
"action": "push",
"topic": "trading/ticker/eth-pln",
"message": {
"market": {
"code": "ETH-PLN",
"amountPrecision": 8,
"pricePrecision": 2,
"ratePrecision": 6,
"first": {
"currency": "ETH",
"minOffer": "0.00045",
"scale": 8 // DEPRECATED
},
"second": {
"currency": "PLN",
"minOffer": "5",
"scale": 2 // DEPRECATED
}
},
"time": "1576845911374",
"highestBid": "491.12",
"lowestAsk": "495",
"rate": "495",
"previousRate": "499.42"
},
"timestamp": "1576845911374",
"seqNo": 4317604
}{
"requestId": "78539fe0-e9b0-4e4e-8c86-70b36aa93d4f",
"action": "proxy",
"module": "trading",
"path": "ticker/{market_code}"
}{
"action": "proxy-response",
"requestId": "78539fe0-e9b0-4e4e-8c86-70b36aa93d4f",
"statusCode": 200,
"body": {
"status": "Ok",
"ticker": {
"market": {
"code": "ETH-PLN",
"amountPrecision": 8,
"pricePrecision": 2,
"ratePrecision": 6,
"first": {
"currency": "ETH",
"minOffer": "0.00045",
"scale": 8 // DEPRECATED
},
"second": {
"currency": "PLN",
"minOffer": "5",
"scale": 2 // DEPRECATED
}
},
"time": "1576846031093",
"highestBid": "491.44",
"lowestAsk": "495",
"rate": "495",
"previousRate": "499.42"
}
}
}Response details:
Key | Type | Description | |
|---|---|---|---|
ticker | array | ||
code | string | Currency pair for request. | |
amountPrecision | integer | Number of decimal places of the first currency. | |
pricePrecision | integer | Number of decimal places of the transaction price or second currency. | |
ratePrecision | integer | Number of decimal places of the rate. | |
first / second | array | Arrays of data from first and second currency pair. | |
| string | Currency symbol. | |
| decimal | Minimal value of currency that you could order. | |
| integer | Decimal precision. | This field will be removed in the future. |
time | Unix Timestamp | Time of execute on server. For this time all values are actual. | |
highestBid | decimal | The best price for buy order at the moment. | |
lowestAsk | decimal | The best price for sell order at the moment. | |
rate | decimal | Price of the last transaction. | |
previousRate | decimal | Price of the penultimate transaction. |