CoinMarketCap JSON API Documentation

Version 1

Public API Methods

Ticker

  • Endpoint: /ticker/
  • Method: GET
  • Optional parameters:
    • (int) limit - only returns the top limit results.
  • Example: https://api.coinmarketcap.com/v1/ticker/
  • Example: https://api.coinmarketcap.com/v1/ticker?limit=10
  • Sample Response: 
    [
	{
		"id": "bitcoin", 
		"name": "Bitcoin", 
		"symbol": "BTC", 
		"rank": "1", 
		"price_usd": "573.137", 
		"price_btc": "1.0", 
		"24h_volume_usd": "72855700.0", 
		"market_cap_usd": "9080883500.0", 
		"available_supply": "15844176.0", 
		"total_supply": "15844176.0", 
		"percent_change_1h": "0.04", 
		"percent_change_24h": "-0.3", 
		"percent_change_7d": "-0.57", 
		"last_updated": "1472762067"
	}, 
	{
		"id": "ethereum", 
		"name": "Ethereum", 
		"symbol": "ETH", 
		"rank": "2", 
		"price_usd": "12.1844", 
		"price_btc": "0.021262", 
		"24h_volume_usd": "24085900.0", 
		"market_cap_usd": "1018098455.0", 
		"available_supply": "83557537.0", 
		"total_supply": "83557537.0", 
		"percent_change_1h": "-0.58", 
		"percent_change_24h": "6.34", 
		"percent_change_7d": "8.59", 
		"last_updated": "1472762062"
	}, 
	...
]


Ticker (Specific Currency)

  • Endpoint: /ticker/{id}/
  • Method: GET
  • Example: https://api.coinmarketcap.com/v1/ticker/bitcoin/
  • Sample Response: 
    [
	{
		"id": "bitcoin", 
		"name": "Bitcoin", 
		"symbol": "BTC", 
		"rank": "1", 
		"price_usd": "573.137", 
		"price_btc": "1.0", 
		"24h_volume_usd": "72855700.0", 
		"market_cap_usd": "9080883500.0", 
		"available_supply": "15844176.0", 
		"total_supply": "15844176.0", 
		"percent_change_1h": "0.04", 
		"percent_change_24h": "-0.3", 
		"percent_change_7d": "-0.57", 
		"last_updated": "1472762067"
	}
]
  • Sample Error Response: 
    {
	"error": "id not found"
}


Global Data

  • Endpoint: /global/
  • Method: GET
  • Example: https://api.coinmarketcap.com/v1/global/
  • Sample Response: 
    {
	"total_market_cap_usd": 12756692479.0, 
	"total_24h_volume_usd": 135078435.0, 
	"bitcoin_percentage_of_market_cap": 83.34, 
	"active_currencies": 653, 
	"active_assets": 59, 
	"active_markets": 1995
}


Limits

  • Please limit requests to no more than 10 per minute.
  • Endpoints update every 5 minutes.

Documentation Last Updated

  • September 3rd, 2016

Questions?