코인마켓캡 상장 신청, 유통량·총발행량 API 엔드포인트 만드는 법
코인마켓캡(CMC) 상장 신청서에는 토큰의 총발행량과 유통량을 알려주는 URL을 입력해야 합니다. 이 엔드포인트가 갖춰야 할 조건과 준비하는 두 가지 방법을 정리했습니다.
코인마켓캡이 공급량 엔드포인트를 요구하는 이유
시가총액은 가격 × 유통량입니다. 유통량이 틀리면 토큰 페이지의 시가총액과 순위도 틀리게 표시됩니다.
그래서 코인마켓캡은 신청서에 한 번 적힌 숫자 대신, 프로젝트가 제공한 URL에서 수치를 읽어 갑니다. 락업 해제, 소각, 재단 지갑 이동이 있어도 페이지가 정확하게 유지됩니다.
엔드포인트가 갖춰야 할 조건
- API 키나 로그인 없이 열리는 공개 HTTPS URL
- HTML 페이지나 부가 텍스트 없이 숫자 하나만 응답
- 소수점 자릿수(decimals)가 적용된 값. 예: 18자리 원시 정수가 아닌
742318950.25 - 총발행량과 유통량을 각각 별도 URL로 제공
- 언제든 확인할 수 있도록 안정적으로 운영
총발행량과 유통량의 차이
| 구분 | 의미 | 일반적인 계산 |
|---|---|---|
| 총발행량 | 온체인에 존재하는 전체 토큰 | 발행량 − 소각량 |
| 유통량 | 시장에서 거래 가능한 토큰 | 총발행량 − 락업·팀·재단·베스팅 지갑 보유량 |
어려운 쪽은 유통량입니다. 보유 지갑에서 토큰이 나갈 때마다 바뀌기 때문에 고정된 숫자는 금방 틀린 값이 됩니다.
방법 1. 직접 개발
- 컨트랙트의
totalSupply()와 보유 지갑별balanceOf()를 읽는 스크립트 작성 - 토큰 decimals로 원시 값 변환
- HTTPS 도메인이 연결된 서버나 서버리스 함수에 배포
- 가동 상태를 모니터링하고, 물량 배분이 바뀌면 지갑 목록 수정
백엔드 개발자에게는 작은 작업이지만 호스팅, RPC 노드, 그리고 상장 이후에도 계속 관리할 담당자가 필요합니다.
방법 2. CMCEndpoint로 코드 없이 무료 발급
- 프로젝트 등록 — 체인 선택 후 토큰 심볼, 컨트랙트 주소, decimals 입력
- 주요 보유 지갑 추가 — 아직 유통되지 않은 토큰을 보관 중인 지갑
- URL 복사 — 코인마켓캡 상장 신청서에 붙여넣기
총발행량: https://api.cmcendpoint.com/token/{token-id}/total
유통량: https://api.cmcendpoint.com/token/{token-id}/circulating유통량은 온체인 잔고를 기준으로 1분마다 다시 계산되어, 보유 지갑에서 토큰이 이동해도 정확한 수치가 유지됩니다.
| 직접 개발 | CMCEndpoint | |
|---|---|---|
| 준비 기간 | 개발 수일 | 약 5분 |
| 코딩 | 필요 | 불필요 |
| 호스팅·RPC | 직접 관리 | 포함 |
| 유통량 갱신 | 스크립트에 따라 다름 | 1분마다 온체인 반영 |
| 비용 | 개발 인건비 + 서버비 | 무료 |
제출 전 체크리스트
- 시크릿 창에서 두 URL을 열어 숫자만 표시되는지 확인
- 총발행량이 블록 익스플로러 수치와 같은지 비교
- 락업·팀·재단·베스팅 지갑이 빠짐없이 등록됐는지 확인
- 백서·토크노믹스 페이지의 수치와 일치하는지 확인
자주 묻는 질문
코인게코에도 같은 URL을 쓸 수 있나요?
네. 코인게코 상장 신청서도 공급량 엔드포인트를 요구하며, 같은 총발행량·유통량 URL을 양쪽에 제출할 수 있습니다.
어떤 체인을 지원하나요?
Ethereum, BNB Chain, Polygon, Solana, Kaia를 지원합니다.
유통량은 얼마나 자주 갱신되나요?
온체인 지갑 잔고를 기준으로 1분마다 갱신됩니다.
보유 지갑이 바뀌면 URL도 바뀌나요?
아니요. 대시보드에서 지갑 주소만 수정하면 되고 URL은 그대로입니다.
비용은 얼마인가요?
무료입니다.