How to access the marketcap.one API

Get your API Key

Unlimited access to our API is $100 per month or $1,000 per year. EOS is preferred, send tokens to account marketcapone (Bloks). We can accept fiat or other crypto upon request. Once you've paid, email [email protected] for your API key.

If you'd like to use our API for limited personal use, let us know and you can use it free. Email [email protected]

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 - all results

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

GET /api/1.0/tokens/{EOS,MEETONE} - get selected tokens

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

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.