How to access the marketcap.one API

Get your API Key

marketcap.one API access requires an API key. You can get a new key or update your existing key by copying and pasting this URL into your browser:

https://marketcap.one/api/1.0/generate/[email protected]

Make sure you replace "[email protected]" with your actual email address. You should receive an email shortly after with your api key.

Using your API Key

In order to access our API endpoints, you will need to provide us with your API key in the header packet

Example using curl

api key: yourapikey

request: curl -X GET -H "MCO-AUTH:yourapikey" https://marketcap.one/api/1.0/tokens

Anywhere you see this API key replace it with yours to try it out.

Market API

Every packet return will have a status code:

Status: 200 OK
Status: 400 endpoint not supported
Status: 401 invalid api key used


GET /api/1.0/tokens

curl Request:
curl -X GET -H "MCO-AUTH:yourapikey" https://marketcap.one/api/1.0/tokens

Results:

{
	"status": "200",
	"data": [
		{
			"token_id": "1",
			"name": "EOS",
			"symbol": "EOS",
			"contract": "eosio.token",
			"description": "Infrastructure for decentralized applications.",
			"icon": "https://marketcap.one/assets/icon/tokens/EOS-1.png",
			"current_price": "6.22536250",
			"current_supply": "1014809449.62630000",
			"max_supply": "10000000000.00000000",
			"current_marketcap": "6317556692.34920000",
			"ath_price": "7.59339500",
			"atl_price": "4.08311252",
			"volume_24hr": "96882.65425300",
			"price_change_24hr": "0"
		}
		.....
	]
}
							

GET /api/1.0/token/{token_id|token_symbol|token_contract}

curl request:
curl -X GET -H "MCO-AUTH:yourapikey" https://marketcap.one/api/1.0/token/EOS
curl -X GET -H "MCO-AUTH:yourapikey" https://marketcap.one/api/1.0/token/1
curl -X GET -H "MCO-AUTH:yourapikey" https://marketcap.one/api/1.0/token/eosio.token

Results:

{
	"status": "200",
	"data": {
		"token_id": "1",
		"name": "EOS",
		"symbol": "EOS",
		"contract": "eosio.token",
		"description": "Infrastructure for decentralized applications.",
		"icon": "https://marketcap.one/assets/icon/tokens/EOS-1.png",
		"current_price": "6.22536250",
		"current_supply": "1014809449.62630000",
		"max_supply": "10000000000.00000000",
		"current_marketcap": "6317556692.34920000",
		"ath_price": "7.59339500",
		"atl_price": "4.08311252",
		"volume_24hr": "96882.65425300",
		"price_change_24hr": "0"
	}
}
							

Note: Even though we support multiple ways to retrieve the token data, we recommend you use either the token ID or the token contract. If you use the symbol option, if there are more then one matching symbols it will only return the first one it found.