로고

Introduction

본 문서는 URL를 통해서 제스트씨앤티의 암호화폐 거래소인 COINZEST 서비스를 활용할 수 있는 API를 제공합니다.

API는 Public 과 Private으로 구분되어 제공되며 Public의 경우 별도의 인증 절차 없이 사용이 가능합니다.

Private API의 경우 coinzest 사용자 중 요청/승인된 사용자에 한하여 기능을 제공하고 있습니다.

API URL format

Request

HTTP 메소드 주요 용도
GET public api url 호출시
POST 주문 등 데이터 신규 등록

Response

상태코드 상태 텍스트 설명
200 OK 요청 처리 성공
401 Unauthorized 인증 오류
500 Internal Server Error 서버 에러

Public

Public API

Public API 요청 시 다음의 GET Method를 지원합니다.

요청 명 url
코인정보 https://api.coinzest.co.kr/api/public/coin
마켓정보 https://api.coinzest.co.kr/api/public/market
마켓요약정보 https://api.coinzest.co.kr/api/public/market_summary
현재가
  • https://api.coinzest.co.kr/api/public/current_price/{market coin name}-{trade coin name}
  • ex) https://api.coinzest.co.kr/api/public/current_price/KRW-BTC
호가
  • https://api.coinzest.co.kr/api/public/bid_price/{market coin name}-{trade coin name}
  • ex) https://api.coinzest.co.kr/api/public/bid_price/KRW-BTC
최근체결내역
  • https://api.coinzest.co.kr/api/public/recent_contract/{market coin name}-{trade coin name}
  • ex) https://api.coinzest.co.kr/api/public/recent_contract/KRW-BTC

Coin Info(코인 정보)

전체 코인의 종류을 가져온다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/coin
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: coin

sample

{
    "code":"coin"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
list
Array
검색결과
  • • list.coin : 코인 코드  ex) 001,002
  • • list.name : 코인 코드 name  ex) BTC,ETH
  • • list.desc : description  ex) 비트코인,이더리움

sample

{
    "message": "1 row(s) returned",
    "trancount": 0,
    "totalsize": 1,
    "success": true,
    "list":    [
        {
            "desc": "비트코인",
            "coin": "001",
            "name": "BTC"
        },
        {
            "desc": "비트코인캐시",
            "coin": "002",
            "name": "BCC"
        }
    ]
}

Market Info(마켓 정보)

마켓의 정보를 가져오고, 마켓별 거래 가능한 코인의 정보를 가져옵니다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/market
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: market

sample

{
    "code":"market"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
trancount
Int
0으로 반환
list
Array
검색결과
  • • list.mrkCoin : 마켓코인코드(지불수단코인)
  • • list.mrkCoinName : 마켓코인코드 name
  • • list.trdCoin : 거래대상코인코드
  • • list.trdCoinName : 거래대상코인코드 name
  • • list.minTrdAmt : 최소거래금액

sample

{
    "message": "1 row(s) returned",
    "trancount": 0,
    "totalsize": 1,
    "success": true,
    "list":    [
        {
            "trdCoinName": "BTC",
            "minTrdAmt": "50000.000000000000",
            "trdCoin": "001",
            "mrkCoinName": "KRW",
            "mrkCoin": "000"
        },
        {
            "trdCoinName": "BCC",
            "minTrdAmt": "50000.000000000000",
            "trdCoin": "002",
            "mrkCoinName": "KRW",
            "mrkCoin": "000"
        },
        {
            "trdCoinName": "ETH",
            "minTrdAmt": "50000.000000000000",
            "trdCoin": "003",
            "mrkCoinName": "KRW",
            "mrkCoin": "000"
        }
    ]
}

Market Summary(마켓 요약 정보)

마켓의 정보를 가져오고, 마켓별 거래 가능한 코인의 정보를 가져옵니다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/market_summary
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: market_summary

sample

{
    "code":"market_summary"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
trancount
Int
0으로 반환
result
Array
검색결과
  • • result.OpenSellOrders : 매도호가수
  • • result.Low : 저가
  • • result.OpenBuyOrders : 매수호가수
  • • result.Volume : 24시간 거래금액
  • • result.Bid : 첫번째 매수 호가
  • • result.MarketName : 마켓명 (Market Coin Name)-(Trade Coin Name)
  • • result.Ask : 첫번째 매도 호가
  • • result.TimeStamp : 마지막거래시간 (unix time)
  • • result.Last : 현재가 (마지막거래가격)
  • • result.Created : 요청시간 (unix time)
  • • result.PrevDay : 전일종가
  • • result.BaseVolume : 24시간 거래금액
  • • result.High : 고가

sample

{
    "message": "1 row(s) returned",
    "trancount": 0,
    "totalsize": 1,
    "success": true,
    "list":    [
        {
            "OpenSellOrders": "4",
            "Low": "1.0001E7",
            "OpenBuyOrders": "4",
            "Volume": "127612",
            "Bid": "1.0001E7",
            "MarketName": "KRW-BTC",
            "Ask": "1.1273E7",
            "TimeStamp": "1534835122288",
            "Last": "1.1273E7",
            "Created": "1534836288553",
            "PrevDay": "1.1263E7",
            "BaseVolume": "127612",
            "High": "1.1273E7"
        },
        {
            "OpenSellOrders": "4",
            "Low": "1.0001E7",
            "OpenBuyOrders": "4",
            "Volume": "127612",
            "Bid": "1.0001E7",
            "MarketName": "KRW-BTC",
            "Ask": "1.1273E7",
            "TimeStamp": "1534835122288",
            "Last": "1.1273E7",
            "Created": "1534836288553",
            "PrevDay": "1.1263E7",
            "BaseVolume": "127612",
            "High": "1.1273E7"
        }
    ]
}

Current Price(현재가)

코인별 현재시세(최근체결가격) 를 가져옵니다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/current_price/{market coin name}-{trade coin name}                                         ex)https://api.coinzest.co.kr/api/public/current_price/KRW-BTC
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: current_price
mrkCoin
String
마켓코인코드(지불수단코인)
trdCoin
String
거래대상코인코드

sample

{
    "code":"current_price",
    "mrkCoin" : "000",
    "trdCoin" : "001"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
current_price
Object
검색결과
  • • mrkCoin : 마켓코인코드(지불수단코인)
  • • trdCoin : 거래대상코인코드
  • • cprc : 현재가
  • • stp : 기준가
  • • bprc : 시가
  • • hprc : 고가
  • • lprc : 저가
  • • fnp : 종가
  • • bfdCmprUadPrc : 전일대비등락금액
  • • bfdCmprUadRt : 전일대비등락율
  • • trdQty : 거래량
  • • trdAmt : 거래대금

sample

{
    "success": true,
    "message": "",
    "current_price":  {
        "lprc": "11236000.0",
        "fnp": "11481000.0",
        "hprc": "11705000.0",
        "trdAmt": "16556652871.3",
        "trdCoin": "001",
        "bprc": "11481000.0",
        "trdQty": "1435.7115",
        "bfdCmprUadPrc": "108000.0",
        "stp": "11481000.0",
        "mrkCoin": "000",
        "bfdCmprUadRt": "0.94",
        "cprc": "11589000.0"
    }
}

Bid Price(호가)

마켓, 거래코인의 호가 정보를 가져옵니다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/bid_price/{market coin name}-{trade coin name}                                         ex)https://api.coinzest.co.kr/api/public/bid_price/KRW-BTC
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: bid_price
mrkCoin
String
마켓코인코드(지불수단코인)
trdCoin
String
거래대상코인코드

sample

{
    "code":"bid_price",
    "mrkCoin" : "000",
    "trdCoin" : "001"
}

Response Data

Properties Description
success
boolean
성공 실패 여부 , true or false
message
string
메세지
bid_price
Object
호가
  • • mrkCoin : 마켓코인코드(지불수단코인)
  • • trdCoin : 거래대상코인코드
  • • bidList : 매수호가 Array
  • • bidList.price : 매수호가
  • • bidList.quantity : 매수호가수량
  • • totalBidQty : 매수호가 총수량
  • • askList : 매도호가 Array
  • • askList.price : 매도호가
  • • askList.quantity : 매도호가수량
  • • totalAskQty : 매도호가 총수량

sample

{
 "success": true,
 "message": "",
 "bid_price":  {
  "mrkCoin": "000",
  "trdCoin": "001",
  "bidList":   [
      {    "price": "11538000.0",    "quantity": "1.4204"   },
      {    "price": "11518000.0",    "quantity": "1.265"    },
      {    "price": "11478000.0",    "quantity": "1.1808"   },
      {    "price": "11442000.0",    "quantity": "0.7004"   },
      {    "price": "11434000.0",    "quantity": "1.2093"   },
      {    "price": "11429000.0",    "quantity": "0.3834"   },
      {    "price": "11388000.0",    "quantity": "0.494"    },
      {    "price": "11385000.0",    "quantity": "0.8898"   },
      {    "price": "11384000.0",    "quantity": "1.4338"   },
      {    "price": "11382000.0",    "quantity": "0.4639"   }
  ],
  "totalBidQty": "9.4408",
  "askList":   [
      {    "price": "11553000.0",    "quantity": "1.0971"    },
      {    "price": "11651000.0",    "quantity": "1.4648"    },
      {    "price": "11705000.0",    "quantity": "1.5917"    },
      {    "price": "11706000.0",    "quantity": "48.6123"   },
      {    "price": "11707000.0",    "quantity": "44.4443"   },
      {    "price": "11708000.0",    "quantity": "40.3201"   },
      {    "price": "11709000.0",    "quantity": "54.1906"   },
      {    "price": "11710000.0",    "quantity": "42.0596"   },
      {    "price": "11711000.0",    "quantity": "54.0201"   },
      {    "price": "11712000.0",    "quantity": "54.1453"   }
  ],
  "totalAskQty": "341.9459",
 }
}

Recent Contract(최근 체결 내역)

지정된 코인별 최근 체결 내역을 가져옵니다.

Request

HTTP 메소드 URL
GET https://api.coinzest.co.kr/api/public/recent_contract/{market coin name}-{trade coin name}                                         ex)https://api.coinzest.co.kr/api/public/recent_contract/KRW-BTC
POST https://api.coinzest.co.kr/api

POST Request Data

Key Description
code
String
value: recent_contract
mrkCoin
String
마켓코인코드(지불수단코인)
trdCoin
String
거래대상코인코드

sample

{
    "code":"recent_contract",
    "mrkCoin" : "000",
    "trdCoin" : "001",
}

Response Data

Properties Description
success
boolean
성공 실패 여부 , true or false
message
string
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
list
Array
검색결과
  • • list.contPrc : 체결가격
  • • list.contQty : 체결수량
  • • list.contAmt : 체결금액
  • • list.contDt : 체결시간

sample

{
    "totalsize": 20,
    "trancount": 0,
    "success": true,
    "message": "20 row(s) returned",
    "list":  [
        {   "contAmt": "320236.2",   "contDt": "2018.02.27 16:19:05",   "contQty": "0.0279",   "contPrc": "11478000.0"  },
        {   "contAmt": "766677.5",   "contDt": "2018.02.27 16:19:34",   "contQty": "0.0655",   "contPrc": "11705000.0"  },
        {   "contAmt": "1006716.0",   "contDt": "2018.02.27 16:19:34",   "contQty": "0.086",   "contPrc": "11706000.0"  },
        {   "contAmt": "6933463.8",   "contDt": "2018.02.27 16:19:34",   "contQty": "0.5923",   "contPrc": "11706000.0"  },
        {   "contAmt": "5758711.4",   "contDt": "2018.02.27 16:20:34",   "contQty": "0.4979",   "contPrc": "11566000.0"  },
        {   "contAmt": "14804480.0",   "contDt": "2018.02.27 16:20:34",   "contQty": "1.28",   "contPrc": "11566000.0"  },
        {   "contAmt": "8198882.4",   "contDt": "2018.02.27 16:20:34",   "contQty": "0.7004",   "contPrc": "11706000.0"  },
        {   "contAmt": "469410.6",   "contDt": "2018.02.27 16:22:04",   "contQty": "0.0401",   "contPrc": "11706000.0"  },
        {   "contAmt": "16912828.8",   "contDt": "2018.02.27 16:22:04",   "contQty": "1.4448",   "contPrc": "11706000.0"  },
        {   "contAmt": "13067926.4",   "contDt": "2018.02.27 16:22:34",   "contQty": "1.1248",   "contPrc": "11618000.0"  },
        {   "contAmt": "5899692.0",   "contDt": "2018.02.27 16:22:34",   "contQty": "0.514",   "contPrc": "11478000.0"  },
        {   "contAmt": "2983132.2",   "contDt": "2018.02.27 16:23:04",   "contQty": "0.2599",   "contPrc": "11478000.0"  },
        {   "contAmt": "8013976.8",   "contDt": "2018.02.27 16:23:04",   "contQty": "0.7004",   "contPrc": "11442000.0"  },
        {   "contAmt": "8589972.0",   "contDt": "2018.02.27 16:23:04",   "contQty": "0.7512",   "contPrc": "11435000.0"  },
        {   "contAmt": "3138633.0",   "contDt": "2018.02.27 16:23:04",   "contQty": "0.2745",   "contPrc": "11434000.0"  },
        {   "contAmt": "8357110.6",   "contDt": "2018.02.27 16:23:04",   "contQty": "0.7309",   "contPrc": "11434000.0"  },
        {   "contAmt": "3800938.2",   "contDt": "2018.02.27 16:24:04",   "contQty": "0.3247",   "contPrc": "11706000.0"  },
        {   "contAmt": "5233752.6",   "contDt": "2018.02.27 16:24:04",   "contQty": "0.4471",   "contPrc": "11706000.0"  },
        {   "contAmt": "978621.6",   "contDt": "2018.02.27 16:24:04",   "contQty": "0.0836",   "contPrc": "11706000.0"  },
        {   "contAmt": "10133884.2",   "contDt": "2018.02.27 16:24:04",   "contQty": "0.8657",   "contPrc": "11706000.0"  }
    ]
}

Private

private api는 https://papi.coinzest.co.kr 에서만 서비스 가능하며 HTTPS,POST 방식으로만 지원 됩니다.

Private CheckSum

private api 사용시 반드시 checkSum을 입력 한다.
HTTP Request Header에 name : czChecksum , value : 발급받은 Security Key + Body(JSON) 을 SHA256 HEX 로 보낸다.

예)
Security Key : 123456789
Body(JSON) : {"code":"nonce","key":"1d1f38283222c990e85c0036e4004fe4"}
대상 String : '123456789{"code":"nonce","key":"1d1f38283222c990e85c0036e4004fe4"}' 를 SHA256 HEX 로 만든다.

HTTP PROTOCOL 예
--------------------------------------------------------------------------------------------------------------------------------
POST /api HTTP/1.1
Host: api.coinzest.co.kr
Connection: keep-alive
Content-Length: 62
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Accept: */*
czChecksum: 75b158b3129950f62d017c639ea0d1f7f183e5b01f736a99d0d5a1934bc8f22c
Accept-Encoding: gzip, deflate
Accept-Language: ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7
Cookie: JSESSIONID=E35D96B61A9590DACC2E655DA45A7489;

{"code":"nonce","key":"1d1f38283222c990e85c0036e4004fe4"}
--------------------------------------------------------------------------------------------------------------------------------

Request

HTTP 메소드 URL
POST https://papi.coinzest.co.kr/api

Nonce

매수매도 주문 ,취소 정정 전에 코인제스트에서 nonce (유효시간( 5초 )내에 단 한번만 사용가능한 키) 을 얻고 주문,취소,정정 입력값에 nonce 값을 입력한다.

Request Data

Key Description
code
String
value: nonce
key
String
발급받은 key

sample

{
    "code":"nonce",
    "key":"1d1f38283222c990e85c0036e4004fe4"
}

Response Data

Properties Description
nonce
String
ex) znhwGC9piEnmW739jG8DVFMnWUIwV7a8dLTofve7rFw=

sample

{
    "nonce":"znhwGC9piEnmW739jG8DVFMnWUIwV7a8dLTofve7rFw="
}

Order Add(주문)

매수,매도 주문을 요청

Request Data

Key Description
code
String
value:order_add
key 발급받은 key
itCd 매도,매수 구분 (BUY=매수,SEL=매도)
ordPrcTpCd 주문구분 (LMT=지정가,MKT='시장가')
mrkCoin 마켓코인코드(지불수단코인)
trdCoin 거래대상코드
qty 주문수량
price 주문단가
nonce 발급받은 nonce
mktTotAmt 시장가일경우 전체주문금액 (지정가일때는 '0' 으로 반드시 입력)

sample

{
    "code":"order_add",
    "key":"1d1f38283222c990e85c0036e4004fe4",
    "mrkCoin" : "000",
    "trdCoin" : "001",
    "itCd" : "BUY",
    "ordPrcTpCd":"LMT",
    "qty":"0.01",
    "price":"500000",
    "nonce":"znhwGC9piEnmW739jG8DVFMnWUIwV7a8dLTofve7rFw=",
    "mktTotAmt":"0"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
result_code
String
메세지
ordNum
String
주문번호 , result_code=0001 성공일때만 주문번호 반환

Code Description

Code Description
0001 성공
500 서버 에러
0002 주문 접수 시 오류가 발생했습니다
1001 회원정보가 없습니다.
1002 회원인증등급코드 오류입니다.
1003 매매사용상태가 매매불가 입니다.
1006 원주문번호를 찾을 수 없습니다
1007 취소주문수량이 미체결수량보다 많습니다
1008 정정주문수량과 미체결수량에서 다릅니다
1009 호가 정보를 찾지 못했습니다.
1010 주문단가가 호가단위에 맞지 않습니다.
1011 최소거래금액 정보가 없습니다.
1012 주문금액이 최소거래금액 미만입니다.
1013 회원님의 수수료율 정보가 없습니다.
1014 회원님의 계좌 잔고 정보가 없습니다.
1015 주문금액이 주문가능금액보다 큽니다
1016 회원님의 코인 잔고 정보가 없습니다
1017 주문가능수량이 주문수량 보다 작습니다.
1018 시장가주문금액이 0 입니다.
1019 주문수량 정보가 없습니다.
1020 주문단가 정보가 없습니다.
1024 정정주문단가가 원주문단가와 같습니다
1041 주문수량이 제한기준보다 큽니다
1043 시장가매도 예상주문금액이 제한기준보다 큽니다.
1044 주문금액이 제한기준보다 큽니다.
1045 원주문 건이 정정/취소 진행 중 입니다.
1047 취소 주문수량이 0 이하 입니다
1060 현재 시장가 사용 불가
1061 상대코인의 주문수량이 정해진 소수점 자리수 초과입니다.
1062 기준코인의 주문금액이 정해진 소수점 자리수 초과입니다.
2016 주문이 (이미)체결되었습니다
2020 해당 주문은 이미 정정 처리가 완료되었습니다
2021 해당 주문은 이미 취소 처리가 완료되었습니다
3001 현재가를 찾을 수 없습니다
4001 invalid nonce value (유효하지 않은 nonce)
4002 nonce timeout (유효시간 초과)
4003 nonce not present or valid timeout (이미 사용된 nonce 이거나 유효시간 초과)
4004 nonce api key and input api key are different (nonce발급시 입력된 api key 와 현재 입력된 api key 가 다른 경우)
7001 동일 기준 마켓에 이전 주문의 처리가 완료 되지 않았습니다.(잠시 후 이용 바랍니다.)

sample

{
    "success": true,
    "result_code":"0001",
    "ordNum":"20181213173311.217191"
}

Order Cancel(주문취소)

주문취소

Request Data

Key Description
code
String
value:order_cancel
key 발급받은 key
itCd 매도,매수 구분 (BUY=매수,SEL=매도)
ordPrcTpCd 주문구분 (LMT=지정가,MKT='시장가')
mrkCoin 마켓코인코드(지불수단코인)
trdCoin 거래대상코드
qty 취소주문수량
nonce 발급받은 nonce
orgOrdNum 원주문번호

sample

{
    "code":"order_cancel",
    "key":"1d1f38283222c990e85c0036e4004fe4",
    "mrkCoin" : "000",
    "trdCoin" : "001",
    "itCd" : "BUY",
    "ordPrcTpCd":"LMT",
    "qty":"0.01",
    "nonce":"znhwGC9piEnmW739jG8DVFMnWUIwV7a8dLTofve7rFw=",
    "orgOrdNum":"20181213173311.217191"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
result_code
String
메세지

Code Description

Code Description
0001 성공
500 서버 에러
0002 주문 접수 시 오류가 발생했습니다
1001 회원정보가 없습니다.
1002 회원인증등급코드 오류입니다.
1003 매매사용상태가 매매불가 입니다.
1006 원주문번호를 찾을 수 없습니다
1007 취소주문수량이 미체결수량보다 많습니다
1008 정정주문수량과 미체결수량에서 다릅니다
1009 호가 정보를 찾지 못했습니다.
1010 주문단가가 호가단위에 맞지 않습니다.
1011 최소거래금액 정보가 없습니다.
1012 주문금액이 최소거래금액 미만입니다.
1013 회원님의 수수료율 정보가 없습니다.
1014 회원님의 계좌 잔고 정보가 없습니다.
1015 주문금액이 주문가능금액보다 큽니다
1016 회원님의 코인 잔고 정보가 없습니다
1017 주문가능수량이 주문수량 보다 작습니다.
1018 시장가주문금액이 0 입니다.
1019 주문수량 정보가 없습니다.
1020 주문단가 정보가 없습니다.
1024 정정주문단가가 원주문단가와 같습니다
1041 주문수량이 제한기준보다 큽니다
1043 시장가매도 예상주문금액이 제한기준보다 큽니다.
1044 주문금액이 제한기준보다 큽니다.
1045 원주문 건이 정정/취소 진행 중 입니다.
1047 취소 주문수량이 0 이하 입니다
1060 현재 시장가 사용 불가
2016 주문이 (이미)체결되었습니다
2020 해당 주문은 이미 정정 처리가 완료되었습니다
2021 해당 주문은 이미 취소 처리가 완료되었습니다
3001 현재가를 찾을 수 없습니다
4001 invalid nonce value (유효하지 않은 nonce)
4002 nonce timeout (유효시간 초과)
4003 nonce not present or valid timeout (이미 사용된 nonce 이거나 유효시간 초과)
4004 nonce api key and input api key are different (nonce발급시 입력된 api key 와 현재 입력된 api key 가 다른 경우)
7001 동일 기준 마켓에 이전 주문의 처리가 완료 되지 않았습니다.(잠시 후 이용 바랍니다.)

sample

{
    "success": true,
    "result_code":"0001"
}

Order Info(주문내역)

사용자의 코인별 진행중인 주문 내역을 조회합니다.

Request Data

Key Description
code
String
value:order_info
key 발급받은 key
itCd 매도,매수 구분 (BUY=매수,SEL=매도)
mrkCoin 마켓코인코드(지불수단코인)
trdCoin 거래대상코드
startDate 검색시작일자(YYYYMMDD)
endDate 검색종료일자(YYYYMMDD)
limit 페이지당 항목 수 1~50
page 페이지번호 1 이상

sample

{
    "code":"order_info",
    "key":"1d1f38283222c990e85c0036e4004fe4",
    "mrkCoin" : "000",
    "trdCoin" : "001",
    "itCd" : "BUY",
    "startDate":"20180301",
    "endDate":"20180331",
    "limit":"10",
    "page":"1"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
page_info
Object
page에 대한 정보 object
  • • total : 전체 count
  • • firstPage : 첫번째 페이지 No
  • • lastPage : 마지막페이지 No
  • • currentPage : 현재페이지 No
list
Array
검색결과 Array
  • • list.ordNum : 주문번호 (일련번호)
  • • list.ordDate : 주문일자
  • • list.ordTime : 주문시간
  • • list.mdmCd : 주문매체(device)구분 ('WEB'='PC웹브라우져','MOB'='Mobile','WTS'='웹트레이딩시스템')
  • • list.ordCd : 주문거래구분 ('GNT'='일반거래','INT'='내부거래','EMT'='비상거래','COT'='코인간거래')
  • • list.ordQty : 주문수량
  • • list.ordPrc : 주문단가
  • • list.contQty : 체결수량
  • • list.ordPrcTpCd : 주문종류구분 ('LMT'='지정가' , 'MKT'='시장가')
  • • list.ordStatCd : 주문상태구분 ('000'='접수대기중' , '001'='접수완료')
  • • list.mrkOrdTotAmt : (삭제)매수시장가 매수금액
  • • list.rjtCd : (삭제)거부코드
  • • list.rcvStat : (삭제)주문접수요청상태 ('0'='접수요청중' , '1'='접수완료')
  • • list.rjtQty : (삭제)거부수량
  • • list.crctQty : (삭제)주문정정수량
  • • list.cnclQty : (삭제)취소수량

sample

{
    "success": true,
    "message": "",
    "totalsize": 2,
    "trancount": "0",
    "page_info":  {
        "total": "2",
        "lastPage": "1",
        "firstPage": "1",
        "currentPage": "1"
    },
    "list":  [
        {"ordNum": "20180301014353.091132","rjtCd": "","contQty": "0.0","rcvStat": "1","rjtQty": "0.0","ordPrcTpCd": "LMT","crctQty": "0.0","mdmCd": "WEB","cnclQty": "0.0","ordCd": "GNT","ordQty": "0.639","ordTime": "014353","ordPrc": "11078000.0","ordDate": "20180301","mrkOrdTotAmt": "0.0"},
        {"ordNum": "20180301014403.005513","rjtCd": "","contQty": "0.0","rcvStat": "1","rjtQty": "0.0","ordPrcTpCd": "LMT","crctQty": "0.0","mdmCd": "WEB","cnclQty": "0.0","ordCd": "GNT","ordQty": "1.4981","ordTime": "014403","ordPrc": "11104000.0","ordDate": "20180301","mrkOrdTotAmt": "0.0"}
    ]
}

Contract Info(체결내역)

사용자의 코인별 거래 체결 내역을 조회합니다.

Request Data

Key Description
code
String
value: contract_info
key 발급받은 key
itCd 매도,매수 구분 (BUY=매수,SEL=매도)
mrkCoin 마켓코인코드(지불수단코인)
trdCoin 거래대상코드
startDate 검색시작일자(YYYYMMDD)
endDate 검색종료일자(YYYYMMDD)
limit 페이지당 항목 수 1~50
page 페이지번호 1 이상

sample

{
    "code":"contract_info",
    "key":"1d1f38283222c990e85c0036e4004fe4",
    "mrkCoin" : "000",
    "trdCoin" : "001",
    "itCd" : "BUY",
    "startDate":"20180301",
    "endDate":"20180331",
    "limit":"10",
    "page":"1"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
page_info
Object
page에 대한 정보 object
  • • total : 전체 count
  • • firstPage : 첫번째 페이지 No
  • • lastPage : 마지막페이지 No
  • • currentPage : 현재페이지 No
list
Array
검색결과 Array
  • • list.contNum : 체결번호 (일련번호)
  • • list.contDate : 체결일자
  • • list.contTime : 체결시간
  • • list.contQty : 체결수량
  • • list.contPrc : 체결단가
  • • list.contAmt : 체결금액 (체결수량*체결단가)
  • • list.cmrt : 수수료율
  • • list.cmms : 수수료금액

sample

{
    "success": true,
    "message": "",
    "totalsize": 10,
    "trancount": "0",
    "page_info":  {
        "total": "66123",
        "lastPage": "6613",
        "firstPage": "1",
        "currentPage": "1"
    },
    "list":  [
        {"contAmt": "6183458.4","cmms": "4637.5938","contDate": "20180302","contQty": "0.5362","contTime": "102506","contPrc": "11532000.0","cmrt": "0.00075","contNum": "20180302102506.122306"},
        {"contAmt": "9360302.0","cmms": "7020.2265","contDate": "20180302","contQty": "0.8218","contTime": "102507","contPrc": "11390000.0","cmrt": "0.00075","contNum": "20180302102507.122000"},
        {"contAmt": "2933520.0","cmms": "2200.14","contDate": "20180302","contQty": "0.255","contTime": "102507","contPrc": "11504000.0","cmrt": "0.00075","contNum": "20180302102507.632350"},
        {"contAmt": "15911346.2","cmms": "11933.50965","contDate": "20180302","contQty": "1.3757","contTime": "102509","contPrc": "11566000.0","cmrt": "0.00075","contNum": "20180302102509.000001"},
        {"contAmt": "2549591.0","cmms": "1912.19325","contDate": "20180302","contQty": "0.2218","contTime": "102509","contPrc": "11495000.0","cmrt": "0.00075","contNum": "20180302102509.022000"},
        {"contAmt": "2015953.8","cmms": "1511.96535","contDate": "20180302","contQty": "0.1743","contTime": "102509","contPrc": "11566000.0","cmrt": "0.00075","contNum": "20180302102509.405200"},
        {"contAmt": "570388.5","cmms": "427.791375","contDate": "20180302","contQty": "0.0495","contTime": "102509","contPrc": "11523000.0","cmrt": "0.00075","contNum": "20180302102509.505200"},
        {"contAmt": "7051413.0","cmms": "5288.55975","contDate": "20180302","contQty": "0.6137","contTime": "102510","contPrc": "11490000.0","cmrt": "0.00075","contNum": "20180302102510.021202"},
        {"contAmt": "3779046.8","cmms": "2834.2851","contDate": "20180302","contQty": "0.3293","contTime": "102511","contPrc": "11476000.0","cmrt": "0.00075","contNum": "20180302102511.242200"},
        {"contAmt": "4905673.0","cmms": "3679.25475","contDate": "20180302","contQty": "0.4307","contTime": "102512","contPrc": "11390000.0","cmrt": "0.00075","contNum": "20180302102512.005200"}
    ]
}

Coin Balance(코인잔고)

사용자의 각 코인별 잔고를 조회합니다.

Request Data

Key Description
code
String
value: coin_balance
key 발급받은 key

sample

{
    "code":"coin_balance",
    "key":"1d1f38283222c990e85c0036e4004fe4"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
list
Array
검색결과 Array
  • • list.trdCoin : 코인코드
  • • list.coinQty : 코인잔고수량
  • • list.buyQty : (삭제)매수잔고수량 (0 고정값)
  • • list.sellQty : (삭제)매도잔고수량 (0 고정값)
  • • list.selectDate : 조회일시

sample

{
    "success": true,
    "message": "",
    "totalsize": 10,
    "trancount": "0",
    "list":  [
        {"coinQty": "999726.685","buyQty": "0","trdCoin": "001","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "1000054.3654","buyQty": "0","trdCoin": "002","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "157.1328","buyQty": "0","trdCoin": "003","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "5.941","buyQty": "0","trdCoin": "004","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "56.1554","buyQty": "0","trdCoin": "005","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "1000000.0","buyQty": "0","trdCoin": "006","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "16.1979","buyQty": "0","trdCoin": "007","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "1000000.0","buyQty": "0","trdCoin": "008","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "1000000.0","buyQty": "0","trdCoin": "009","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"},
        {"coinQty": "1000000.0","buyQty": "0","trdCoin": "010","selectDate": "2018-03-07 15:31:48.0","sellQty": "0"}
    ]
}

KRW Balance(원화 잔고)

사용자의 원화 잔고를 조회합니다.

Request Data

Key Description
code
String
value: krw_balance
key 발급받은 key

sample

{
    "code":"krw_balance",
    "key":"1d1f38283222c990e85c0036e4004fe4"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
balance
String
원화잔고
selectDate
Date
조회일시

sample

{
    "success": true,
    "message": "",
    "totalsize": "1",
    "trancount": "0",
    "balance": "57498701913",
    "selectDate": "2018-03-07 15:44:36.0"
}

Orderable Amount(주문 가능 수량)

사용자의 주문가능한 코인 잔고를 조회합니다. (KRW, BTC, ETH)

Request Data

Key Description
code
String
value: ord_amt
key 발급받은 key
mrkCoin
String
마켓코인코드(지불수단코인)

sample

{
    "code":"ord_amt",
    "key":"1d1f38283222c990e85c0036e4004fe4",
    "mrkCoin" : "000"
}

Response Data

Properties Description
success
Boolean
성공 실패 여부 , true or false
message
String
메세지
totalsize
Int
검색결과의 row 수
trancount
Int
0으로 반환
balance
String
주문가능금액
selectDate
Date
조회일시

sample

{
    "success": true,
    "message": "",
    "totalsize": "1",
    "trancount": "0",
    "balance": "299974935",
    "selectDate": "2018-03-07 15:44:36.0"
}