Module: Coincap::Markets

Defined in:
lib/coincap/markets.rb

Overview

Take a closer look into exchanges with the /markets endpoint. Similar to the /exchanges endpoint, we strive to offer transparency into how real-time our data is with a key identifying when the market was last updated. For a historical view on how a market has performed, see the /candles endpoint. All market data represents actual trades processed, orders on an exchange are not represented. Data received from individual markets is used to calculate the current price of an asset.

Constant Summary collapse

URI_API = 
'https://api.coincap.io/v2/markets'

Class Method Summary collapse

Class Method Details

.list(**options) ⇒ String

Returns a list of all markets.

{
  "data": [
    {
      "exchangeId": "bitstamp",
      "rank": "1",
      "baseSymbol": "BTC",
      "baseId": "bitcoin",
      "quoteSymbol": "USD",
      "quoteId": "united-states-dollar",
      "priceQuote": "6927.3300000000000000",
      "priceUsd": "6927.3300000000000000",
      "volumeUsd24Hr": "43341291.9576547008000000",
      "percentExchangeVolume": "67.2199253376108585",
      "tradesCount24Hr": "420721",
      "updated": 1533581033590
    },
  ...
  ],
  "timestamp": 1533581173350
}

Parameters:

  • exchange_id (String) —

    (nil) Search by exchange id (e.g. ‘binance’)

  • base_symbol (String) —

    (nil) Returns all containing the base symbol

  • quote_symbol (String) —

    (nil) Returns all containing the quote symbol

  • base_id (String) —

    (nil) Returns all containing the base id

  • quote_id (String) —

    (nil) Returns all containing the quote id

  • asset_symbol (String) —

    (nil) Returns all assets containing symbol (base and quote)

  • asset_id (String) —

    (nil) Returns all assets containing id (base and quote)

  • limit (Integer) —

    (nil) Max limit of 2000

  • offset (Integer) —

    (nil) The number of results to skip

Returns:

  • (String) 


48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/coincap/markets.rb', line 48

def self.list(**options)
  Helper.request_to_read_data(URI_API,
                              'exchangeId': options[:exchange_id],
                              'baseSymbol': options[:base_symbol],
                              'quoteSymbol': options[:quote_symbol],
                              'baseId': options[:base_id],
                              'quoteId': options[:quote_id],
                              'assetSymbol': options[:asset_symbol],
                              'assetId': options[:asset_id],
                              'limit': options[:limit],
                              'offset': options[:offset])
end