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.