• 로그인
  • 회원가입
365일 24시간 고객센터운영 신용카드/휴대폰 결제 2017년 3월 감사보고서 공개
bithumb RESTFul API

1. Public API

Resource
Description
https://api.bithumb.com/public/ticker더보기
bithumb 거래소 마지막 거래 정보
[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",
						"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시간 내 BTC 거래량
volume_1day최근 1일간 BTC 거래량
volume_7day최근 7일간 BTC 거래량
date현재 시간 Timestamp
https://api.bithumb.com/public/orderbook더보기
bithumb 거래소 판/구매 등록 대기 또는 거래 중 내역 정보
[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판매요청
quantityBTC 수량
price1BTC당 거래금액
[Request Parameters]
Parameter Name Data Type Description
group_ordersIntValue : 0 또는 1 (Default : 1)
countIntValue : 1 ~ 50 (Default : 20)
https://api.bithumb.com/public/recent_transactions더보기
bithumb 거래소 거래 체결 완료 내역
[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거래 BTC 수량
price1BTC당 거래 금액
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거래 수수료
balanceBTC 잔액
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
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_btc전체 BTC
total_krw전체 KRW
in_use_btc사용중 BTC
in_use_krw사용중 KRW
available_btc사용 가능 BTC
available_krw사용 가능 KRW
misu_btc신용거래 BTC
misu_krw신용거래 KRW
xcoin_lastbithumb 마지막 거래체결 금액
misu_depo_krw미수 증거금
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
currencyStringBTC (현재 bithumb에서 제공하는 암호화 화페 BTC)
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
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
currencyStringBTC (현재 bithumb에서 제공하는 암호화 화페 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시간 내 BTC 거래량
volume_1day최근 1일간 BTC 거래량
volume_7day최근 7일간 BTC 거래량
date현재 시간 Timestamp
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_currencyStringBTC (현재 bithumb에서 제공하는 암호화 화페 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거래요청 BTC
units_remaining주문 체결 잔액
price1BTC당 거래금액
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)
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거래 BTC 수량
price거래금액
btc1krw1BTC당 거래금액
fee거래수수료
btc_remain거래 후 BTC 잔액
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입금중
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체결 수량
price1BTC당 체결가
totalKRW 체결가
fee수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
Order_currencyStringBTC (기본값)
Payment_currencyStringKRW (기본값)
unitsFloat주문 BTC 수량 (0.001 ~ 999.99999999)
priceInt1BTC당 거래금액
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
payment_currencyKRW
units_traded체결 수량
price1BTC닻 체결가
fee수수료
total체결가
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
order_idString판/구매 주문 등록된 주문번호
typeString거래유형 (bid : 구매, ask : 판매)
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판/구매 주문 등록된 주문번호
https://api.bithumb.com/trade/btc_withdrawal더보기
bithumb 회원 btc 출금(회원등급에 따른 BTC 출금)
[Returned Example]
				{
					"status" : "0000"
				}
[Returned Value Description]
Key Name Description
status 결과 상태 코드 (정상 : 0000, 정상이외 코드는 에러 코드 참조)
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloatBTC 출금 하고자 하는 수량(0.01~ 회원등급수량)
addressStringBTC 출금 주소
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총 구매 수량(수수료 포함)
price1BTC당 KRW 시세
total구매 KRW
fee구매 수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloat주문 BTC 수량(0.001~ 999.99999999)
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총 판매 수량(수수료 포함)
price1BTC당 KRW 시세
total판매 KRW
fee판매 수수료
[Request Parameters]
Parameter Name Data Type Description
apiKeyStringapiKey
secretKeyStringscretKey
unitsFloat주문 BTC 수량(0.001 ~ 999.99999999)

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다운로드