Listings

Welcome to the Listing Guide documentation page. If you are a digital asset exchange or ranking site, this guide will help you run a node and audit your setup.

Support

If you have any questions or need assistance with these instructions, please contact cLabs or ask in the #exchanges channel on Celo’s Discord server. Remember that Discord is a public channel: never disclose recovery phrases (also known as backup keys, or mnemonics), private keys, unsanitized log output, or personal information.

This guide will also help you find all the necessary information about brand assets, how to integrate with Celo and what useful listing information are made available to you as well as any information about looking for support.

Celo Brand Assets for Listing

If you are listing Celo on your exchange, you will probably need access to the Celo Platform brand assets. They can be found here.

Please ensure your use of the Celo Platform assets provided follows the brand policy found here.

How To's

Integrating Celo With Your Infrastructure

There are several ways to integrate the Celo Platform with your infrastructure.

A general overview of integrations that would be relevant to you listing Celo Platform are shown here.

For more specific use-cases for exchanges, please checkout the Custody and Exchange Integration Guide as well.

Important Information

Celo Native Asset and Celo Dollar

There are two important assets on the Celo network, the Celo native asset (CELO) and the Celo Dollar (cUSD). CELO was called Celo Gold (cGLD) when the contract was deployed, so you will often see references to Celo Gold in the codebase. To learn more about the two, please read this section of the docs.

You can also view the CGP proposal regarding the name change here and the forum post about the name change here.

Resources

Address for CELO and cUSD

The smart contract address for CELO can be found on the explorer here. It is 0x471ece3750da237f93b8e339c536989b8978a438. The smart contract address for cUSD can be found on the explorer here. It is 0x765de816845861e75a25fca122bb6898b8b1282a.

Useful API endpoints

The following are useful API endpoints available to you that would help you in your listings of the CELO and cUSD digital assets.

CELO and cUSD

Total CELO supply

For querying the API on total coins in circulation in CELO, which are the total amount of coins in existence right now, the following endpoint will provide you with that:

$ curl [https://thecelo.com/api/v0.1.js?method=ex_totalcoins](https://thecelo.com/api/v0.1.js?method=ex_totalcoins) {"code":"200","msg":"success","data":{"CELO":608485841.9959723,"cUSD":10250632.56099673}}

cUSD Circulating Supply

Circulating Supply refers to the # of coins that are circulating in the market and in the general public's hands.

$ curl https://thecelo.com/api/v0.1.js?method=ex_cusd_circulating
11353464.550486518

CP-DOTO (Stability Algorithm)

CP-DOTO information can be found here.

For API endpoints useful for listing that follow CMC requirements

Summary

Summary overview of market data for all tickers and all markets.

$ curl https://thecelo.com/api/v0.1.js?method=ex_summary
{"trading_pairs":"CELO_CUSD","last_price":2.6143,"lowest_ask":2.5933609958506225,"highest_bid":2.5676,"base_volume":37524.32000000003,"quote_volume":14714.520000000002,"price_change_percent_24h":3.7027120070382127,"highest_price_24h":2.649,"lowest_price_24h":2.4787}}

Assets

In depth details of the assets available on the exchange.

$ curl https://thecelo.com/api/v0.1.js?method=ex_assets
{"code":"200","msg":"success","data":{"CELO":{"name":"CELO","unified_cryptoasset_id":"5567","can_withdraw":"true","can_deposit":"true","min_withdraw":"0.000000000000000001","max_withdraw":"0.000000000000000001","maker_fee":"0.00","taker_fee":"0.005"},"CUSD":{"name":"Celo Dollars","unified_cryptoasset_id":"825","can_withdraw":"true","can_deposit":"true","min_withdraw":"0.000000000000000001","max_withdraw":"0.000000000000000001","maker_fee":"0.00","taker_fee":"0.005"}}}

Ticker

24-hour rolling window price change statistics.

$ curl https://thecelo.com/api/v0.1.js?method=ex_ticker
{"code":"200","msg":"success","data":{"CELO_CUSD":{"base_id":"5567","quote_id":"825","last_price":2.6124,"quote_volume":14789.520000000002,"base_volume":37720.30000000003,"isFrozen":"0"}}}

Orderbook

Market depth of a trading pair. One array containing a list of ask prices and another array containing bid prices.

$ curl https://thecelo.com/api/v0.1.js?method=ex_orderbook
{"code":"200","msg":"success","data":{"timestamp":1601061465962,"bids":[["2.5964","100"]],"asks":[["2.622606871230003","100"]]}}

CELO cUSD

Recently completed (past 24h) trades.

$ curl https://thecelo.com/api/v0.1.js?method=ex_celocusd
{"code":"200","msg":"success","data":{"CELO_CUSD":[{"trade_id":2697341,"timestamp":1601061491,"price":0.38238291620515147,"quote_volume":25,"base_volume":65.37948987916423,"type":"Sell"},{"trade_id":2697336,"timestamp":1601061466,"price":0.382293821845672,"quote_volume":25,"base_volume":65.39472670341044,"type":"Sell"}]}}

Whitepapers

To learn about the Celo Protocol, please refer to the whitepaper.

If you need more information to explore other aspects of the Celo Protocol, there’s a useful links page.

To learn more about the Stability Mechanism, you can find it over here. The Stability Analysis Whitepaper and blog post will provide a lot more information on the stability algorithm.

If you want to find more information about the Celo Reserve, a diversified portfolio of cryptocurrencies supporting the ability of the Celo protocol to expand and contract the supply of Celo stable assets, please visit https://celoreserve.org.

Github

The Celo Protocol GitHub is located here.

Audits

All the security audits on the smart contracts, security and economics of the Celo Platform can be found here.