• 로그인
  • 회원가입
빗썸이 대한민국1등인이유 365일 24시간 고객센터운영 거래수수료 최저0%
 
운영자 사칭 피싱 주의 고객자산보호에스크로시스템 투명한운영2017년 3월 감사보고서 공개 비트코인 상품권 신용카드/휴대폰 결제 빗썸나눔 채용공고

X

bithumb RESTFul API

1. Public API

Resource
Description
https://api.bithumb.com/public/ticker/{currency}더보기
bithumb 거래소 마지막 거래 정보
* {currency} = BTC, ETH, DASH, LTC, ETC, XRP (기본값: 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}더보기
bithumb 거래소 판/구매 등록 대기 또는 거래 중 내역 정보
* {currency} = BTC, ETH, DASH, LTC, ETC, XRP (기본값: 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판매요청
quantityCurrency 수량
price1Currency당 거래금액
[Request Parameters]
Parameter Name Data Type Description
group_ordersIntValue : 0 또는 1 (Default : 1)
countIntValue : 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 (기본값: 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 수량
price1Currency 거래 금액
total총 거래금액
[Request Parameters]
Parameter Name Data Type Description
offsetIntValue : 0 ~ (Default : 0)
countIntValue : 1 ~ 100 (Default : 20)

2. Private API

Resource
Description
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거래 수수료
balance1Currency 잔액 (BTC, ETH, DASH, LTC, ETC, XRP)
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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",
						"misu_btc"      : "0.0",
						"misu_krw"      : "-528905",
						"xcoin_last"    : "505000",
						"misu_depo_krw" : "1735548.000000000000"
					}
				}
[Returned Value Description]
Key Name Description
status결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
total_{currency}전체 Currency (btc, eth, dash, ltc, etc, xrp)
total_krw전체 KRW
in_use_{currency}사용중 Currency (btc, eth, dash, ltc, etc, xrp)
in_use_krw사용중 KRW
available_{currency}사용 가능 Currency (btc, eth, dash, ltc, etc, xrp)
available_krw사용 가능 KRW
misu_{currency}신용거래 Currency (btc, eth, dash, ltc, etc, xrp)
misu_krw신용거래 KRW
xcoin_lastbithumb 마지막 거래체결 금액
misu_depo_krw미수 증거금
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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
currencyBTC, ETH, DASH, LTC, ETC, XRP
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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)
volume_1day최근 1일간 Currency 거래량 (BTC, ETH, DASH, LTC, ETC, XRP)
volume_7day최근 7일간 Currency 거래량 (BTC, ETH, DASH, LTC, ETC, XRP)
date현재 시간 Timestamp
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: BTC)
payment_currencyStringKRW (현재 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",
							"misu_yn"           : "N",
							"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)
units_remaining주문 체결 잔액
price1Currency당 거래금액 (BTC, ETH, DASH, LTC, ETC, XRP)
misu_yn신용거래 여부 (Y : 신용거래, N : 일반거래)
fee거래 수수료
total거래체결 완료 총 거래금액, 완료상태가 아닌 경우 NULL
date_completed거래체결 완료일시 Timestamp, 완료상태가 아닌 경우 NULL
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_idString판/구매 주문 등록된 주문번호
typeString거래유형(bid : 구매, ask : 판매)
countIntValue : 1 ~1000 (default : 100)
afterIntYYYY-MM-DD hh:mm:ss 의 UNIX Timestamp
(2014-11-28 16:40:01 = 1417160401000)
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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)
price거래금액
{currency}1krw1Currency당 거래금액 (btc, eth, dash, ltc, etc, xrp)
fee거래수수료
{currency}_remain거래 후 Currency 잔액 (btc, eth, dash, ltc, etc, xrp)
krw_remain거래 후 KRW 잔액
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
offsetIntValue : 0 ~ (default : 0)
countIntValue : 1 ~ 50 (default : 20)
searchGbString0 : 전체, 1 : 구매완료, 2 : 판매완료, 3 : 출금중, 4 : 입금, 5 : 출금, 9 : KRW입금중
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: BTC)
https://api.bithumb.com/trade/place더보기
bithumb 회원 판/구매 거래 주문 등록 및 체결
(미수 주문등록 및 체결은 현 API에서 지원 안 함)
[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체결 수량
price1Currency당 체결가 (BTC, ETH, DASH, LTC, ETC, XRP)
totalKRW 체결가
fee수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: BTC)
Payment_currencyStringKRW (기본값)
unitsFloat주문 수량 (BTC: 0.001 ~ 999.99999999 | ETH: 0.1 ~ 10,000 | DASH: 0.1 ~ 10,000 | LTC: 0.1 ~ 10,000 | ETC: 0.1 ~ 10,000 | XRP: 0.1 ~ 10,000)
priceInt1Currency당 거래금액 (BTC, ETH, DASH, LTC, ETC, XRP)
typeString거래유형 (bid : 구매, ask : 판매)
misuString신용거래(Y : 사용, N : 일반) – 추후 제공
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
typebid(구매), ask(판매)
order_currencyBTC, ETH, DASH, LTC, ETC, XRP
payment_currencyKRW
units_traded체결 수량
price1Currency당 체결가 (BTC, ETH, DASH, LTC, ETC, XRP)
fee수수료
total체결가
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_idString판/구매 주문 등록된 주문번호
typeString거래유형 (bid : 구매, ask : 판매)
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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
apiKeyStringapiKey
secretKeyStringscretKey
typeString거래유형 (bid : 구매, ask : 판매)
order_idString판/구매 주문 등록된 주문번호
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: BTC)
https://api.bithumb.com/trade/btc_withdrawal더보기
bithumb 회원 Currency 출금
(회원등급에 따른 BTC, ETH, DASH, LTC, ETC, XRP 출금)
[Returned Example]
				{
					"status"    : "0000"
				}
[Returned Value Description]
Key Name Description
status 결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloatCurrency 출금 하고자 하는 수량
(BTC: 0.01 ~ 회원등급수량 or ETH: 0.1 ~ 회원등급수량 or DASH: 0.1 ~ 회원등급수량 or LTC: 0.1 ~ 회원등급수량 or ETC: 0.1 ~ 회원등급수량 or XRP: 0.1 ~ 회원등급수량)
addressStringCurrency 출금 주소 (BTC, ETH, DASH, LTC, ETC, XRP)
destinationIntegerCurrency 출금 Destination Tag (XRP 출금시)
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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
apiKeyStringapiKey
secretKeyStringscretKey
https://api.bithumb.com/trade/krw_withdrawal더보기
bithumb 회원 KRW 출금 신청
[Returned Example]
				{
					"status"    : "0000"
				}
[Returned Value Description]
Key Name Description
status 결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
bank String
accountString출금계좌번호
priceInt출금 금액
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총 구매 수량(수수료 포함)
price1Currency당 KRW 시세 (BTC, ETH, DASH, LTC, ETC, XRP)
total구매 KRW
fee구매 수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloat주문 수량 (BTC: 0.001 ~ 999.99999999 | ETH: 0.1 ~ 10,000 | DASH: 0.1 ~ 10,000 | LTC: 0.1 ~ 10,000 | ETC: 0.1 ~ 10,000 | XRP: 0.1 ~ 10,000)
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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총 판매 수량(수수료 포함)
price1Currency당 KRW 시세 (BTC, ETH, DASH, LTC, ETC, XRP)
total판매 KRW
fee판매 수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloat주문 수량 (BTC: 0.001 ~ 999.99999999 | ETH: 0.1 ~ 10,000 | DASH: 0.1 ~ 10,000 | LTC: 0.1 ~ 10,000 | ETC: 0.1 ~ 10,000 | XRP: 0.1 ~ 10,000)
currencyStringBTC, ETH, DASH, LTC, ETC, XRP (기본값: 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다운로드