Skip to main content

Listings

Guidance for digital asset exchanges or ranking sites on running a Celo node and auditing your setup.

Support​

For any questions or assistance with these instructions, please contact cLabs or inquire in Celo's Discord server. Note 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 provides comprehensive information on brand assets, integration with Celo, and useful listing information, as well as support resources.

Celo Brand Assets for Listing​

If you are listing Celo on your exchange, you will need access to the Celo Platform brand assets, available here.

Ensure that your use of the Celo Platform assets complies with the brand policy found here.

How To's​

Integrating Celo With Your Infrastructure​

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

A general overview of relevant integrations for listing Celo Platform is available here.

For specific use-cases for exchanges, please refer to the Custody and Exchange Integration Guide.

Important Information​

Celo Native Asset and Stable Value Currencies​

The Celo network features key assets, including the Celo native asset (CELO) and Celo-powered Stable Value Currencies, such as Celo Dollar (cUSD) and Celo Euro (cEUR). CELO was formerly known as Celo Gold (cGLD) when the contract was deployed, so references to Celo Gold and CGLD may still appear in the codebase. For more information, please read this section of the documentation.

You can also view the forum post about the name change here.

Resources​

Addresses for CELO and Stable Value Currencies​

Useful API Endpoints​

The following API endpoints are useful for listing CELO and cUSD digital assets.

CELO and Stable Value Currencies​

Total CELO Supply​

To query the API for the total coins in circulation in CELO, use the following endpoint:

$ curl https://thecelo.com/api/v0.1.js?method=ex_totalcoins
{"code":"200","msg":"success","data":{"CELO":608485841.9959723,"cUSD":10250632.56099673}}
Stable Value Currencies​
cUSD Circulating Supply​

Circulating Supply refers to the number of coins 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
cEUR Circulating Supply​

This endpoint is not yet available.

CP-DOTO (Stability Algorithm)​

Information on CP-DOTO can be found here.

For API endpoints useful for listing that follow CMC requirements

Mento Addresses​
Summary​

Summary overview of market data for all tickers and all markets. These endpoints do not yet support cEUR.

$ 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 contains a list of ask prices and another array contains 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.

For more information on other aspects of the Celo Protocol, visit the useful links page.

To learn more about the Stability Mechanism, refer to this page. The Stability Analysis Whitepaper and blog post provide additional information on the stability algorithm.

For information about the Celo Reserve, a diversified portfolio of cryptocurrencies supporting the Celo protocol's ability to expand and contract the supply of Celo stable assets, visit https://celoreserve.org.

GitHub​

The Celo Protocol GitHub repository is located here.

Audits​

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