View on GitHub

openmarketcap-api

Developer documentation for OpenMarketCap API

Version: 1.0.0

Welcome to the OpenMarketCap API documentation! Below, you’ll learn how to programmtically connect with OpenMarketCap and get the latest aggregate data about exchanges without fake trading volume.

API Endpoints

The following are the API endpoints you can access. You currently don’t need an API key to access the API.

Quota and Limits

OpenMarketCap’s data doesn’t update faster than once a minute, so there’s no need to retrieve and paginate through the full data more frequently than once a minute.

Please be courteous and be careful with how often you hit the endpoints each minute.

GET /tokens

Gets a list of tokens with current prices, 24h volumes, and stats.

Example:

curl http://api.openmarketcap.com/api/v1/tokens

Returns:

{
  "records_total":"932",
  "data":[
    { "rank":1,
      "name":"Bitcoin",
      "symbol":"BTC",
      "global_id":"btc",
      "price_usd":"5529.07349506971400000000",
      "volume_usd":"1564681721.80",
      "available_supply":"17661700",
      "price_change":"3.01",
      "market_cap":"97652837347.87276775380000000000",
      "nvt":"62.41067175983468291947"
    },
    { "rank":2,
      "name":"Ethereum",
      "symbol":"ETH",
      "global_id":"eth",
      "price_usd":"168.46285644503905000000",
      "volume_usd":"301514552.13",
      "available_supply":"105784167",
      "price_change":"-1.22",
      "market_cap":"17820702939.47903718672135000000",
      "nvt":"59.10395638813320975720"
    },
    ...[and 98 more results]
  ]
}

Parameters

query

The page number for the token list. The first page is ‘1’. If you enter a page beyond the number of tokens, the data field will return an empty array.

Example:

curl http://api.openmarketcap.com/api/v1/tokens?page=2

Returns:

{ 
  "records_total":"932",
  "data":[
    { "rank":100,
      "name":"Enigma",
      "symbol":"ENG",
      "global_id":"eng",
      "price_usd":"0.45692977369757726000",
      "volume_usd":"545042.67",
      "available_supply":"74836171",
      "price_change":"-6.18",
      "market_cap":"34194874.67942319411507146000",
      "nvt":"62.73797733932133077777"
    },
    { "rank":101,
      "name":"Celer Network",
      "symbol":"CELR",
      "global_id":"celr",
      "price_usd":"0.01711099089386793400",
      "volume_usd":"8962442.85",
      "available_supply":"1997377673",
      "price_change":"-3.59",
      "market_cap":"34177111.17431812398223758200",
      "nvt":"3.81337005393770784070"
    },
    ...[and 98 more results]
  ]
}
size

Number of results per page

Example:

curl http://api.openmarketcap.com/api/v1/tokens?page=2&size=1

Returns:

{ 
  "records_total":"932",
  "data":[
    { "rank":100,
      "name":"Enigma",
      "symbol":"ENG",
      "global_id":"eng",
      "price_usd":"0.45692977369757726000",
      "volume_usd":"545042.67",
      "available_supply":"74836171",
      "price_change":"-6.18",
      "market_cap":"34194874.67942319411507146000",
      "nvt":"62.73797733932133077777"
    }
  ]
}

Returns

ApiResponse Object

Schema Definitions

ApiReponse Object

Properties

records_total

The total number of tokens

data

An array of Token objects

error

Any error messages will show here

Token Object

Properties

rank

Current ranking on OMC front page. ‘1’ is highest and first.

name

Name of cryptocurrency token

symbol

Commonly used symbol on exchanges. Not always unique.

global_id

Globally unique Id for token on OMC.

price_usd

Current price of token in USD

volume_usd

Current volume of token in USD

available_supply

Available supply of token. Circulating supply.

market_cap

The price * the available supply.

nvt

Network Value to Transactions Ratio