빗썸 API 정리

빗썸 공식 홈페이지 API 링크

https://www.bithumb.com/u1/US127

1. Public API

https://api.bithumb.com/public/ticker/{currency}

거래소 마지막 거래 정보

* {currency} = BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC), ALL(전체)

[Returned Example]

 



{
    "status": "0000",
    "data": {
        "opening_price" : "504000",
        "closing_price" : "505000",
        "min_price"     : "504000",
        "max_price"     : "516000",
        "average_price" : "509533.3333",
        "units_traded"  : "14.71960286",
        "volume_1day"   : "14.71960286",
        "volume_7day"   : "15.81960286",
        "buy_price"     : "505000",
        "sell_price"    : "504000",
        "date"          : 1417141032622
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
opening_price	최근 24시간 내 시작 거래금액
closing_price	최근 24시간 내 마지막 거래금액
min_price	최근 24시간 내 최저 거래금액
max_price	최근 24시간 내 최고 거래금액
average_price	최근 24시간 내 평균 거래금액
units_traded	최근 24시간 내 Currency 거래량
volume_1day	최근 1일간 Currency 거래량
volume_7day	최근 7일간 Currency 거래량
buy_price	거래 대기건 최고 구매가
sell_price	거래 대기건 최소 판매가
date	현재 시간 Timestamp

https://api.bithumb.com/public/orderbook/{currency}

거래소 판/구매 등록 대기 또는 거래 중 내역 정보

* {currency} = BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC), ALL(전체)

[Returned Example]

{
    "status"    : "0000",
    "data"      : {
        "timestamp"         : 1417142049868,
        "order_currency"    : "BTC",
        "payment_currency"  : "KRW",
        "bids": [
            {
                "quantity"  : "6.1189306",
                "price"     : "504000"
            },
            {
                "quantity"  : "10.35117828",
                "price"     : "503000"
            }
        ],
        "asks": [
            {
                "quantity"  : "2.67575",
                "price"     : "506000"
            },
            {
                "quantity"  : "3.54343",
                "price"     : "507000"
            }
        ]
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
timestamp	현재 시간 Timestamp
order_currency	주문 화폐단위
payment_currency	결제 화폐단위
bids	구매요청
asks	판매요청
quantity	Currency 수량
price	1Currency당 거래금액

[Request Parameters]

Parameter Name	Data Type	Description
group_orders	Int	Value : 0 또는 1 (Default : 1)
count	Int	Value : 1 ~ 50 (Default : 20), ALL : 1 ~ 5(Default : 5)

https://api.bithumb.com/public/recent_transactions/{currency}

bithumb 거래소 거래 체결 완료 내역

* {currency} = BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

[Returned Example]

 



{
    "status"    : "0000",
    "data"      : [
        {
            "transaction_date"  : "2015-04-20 11:17:21",
            "type"              : "bid",
            "units_traded"      : "0.03",
            "price"             : "270000",
            "total"             : "8100"
        },
        {
            "transaction_date"  : "2015-04-17 11:36:21",
            "type"              : "bid",
            "units_traded"      : "0.1",
            "price"             : "270000",
            "total"             : "27000"
        },
        {
            "transaction_date"  : "2015-04-17 11:36:13",
            "type"              : "ask",
            "units_traded"      : "0.1",
            "price"             : "260000",
            "total"             : "26000"
        }
    ]
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
transaction_date	거래 채결 시간
type	판/구매 (ask, bid)
units_traded	거래 Currency 수량
price	1Currency 거래 금액
total	총 거래금액

[Request Parameters]

Parameter Name	Data Type	Description
offset	Int	Value : 0 ~ (Default : 0)
count	Int	Value : 1 ~ 100 (Default : 20)

2. Private API

https://api.bithumb.com/info/account

bithumb 거래소 회원 정보

[Returned Example]

{
    "status"    : "0000",
    "data"      : {
        "created"       : 1388118018000,
        "account_id"    : "A000105A",
        "trade_fee"     : "0.000",
        "balance"       : "665.40127447"
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
created	회원가입 일시 Timestamp
account_id	회원ID
trade_fee	거래 수수료
balance	1Currency 잔액 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/info/balance

bithumb 거래소 회원 지갑 정보

[Returned Example]

{
    "status"    : "0000",
    "data"      : {
        "total_btc"     : "665.40127447",
        "total_krw"     : "305507280",
        "in_use_btc"    : "127.43629364",
        "in_use_krw"    : "8839047.0000000000",
        "available_btc" : "537.96498083",
        "available_krw" : "294932685.000000000000",
        "xcoin_last"    : "505000"
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
total_{currency}	전체 Currency (btc, eth, dash, ltc, etc, xrp, bch, xmr, zec, qtum, btg)
total_krw	전체 KRW
in_use_{currency}	사용중 Currency (btc, eth, dash, ltc, etc, xrp, bch, xmr, zec, qtum, btg)
in_use_krw	사용중 KRW
available_{currency}	사용 가능 Currency (btc, eth, dash, ltc, etc, xrp, bch, xmr, zec, qtum, btg)
available_krw	사용 가능 KRW
xcoin_last	bithumb 마지막 거래체결 금액

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC), ALL(전체 )

https://api.bithumb.com/info/wallet_address

bithumb 거래소 회원 입금 주소

[Returned Example]

{
    "status"    : "0000",
    "data"      : {
        "wallet_address"    : "1H7WL8Lb8mxCTwpL1RN8yckL2gcPLgqtqD",
        "currency"          : "BTC"
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
wallet_address	전자지갑 Address
currency	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/info/ticker

회원 마지막 거래 정보

[Returned Example]

{
    "status"    : "0000",
    "data"      : {
        "opening_price" : "507000",
        "closing_price" : "516000",
        "min_price"     : "507000",
        "max_price"     : "516000",
        "average_price" : "513875.0000",
        "units_traded"  : "3.91960286",
        "volume_1day"   : "3.91960286",
        "volume_7day"   : "5.01960286",
        "date"          : 1417148471595
    }
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
opening_price	최근 24시간 내 시작 거래금액
closing_price	최근 24시간 내 마지막 거래금액
min_price	최근 24시간 내 최저 거래금액
max_price	최근 24시간 내 최고 거래금액
average_price	최근 24시간 내 평균 거래금액
units_traded	최근 24시간 내 Currency 거래량 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
volume_1day	최근 1일간 Currency 거래량 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
volume_7day	최근 7일간 Currency 거래량 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
date	현재 시간 Timestamp

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
order_currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)
payment_currency	String	KRW (현재 bithumb에서 제공하는 통화 KRW)

https://api.bithumb.com/info/orders

판/구매 거래 주문 등록 또는 진행 중인 거래

[Returned Example]

{
    "status"    : "0000",
    "data"      : [
        {
            "order_id"          : "1412562509982",
            "order_currency"    : "BTC",
            "order_date"        : 1412562509982,
            "payment_currency"  : "KRW",
            "type"              : "bid",
            "status"            : "placed",
            "units"             : "5.0",
            "units_remaining"   : null,
            "price"             : "501000",
            "fee"               : null,
            "total"             : null,
            "date_completed"    : null
        }
    ]
} 

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
order_currency	주문 화폐단위
order_date	주문일시 Timestamp
payment_currency	결제 화폐단위
type	주문요청 구분 (bid : 구매, ask : 판매)
status	주문상태(placed : 거래 진행 중)
units	거래요청 Currency (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
units_remaining	주문 체결 잔액
price	1Currency당 거래금액 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
fee	거래 수수료
total	거래체결 완료 총 거래금액, 완료상태가 아닌 경우 NULL
date_completed	거래체결 완료일시 Timestamp, 완료상태가 아닌 경우 NULL

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
order_id	String	판/구매 주문 등록된 주문번호
type	String	거래유형(bid : 구매, ask : 판매)
count	Int	Value : 1 ~1000 (default : 100)
after	Int	YYYY-MM-DD hh:mm:ss 의 UNIX Timestamp (2014-11-28 16:40:01 = 1417160401000)
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/info/user_transactions

회원 거래 내역

[Returned Example]

{
    "status"    : "0000",
    "data"      : [
        {
            "search"        : "2",
            "transfer_date" : 1417139122544,
            "units"         : "- 0.1",
            "price"         : "51600",
            "btc1krw"       : "516000",
            "fee"           : "0 KRW",
            "btc_remain"    : "665.40127447",
            "krw_remain"    : "305507280"
        },
        {
            "search"        : "2",
            "transfer_date" : 1417138805912,
            "units"         : "- 0.1",
            "price"         : "51600",
            "btc1krw"       : "516000",
            "fee"           : "0 KRW",
            "btc_remain"    : "665.50127447",
            "krw_remain"    : "305455680"
        }
    ]
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
search	검색 구분 (0 : 전체, 1 : 구매완료, 2 : 판매완료, 3 : 출금중, 4 : 입금, 5 : 출금, 9 : KRW입금중)
transfer_date	거래 일시 Timestamp
units	거래 Currency 수량 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
price	거래금액
{currency}1krw	1Currency당 거래금액 (btc, eth, dash, ltc, etc, xrp, bch, xmr, zec, qtum, btg)
fee	거래수수료
{currency}_remain	거래 후 Currency 잔액 (btc, eth, dash, ltc, etc, xrp, bch, xmr, zec, qtum, btg)
krw_remain	거래 후 KRW 잔액

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
offset	Int	Value : 0 ~ (default : 0)
count	Int	Value : 1 ~ 50 (default : 20)
searchGb	String	0 : 전체, 1 : 구매완료, 2 : 판매완료, 3 : 출금중, 4 : 입금, 5 : 출금, 9 : KRW입금중
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/trade/place

bithumb 회원 판/구매 거래 주문 등록 및 체결

[Returned Example]

{
    "status"    : "0000",
    "order_id"  : "1428646963419",
    "data": [
        {
            "cont_id"   : "15313",
            "units"     : "0.61460000",
            "price"     : "284000",
            "total"     : 174546,
            "fee"       : "0.00061460"
        },
        {
            "cont_id"   : "15314",
            "units"     : "0.18540000",
            "price"     : "289000",
            "total"     : 53581,
            "fee"       : "0.00018540"
        }
    ]
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
order_id	주문번호
cont_id	체결번호
units	체결 수량
price	1Currency당 체결가 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
total	KRW 체결가
fee	수수료

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
order_currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)
Payment_currency	String	KRW (기본값)
units	Float	주문 수량 - 1회 최소 수량 (BTC: 0.001 \| ETH: 0.01 \| DASH: 0.01 \| LTC: 0.1 \| ETC: 0.1 \| XRP: 10 \| BCH: 0.01 \| XMR: 0.01 \| ZEC: 0.001 \| QTUM: 0.1 \| BTG: 0.01) - 1회 최대 수량 (BTC: 300 \| ETH: 2,500 \| DASH: 4,000 \| LTC: 15,000 \| ETC: 30,000 \| XRP: 2,500,000 \| BCH: 1,200 \| XMR: 10,000 \| ZEC: 2,500 \| QTUM: 30,000 \| BTG: 1,200)
price	Int	1Currency당 거래금액 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
type	String	거래유형 (bid : 구매, ask : 판매)

https://api.bithumb.com/info/order_detail

bithumb 회원 판/구매 체결 내역

[Returned Example]

{
    "status"    : "0000",
    "data"      : [
        {
            "transaction_date"  : "1428024598967",
            "type"              : "ask",
            "order_currency"    : "BTC",
            "payment_currency"  : "KRW",
            "units_traded"      : "0.0017",
            "price"             : "264000",
            "fee"               : "0.0000017",
            "total"             : "449"
        }
    ]
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
transaction_date	채결 시간 Timestamp
type	bid(구매), ask(판매)
order_currency	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG
payment_currency	KRW
units_traded	체결 수량
price	1Currency당 체결가 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
fee	수수료
total	체결가

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
order_id	String	판/구매 주문 등록된 주문번호
type	String	거래유형 (bid : 구매, ask : 판매)
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/trade/cancel

bithumb 회원 판/구매 거래 취소

[Returned Example]

{
    "status"    : "0000"
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
type	String	거래유형 (bid : 구매, ask : 판매)
order_id	String	판/구매 주문 등록된 주문번호
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/trade/btc_withdrawal

bithumb 회원 Currency 출금
(회원등급에 따른 BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM 출금)

[Returned Example]

{
    "status"    : "0000"
} 

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
units	Float	Currency 출금 하고자 하는 수량 - 1회 최소 수량 (BTC: 0.001 \| ETH: 0.01 \| DASH: 0.01 \| LTC: 0.01 \| ETC: 0.01 \| XRP: 21 \| BCH: 0.005 \| XMR: 0.1 \| ZEC: 0.01 \| QTUM: 0.1) - 1회 최대 수량 : 회원등급수량
address	String	Currency 출금 주소 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM)
destination	Integer	Currency 출금 Destination Tag (XRP 출금시)
destination	String	Currency 출금 Payment Id (XMR 출금시)
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM (기본값: BTC)

https://api.bithumb.com/trade/krw_deposit

bithumb 회원 KRW 입금 가상계좌 정보 요청

[Returned Example]

{
    "status"    : "0000",
    "account"   : "56208399422301",
    "bank"      : "신한은행",
    "BankUser"  : "비티씨코리아닷컴"
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
account	가상계좌번호
bank	신한은행(은행명)
BankUser	비티씨코리아닷컴(입금자명)

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
bank	String
account	String	출금계좌번호
price	Int	출금 금액

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

시장가 구매

[Returned Example]

{
    "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"
        }
    ]
} 

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
order_id	주문 번호
cont_id	체결 번호
units	총 구매 수량(수수료 포함)
price	1Currency당 KRW 시세 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
total	구매 KRW
fee	구매 수수료

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
units	Float	주문 수량 - 1회 최소 수량 (BTC: 0.001 \| ETH: 0.01 \| DASH: 0.01 \| LTC: 0.1 \| ETC: 0.1 \| XRP: 10 \| BCH: 0.01 \| XMR: 0.01 \| ZEC: 0.001 \| QTUM: 0.1 \| BTG: 0.01) - 1회 거래 한도 : 1억원
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

https://api.bithumb.com/trade/market_sell

시장가 판매

[Returned Example]

{
"status"    : "0000",
"order_id"  : "1429500318982",
    "data"      : [
        {
            "cont_id"   : "15366",
            "units"     : "0.78230769",
            "price"     : "260000",
            "total"     : 203400,
            "fee"       : 203
        },
        {
            "cont_id"   : "15367",
            "units"     : "0.21769231",
            "price"     : "259500",
            "total"     : 56491,
            "fee"       : 56
        }
    ]
}

[Returned Value Description]

Key Name	Description
status	결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
order_id	주문 번호
cont_id	체결 번호
units	총 판매 수량(수수료 포함)
price	1Currency당 KRW 시세 (BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG)
total	판매 KRW
fee	판매 수수료

[Request Parameters]

Parameter Name	Data Type	Description
apiKey	String	apiKey
secretKey	String	scretKey
units	Float	주문 수량 - 1회 최소 수량 (BTC: 0.001 \| ETH: 0.01 \| DASH: 0.01 \| LTC: 0.1 \| ETC: 0.1 \| XRP: 10 \| BCH: 0.01 \| XMR: 0.01 \| ZEC: 0.001 \| QTUM: 0.1 \| BTG: 0.01) - 1회 거래 한도 : 1억원
currency	String	BTC, ETH, DASH, LTC, ETC, XRP, BCH, XMR, ZEC, QTUM, BTG (기본값: BTC)

3. ERROR CODE

CODE	MESSAGE
5100	Bad Request
5200	Not Member
5300	Invalid Apikey
5302	Method Not Allowed
5400	Database Fail
5500	Invalid Parameter
5600	CUSTOM NOTICE (상황별 에러 메시지 출력)
5900	Unknown Error

[Returned Example]

{
    "success" : 5600,
    "message" : "최소 수량은 0.001BTC입니다"
}

4. Sample Code

1. PHP    다운로드
2. JAVA    다운로드
3. C++(Windows)    다운로드     libcurl    다운로드
4. C++(Linux)    다운로드
5. Node.js    다운로드
6. python3    다운로드
7. python    다운로드
8. C#    다운로드
9. GO    다운로드

알립니다.

- Public API

1초당 20회 요청 가능합니다.
20회 초과 요청을 보내면 API 사용이 제한되며,
제한 상태 해제는 관리자 승인이 필요합니다.(전화상담 요함)

- Private API

1초당 10회 요청 가능합니다.
10회 초과 요청을 보내면 5분간 API 사용이 제한됩니다.

저작자표시 비영리 변경금지

J.K.Lebiathan : Blockchain/Cryptocurrency Laboratory

빗썸 API 정리

티스토리툴바