# CoinGecko Listing Submission (Chain 138 / 651940)

**Purpose:** Steps to submit Chain 138 (and 651940) to CoinGecko for listing and price/volume display.

## Prerequisites

- Token Aggregation Service running and reachable (e.g. `https://your-api/report/coingecko`).
- Public URL for the report API (CoinGecko may need to fetch it).

## Steps

1. **Expose report API:** Ensure `GET /api/v1/report/coingecko` is publicly reachable or use CoinGecko's allowed submission method (e.g. API URL or file upload).
2. **CoinGecko request form:** Use [CoinGecko listing request](https://www.coingecko.com/en/coins/new) or partner/API submission if available. Provide:
   - Chain name / ChainID (e.g. "Sankofa Chain" / 138).
   - API URL returning CoinGecko-style data: `https://<your-domain>/api/v1/report/coingecko?chainId=138`.
   - Or export JSON from `/api/v1/report/coingecko` and attach if they accept file upload.
3. **Response format:** Our `/report/coingecko` returns tokens with `contract_address`, `symbol`, `name`, `decimals`, `market_data`, `liquidity_pools` as per [CMC_COINGECKO_REPORTING.md](CMC_COINGECKO_REPORTING.md).
4. **Chain support:** CoinGecko may not yet support ChainID 138/651940; external price/volume may show empty until they add the chain. The report API still provides chain-native data.

## See also

- [CMC_COINGECKO_REPORTING.md](CMC_COINGECKO_REPORTING.md) — API reference
- [README.md](../README.md) — Service setup and env (canonical tokens, API keys)
