Skip to main content

Listings

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

warning

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2! Some documentation may be outdated as updates are in progress. If you encounter issues, please file a bug report.

For the most up-to-date information, refer to our Celo L2 documentation.

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 probably 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 ways 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​

Address 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 # 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
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 don't 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, 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 repository is located here.

Audits​

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