Files
smom-dbis-138/services/token-aggregation/docs/COINGECKO_SUBMISSION.md
2026-03-02 12:14:09 -08:00

24 lines
1.5 KiB
Markdown

# 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)