Developer

문서 검색

엔드포인트, 개념, 에러 코드 검색

API 레퍼런스
데이터센터/코인 마켓 정보

코인 마켓 정보

코인별 시가총액, 순위, 가격 변동률 등 마켓캡 지표를 조회합니다. 비로그인으로 조회할 수 있습니다. 인증이 필요 없는 공개 엔드포인트입니다.

GEThttps://forum-open-api.inextest.com/api/v1/feed/coin-market-caps

요청 파라미터

symbolstring선택

조회 대상을 특정 코인 심볼로 한정합니다.

예시 BTC

searchDatestring선택

조회할 날짜입니다.

예시 2026-08-12

pageint선택

조회할 페이지 번호입니다. 1부터 시작합니다.

예시 1

sizeint선택

한 페이지에 포함할 항목 수입니다.

예시 20

응답 필드

idint64

마켓캡 데이터의 고유 ID입니다.

예시 123

coinIdint64

코인 고유 ID입니다.

예시 12345

namestring

암호화폐 이름입니다.

예시 Bitcoin

symbolstring

암호화폐 심볼입니다.

예시 BTC

searchDatestring

데이터 기준일입니다.

예시 2026-04-15

cmcRankint

CoinMarketCap 기준 순위입니다.

예시 1

pricenumber

코인 단가입니다.

예시 90000.5

volume24hnumber

24시간 거래량입니다.

예시 30000000000

volumeChange24hnumber

24시간 거래량 변화율입니다.

예시 5.2

percentChange1hnumber

1시간 가격 변동률입니다.

예시 0.1

percentChange24hnumber

24시간 가격 변동률입니다.

예시 1.5

percentChange7dnumber

7일 가격 변동률입니다.

예시 3.2

marketCapnumber

시가총액입니다.

예시 1800000000000

marketCapDominancenumber

시가총액 지배력 비율입니다.

예시 55.5

fullyDilutedMarketCapnumber

완전 희석 시가총액입니다.

예시 1900000000000

circulatingSupplynumber

현재 유통 중인 대략적인 코인 수량입니다.

예시 19000000

totalSupplynumber

현재 존재하는 대략적인 총 코인 수량입니다.

예시 19000000

maxSupplyint64

발행 가능한 최대 공급량입니다.

예시 21000000

lastUpdatedstring

데이터의 마지막 업데이트 일시입니다.

예시 2026-04-15T10:51:19

응답 예제 200 OK

{
    "data": {
        "content": [
            {
                "id": 123,
                "coinId": 12345,
                "name": "Bitcoin",
                "symbol": "BTC",
                "searchDate": "2026-04-15",
                "cmcRank": 1,
                "price": 90000.5,
                "volume24h": 30000000000,
                "volumeChange24h": 5.2,
                "percentChange1h": 0.1,
                "percentChange24h": 1.5,
                "percentChange7d": 3.2,
                "marketCap": 1800000000000,
                "marketCapDominance": 55.5,
                "fullyDilutedMarketCap": 1900000000000,
                "circulatingSupply": 19000000,
                "totalSupply": 19000000,
                "maxSupply": 21000000,
                "lastUpdated": "2026-04-15T10:51:19"
            }
        ],
        "page": 1,
        "size": 20,
        "totalElements": 5000,
        "totalPages": 250
    }
}