Get Ticker

The method GET /ticker/ enables you to retrieve trading information from the specified book.

HTTP Request

Query Parameters

You can use the following query parameter in your request:

ParameterDescriptionRequired
bookSpecifies which book to use.Yes

JSON Response Payload

The endpoint returns a JSON object representing the trading information of the given book. This JSON object includes the following fields:

Field NameDescriptionTypeUnits
askThe lowest sell order.StringMinor/Major
bidThe highest buy order.StringMinor/Major
bookThe order book symbol.StringMajor_Minor
change_24The price variation during the last 24 hoursStringMinor/Major
created_atThe date and time when the service generated the ticker.StringISO 8601 timestamp
highThe last-24-hour price high.StringMinor/Major
lastThe last-traded price.StringMinor/Major
lowThe last-24-hour price low.StringMinor/Major
rolling_average_changeThe unweighted arithmetic average (mean) of the price change (percentage) during the previous six hours, also known as moving average change. A data point is obtained during six one-hour periods in the following way: The percentage of price change during h1 and h2 is p1, the one during h2 and h3 is p2, and so forth until the period between h6 and h7, which yields p6. The unweighted arithmetic average of these six readings is what the endpoint reports.Object
volumeThe last-24-hour volume.StringMajor
vwapThe last-24-hour-volume-weighted average price (vwap).StringMinor/Major

The following response object exemplifies the JSON object returned:

curl https://api-stage.bitso.com/api/v3/ticker?book=btc_mxn

{
            "high": "472472.82",
            "last": "372110.00",
            "created_at": "2023-03-09T20:58:23+00:00",
            "book": "btc_mxn",
            "volume": "112.81964756",
            "vwap": "388387.4631589659",
            "low": "10000.00",
            "ask": "372800.00",
            "bid": "372110.00",
            "change_24": "-25580.00",
            "rolling_average_change": {
                "6": "-0.5228"
            }
}