Public API

이용 시 주의 사항

코인힐스 API를 통해 제공되는 데이터를 외부 서비스에 이용할 경우, 코인힐스 링크를 포함한 출처를 명시해 주시기 바랍니다. 출처를 명시하지 않은 체 코인힐스의 데이터를 사용할 시, API 서비스에 제한이 있을 수 있습니다.

1. CSPA Index API

코인힐스에 등록된 모든 거래소들의 가격 데이터를 통해 계산된, CSPA ( Coinhills Spot Price Average ) 인덱스를 제공합니다.

Access

https://api.coinhills.com/v1/cspa/:primary_code/:secondary_code/

Parameters

Mandatory :primary_code = [ btc | ltc | eth | XMR | ... ]
btc, ltc 등 현재 거래되고 있는 모든 코인 코드를 사용할 수 있습니다.
Optional :secondary_code = [ cny | usd | eur | jpy | btc | ltc | ... ]
Primary Code와 짝을 이룰 때, 현재 존재하는 마켓인 코드만 가능합니다.

Returns

Returned Object

success

Bool

API 요청 성공 여부.

message

Text

오류가 발생했을 때 메시지.

elapsed

Number

API 요청에 걸린 시간.

data

Object

키 값이 'CSPA::primary_code/:secondary_code' 형식으로 이루어진 결과 데이터의 Array Object

data Object

cspa

Number

Coinhills Spot Price Average index value

cspa_change_24h

Number

최근 24시간 변동폭

cspa_change_24h_pct

Number

최근 24시간 변동폭. 퍼센티지 값

volume_:primary_code_24h

Number

최근 24시간 거래량. :primary_code 환산치.

volume_:secondary_code_24h

Number

최근 24시간 거래량. :secondary_code 환산치. :secondary_code 파라메터가 없을 시에는 USD 환산치 기본 제공.

updated

Number

최근 업데이트 시간, Unix Timestamp.

Example

$ curl https://api.coinhills.com/v1/cspa/btc/

{
    "success": true,
    "message": null,
    "elapsed": 0.0859,
    "data": {
        "CSPA:BTC": {
            "cspa": 368.14050821,
            "cspa_change_24h": 9.07165325,
            "cspa_change_24h_pct": 2.53,
            "volume_btc_24h": 2644087.61,
            "volume_usd_24h": 973395756.75,
            "updated": 1448832180
        }
    }
}

2. Status API

코인힐스의 다양한 현황 데이터를 제공합니다.
업데이트 주기는 매 1 분 입니다.

Access

https://api.coinhills.com/v1/status/

Parameter

없음.

Returns

Returned Object

success

Bool

API 요청 성공 여부.

message

Text

오류가 발생했을 때 메시지.

elapsed

Number

API 요청에 걸린 시간.

data

Object

키 값이 'status code' 로 이루어진 결과 데이터의 Array Object.

data Object

key

Text

상태 코드.

value

Number

해당 상태 코드의 값.

value_change

Number

최근 24시간 변동폭.

updated

Number

최근 업데이트 시간, Unix Timestamp.

Status Code

currencies

코인힐스에 등록되어 있는 디지털 화폐의 개 수.

currencies_available

코인힐스에 등록되어 있으며 조회 가능한 디지털 화폐의 개 수.

exchanges

코인힐스에 등록되어 있는 거래소의 개 수.

exchanges_available

코인힐스에 등록되어 있으며 조회 가능한 거래소의 개 수.

markets

코인힐스에 등록되어 있는 디지털 화폐 마켓의 개 수.

markets_available

코인힐스에 등록되어 있으며 조회 가능한 디지털 화폐 마켓의 개 수.

volume_btc_total_24h

코인힐스에 등록되어 있는 모든 코인의 최근 24시간 거래량 합계, BTC 환산치.

volume_usd_total_24h

코인힐스에 등록되어 있는 모든 코인의 최근 24시간 거래량 합계, USD 환산치.

Example

$ curl https://api.coinhills.com/v1/status/

{
    "success": true,
    "message": null,
    "elapsed": 0.0849,
    "data": {
        "currencies": {
            "value": 988,
            "value_change": 0,
            "updated": 1448832180
        },
        "currencies_available": {
            "value": 420,
            "value_change": 0,
            "updated": 1448832180
        },
        "exchanges": {
            "value": 97,
            "value_change": 0,
            "updated": 1448832180
        },
        "exchanges_available": {
            "value": 83,
            "value_change": 0,
            "updated": 1448832180
        },
        "markets": {
            "value": 3761,
            "value_change": -5,
            "updated": 1448832180
        },
        "markets_available": {
            "value": 1259,
            "value_change": -6,
            "updated": 1448832180
        },
        "volume_btc_total_24h": {
            "value": 2882980.3073822,
            "value_change": 563521.99004899,
            "updated": 1448832180
        },
        "volume_usd_total_24h": {
            "value": 1061341958.0169,
            "value_change": 228871331.89902,
            "updated": 1448832180
        }
    }
}