시가총액:

CoinMarketCap 공개 API 문서

버전 2


엔드포인트 요약

공개 API 엔드포인트

목록

  • 엔드포인트: /listings/
  • 방식: GET
  • 설명: 이 엔드포인트는 한 번의 통화에 있는 모든 활성화 상태의 가상 화폐를 표시합니다. 티커 엔드포인트에 있는 "id"란을 사용해 특정 가상화폐에 대한 더 많은 정보를 문의하세요.
  • 예시: https://api.coinmarketcap.com/v2/listings/
  • 샘플 응답:
    {
        "data": [
            {
                "id": 1, 
                "name": "Bitcoin", 
                "symbol": "BTC", 
                "website_slug": "bitcoin"
            }, 
            {
                "id": 2, 
                "name": "Litecoin", 
                "symbol": "LTC", 
                "website_slug": "litecoin"
            }, 
            ...
        },
        "metadata": {
            "timestamp": 1525137187, 
            "num_cryptocurrencies": 1602, 
            "error": null
        }
    ]                               

티커

  • 엔드포인트: /ticker/
  • 방식: GET
  • 설명: 이 엔드포인트는 가상 화폐 티커 데이터를 순위 순서로 표시합니다. 통화 당 최대 결과 수는 100입니다. startlimit 매개변수를 사용하면 페이지 매김이 가능합니다.
  • 임의 파라미터:
    • (int) start - return results starting from the specified number (default is 1)
    • int) limit - 최대 [limit] 결과 보기 (기본값은 100, 최대는 100입니다)
    • (string) sort - [sort] (으)로 분류된 결과 보기. 가능한 값은 id, rank, volume_24h, 그리고 percent_change_24h입니다. (기본값은 rank입니다).
      Note: It is strongly recommended to use id to sort if paginating through all available results since id is the only sort option guaranteed to return in a consistent order.
    • (string) structure - 주요 데이터 필드의 구조 지정. 가능한 값은 dictionaryarray입니다. (기본값은 dictionary입니다).
    • (string) convert - 다른 통화로 환산한 가격 정보 보기.
      유효한 신용 화폐 값: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
      유효한 가상 화폐 값: "BTC", "ETH" "XRP", "LTC", 및 "BCH"
  • 예시: https://api.coinmarketcap.com/v2/ticker/
  • 예시: https://api.coinmarketcap.com/v2/ticker/?limit=10
  • 예시: https://api.coinmarketcap.com/v2/ticker/?limit=10&sort=id
  • 예시: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10
  • 예시: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id
  • 예시: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id&structure=array
  • 예시: https://api.coinmarketcap.com/v2/ticker/?convert=EUR&limit=10
  • 예시: https://api.coinmarketcap.com/v2/ticker/?convert=BTC&limit=10
  • 샘플 응답:
    {
        "data": {
            "1": {
                "id": 1, 
                "name": "Bitcoin", 
                "symbol": "BTC", 
                "website_slug": "bitcoin", 
                "rank": 1, 
                "circulating_supply": 17008162.0, 
                "total_supply": 17008162.0, 
                "max_supply": 21000000.0, 
                "quotes": {
                    "USD": {
                        "price": 9024.09, 
                        "volume_24h": 8765400000.0, 
                        "market_cap": 153483184623.0, 
                        "percent_change_1h": -2.31, 
                        "percent_change_24h": -4.18, 
                        "percent_change_7d": -0.47
                    }
                }, 
                "last_updated": 1525137271
            }, 
            "1027": {
                "id": 1027, 
                "name": "Ethereum", 
                "symbol": "ETH", 
                "website_slug": "ethereum", 
                "rank": 2, 
                "circulating_supply": 99151888.0, 
                "total_supply": 99151888.0, 
                "max_supply": null, 
                "quotes": {
                    "USD": {
                        "price": 642.399, 
                        "volume_24h": 2871290000.0, 
                        "market_cap": 63695073558.0, 
                        "percent_change_1h": -3.75, 
                        "percent_change_24h": -7.01, 
                        "percent_change_7d": -2.32
                    }
                }, 
                "last_updated": 1525137260
            } 
            ...
        },
        "metadata": {
            "timestamp": 1525137187, 
            "num_cryptocurrencies": 1602, 
            "error": null
        }
    ]                               

티커(특정 통화)

  • 엔드포인트: /ticker/{id}/
  • 방식: GET
  • 설명: 이 엔드포인트는 특정 가상 화폐에 대한 티커 데이터를 표시합니다. URL에 있는 목록에서 "id"란을 사용하세요.
  • 임의 파라미터:
    • (string) structure - 주요 데이터 필드의 구조 지정. 가능한 값은 dictionaryarray입니다. (기본값은 dictionary입니다).
    • (string) convert - 다른 통화로 환산한 가격 정보 보기.
      유효한 신용 화폐 값: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
      유효한 가상 화폐 값: "BTC", "ETH" "XRP", "LTC", 및 "BCH"
  • 예시: https://api.coinmarketcap.com/v2/ticker/1/
  • 예시: https://api.coinmarketcap.com/v2/ticker/1/?structure=array
  • 예시: https://api.coinmarketcap.com/v2/ticker/1/?convert=EUR
  • 예시: https://api.coinmarketcap.com/v2/ticker/1/?convert=BCH
  • 샘플 응답:
    {
        "data": {
            "id": 1, 
            "name": "Bitcoin", 
            "symbol": "BTC", 
            "website_slug": "bitcoin", 
            "rank": 1, 
            "circulating_supply": 17008162.0, 
            "total_supply": 17008162.0, 
            "max_supply": 21000000.0, 
            "quotes": {
                "USD": {
                    "price": 9024.09, 
                    "volume_24h": 8765400000.0, 
                    "market_cap": 153483184623.0, 
                    "percent_change_1h": -2.31, 
                    "percent_change_24h": -4.18, 
                    "percent_change_7d": -0.47
                }
            }, 
            "last_updated": 1525137271
        },
        "metadata": {
            "timestamp": 1525237332, 
            "error": null
        }
    }               
  • 샘플 오류 응답:
    {
        "data": null, 
        "metadata": {
            "timestamp": 1525137187, 
            "error": "id not found"
        }
    }

전세계 데어터

  • 엔드포인트: /global/
  • 방식: GET
  • 설명: 이 엔드포인트는 coinmarketcap.com의 상단에서 찾을 수 있는 글로벌 데이터를 표시합니다.
  • 임의 파라미터:
    • (string) convert - 다른 통화로 환산한 가격 정보 보기.
      유효한 신용 화폐 값: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
      유효한 가상 화폐 값: "BTC", "ETH" "XRP", "LTC", 및 "BCH"
  • 예시: https://api.coinmarketcap.com/v2/global/
  • 예시: https://api.coinmarketcap.com/v2/global/?convert=EUR
  • 예시: https://api.coinmarketcap.com/v2/global/?convert=BTC
  • 샘플 응답:
    {
        "data": {
            "active_cryptocurrencies": 1594, 
            "active_markets": 10526, 
            "bitcoin_percentage_of_market_cap": 37.65, 
            "quotes": {
                "USD": {
                    "total_market_cap": 407690157494.0, 
                    "total_volume_24h": 30969801118.0
                }
            }, 
            "last_updated": 1525137271
        },
        "metadata": {
            "timestamp": 1525237332, 
            "error": null
        }
    }                       

노트

기타

한도

  • 요청을 분당 30번 이하로 제한하세요.
  • 5분마다 앤드포이트 업데이트

이용 약관

  • 공개 API를 사용하면 이용 약관에 동의하는 것으로 간주됩니다..

API 버전 1을 찾고 계신가요?

  • 문서는 여기에서 볼 수 있습니다.

최근 업데이트된 문서

  • 2018년 05월 20일