Market Quotes

Definition
Quotes consist of the best bid and the best ask for a market at a given point in time. The best bid represents the highest price that a buyer is willing to pay for one unit of the base asset for a spot market or one contract for a derivatives market. The best ask represents the lowest price that a seller is willing to sell. 
Details
Quotes data is derived from our order book snapshot data by extracting the best bid and best ask. We serve quotes data through a separate endpoint as a convenience for users. 
Coin Metrics stores two types of order book snapshots. One type consists of a snapshot of the top 100 bids and top 100 asks taken once every 10 seconds.  The second type consists of a full order book snapshot (every bid and every ask) taken once every hour. Quotes derived from both of these snapshots are served through our HTTP API endpoint /timeseries/market-quotes. 
Coin Metrics also serves quotes in real-time for major markets through our websocket API endpoint /timeseries-stream/market-quotes. 
For more information about our quotes data, please reference our market order book page. 
Example
An sample of the quotes data the coinbase-btc-usd-spot market from our /timeseries/market-quotes API endpoint is provided below.
1
{
2
  "data": [
3
    {
4
      "time": "2020-06-08T21:14:48.215145000Z",
5
      "market": "coinbase-btc-usd-spot",
6
      "coin_metrics_id": "1591479594286046-27326992",
7
      "ask_price": "9685.02",
8
      "ask_size": "0.04340557",
9
      "bid_price": "9685.01",
10
      "bid_size": "0.00484254"
11
    }
12
  ]
13
}
Copied!
market:  The id of the market. Market ids use the following naming convention: exchangeName-baseAsset-quoteAsset-spot for spot markets, exchangeName-futuresSymbol-future for futures markets, and exchangeName-optionsSymbol-option for options markets. 
​
time:  The exchange-reported time in ISO 8601 date-time format.

coin_metrics_id:   Unique identifier of the order snapshot.

ask_price:  The price of the ask on the order book in units of the quote currency.

ask_size: The size of the ask on the order book in units of the base asset for a spot market or number of contracts for a derivatives market.

bid_price:  The price of the bid on the order book in units of the quote currency.

bid_size: The size of the bid on the order book in units of the base asset for a spot market or number of contracts for a derivatives market.
Frequently Asked Questions 
Since our quotes data is derived from our order book data, please reference our market order book page for many frequently asked questions about order book data. 
Market Order Book
Release History
CM MDF v1.0 on April 2019: Quotes for major btc-usd and eth-usd markets. 

CM MDF v1.0 on July 30, 2019: Added support for websocket endpoint which serves quotes in real-time. 

​CM MDF v2.0 on December 9, 2019: Expanded coverage universe to include cex.io-btc-usd and  bitflyer-btc-spot.

​CM MDF v2.4 on September 1, 2021: Expanded our coverage universe to additional markets on Coinbase, Binance, FTX, Bitfinex, itBit.
Availability
The previous 24 hours of quotes data is available through our Community API.  Community data is available via HTTP API only and is limited to 1,000 API requests per 10 minutes per IP address. All of our order book data is available through our professional API with higher rate limits.  
Our coverage universe is expanding rapidly. Please contact us at [email protected] for the latest quotes coverage. 

Market Data - Previous

Market Order Book

Next - Market Data

Market Candles

Last modified 27d ago

Copy link

Contents

Definition

Details

Example

Frequently Asked Questions

Release History

Availability