Market BuyPrivate API

시장가 매수 기능을 제공합니다.

POST https://api.bithumb.com/trade/market_buy

Example Response

{
    "status"    : "0000",
    "order_id"  : "1429500241523",
    "data": [
        {
            "cont_id"   : "15364",
            "units"     : "0.16789964",
            "price"     : "270000",
            "total"     : 45333,
            "fee"       : "0.00016790"
        },
        {
            "cont_id"   : "15365",
            "units"     : "0.08210036",
            "price"     : "289000",
            "total"     : 23727,
            "fee"       : "0.00008210"
        }
    ]
}

Request Parameters

요청 변수, 설명, 타입으로 구성된 표
요청 변수 설명 타입
apiKey 사용자 API Key String/필수
secretKey 사용자 Secret Key String/필수
units 코인 매수 수량
[최소 주문 수량]
아래 기준으로 입력 호가에 따라 최소 주문 수량 적용
입력 호가 최소 수량
100 원 미만 100
100원 이상 1,000원 미만 10
1,000원 이상 10,000원 미만 1
10,000원 이상 100,000원 미만 0.1
100,000원 이상 1,000,000원 미만 0.01
1,000,000원 이상 0.001
[최대 주문 금액]
1억 원
Float/필수
currency 암호화폐 영문 코드
기본값 : BTC
String/필수

Response

필드, 설명, 타입으로 구성된 표
필드 설명 타입
status 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) String
order_id 주문 번호 String
cont_id 체결 번호 Number (String)
units 체결(매수) 수량 (수수료 포함) Number (String)
price 1Currency당 KRW 가격 (체결가) Number (String)
total 매수 KRW (체결가) Integer
fee 거래 수수료 Number (String)