-
Notifications
You must be signed in to change notification settings - Fork 12
Bittrex API Reference (Unofficial)
This section contains the endpoints from bittrex servers in a schematic way and with examples reported.
Have in mind all endpoints are gathered using Chrome Developer Tools on Bittrex Website and can change, since API v2.0 is not officially shipped.
Pings the API to check if they are up.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
Response: "pong"
}Gets the version of the API from their servers.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
version : 2.11 // API version
}Gets the Bittrex BTC Price in USD.
URL |
|
METHOD |
|
PARAMS |
None |
EXAMPLE |
RESPONSE :
{
success : true,
message : "",
result : {
bpi : { // ???
USD : { // USD data
code: "USD",
description: "United States Dollar",
rate: "2,782.6863",
rate_float: 2782.6863
},
disclaimer: "This data was produced from the CoinDesk Bitcoin Price Index (USD). Non-USD currency data converted using hourly conversion rate from openexchangerates.org"
},
time : { //time data of operation on coin
updated: "Jul 24, 2017 16:33:00 UTC",
updatedISO: "2017-07-24T16:33:00+00:00",
updateduk: "Jul 24, 2017 at 17:33 BST"
}
}
}Gets all currencies data.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
message : '',
success : true,
result : [ //array
{ // Market object
Currency : "BTC",
CurrencyLong : "Bitcoin",
MinConfirmation : 2,
TxFee : 0.001,
IsActive : true,
CoinType : "BITCOIN",
BaseAddress : "1N52wHoVR79PMDishab2XmRHsbekCdGquK",
Notice : null
},
...
{ ... }]
}Gets all markets data.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
message : '',
success : true,
result : [ //array
{ // Market object
BaseCurrency : "BITCNY",
BaseCurrencyLong : "BitCNY",
Created : "2015-12-11T06:31:40.653",
IsActive : true,
IsSponsored : null,
LogoUrl : null,
MarketCurrency : "BTC",
MarketCurrencyLong : "Bitcoin",
MarketName : "BITCNY-BTC",
MinTradeSize : 1e-8,
Notice : ""
}
},
...
{ ... }]
}Gets all the market summaries.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
message : '',
success : true,
result : [
{
IsVerified : false,
Market : { // Market object
BaseCurrency : "BITCNY",
BaseCurrencyLong : "BitCNY",
Created : "2015-12-11T06:31:40.653",
IsActive : true,
IsSponsored : null,
LogoUrl : null,
MarketCurrency : "BTC",
MarketCurrencyLong : "Bitcoin",
MarketName : "BITCNY-BTC",
MinTradeSize : 1e-8,
Notice : ""
},
Summary : { //MarketSummary object
Ask: 18619.09547372,
BaseVolume: 16801.39641099,
Bid: 18101.72000003,
Created: "2015-12-11T06:31:40.653",
High: 18989.52,
Last: 18359.80273687,
Low: 17600.14,
MarketName: "BITCNY-BTC",
OpenBuyOrders: 440,
OpenSellOrders: 237,
PrevDay: 18100,
TimeStamp: "2017-07-24T16:24:28.54",
Volume: 0.91026451
}
},
...
{ ... }]
}Gets the summary of a single market.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
message : '',
success : true,
result : {
MarketName: "BTC-ETH",
High: 0.07817998,
Low: 0.06604577,
Volume: 45628.13656093,
Last: 0.07067988,
BaseVolume: 3289.09283520,
TimeStamp: "2017-07-28T20:28:27.797",
Bid: 0.07067989,
Ask: 0.07089528,
OpenBuyOrders: 2743,
OpenSellOrders: 14066,
PrevDay: 0.07800000,
Created: "2015-08-14T09:02:24.817"
}
}Gets the candles for a market.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
success : true,
message : "",
result : [ // Array of candle objects.
{
BV: 13.14752793, // base volume
C: 0.000121, // close
H: 0.00182154, // high
L: 0.0001009, // low
O: 0.00182154, // open
T: "2017-07-16T23:00:00", // timestamp
V: 68949.3719684 // 24h volume
},
...
{ ... }]
}Gets the last candle for a market.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
success: true,
message: "",
result: [ //array with a single element, candle object
{
O: 0.00007687,
H: 0.00007687,
L: 0.00007345,
C: 0.00007586,
V: 125354.20568187,
T: "2017-07-24T16:30:00",
BV: 9.38510573
}]
}Gets the history of a specified market.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably |
RESPONSE :
{
success : true,
message : "",
result : [ // Array of Order objects
{
Id : 106193509,
TimeStamp : "2017-08-29T18:54:42.613",
Quantity : 0.09456326,
Price : 0.08099999,
Total : 0.00765962,
FillType : "FILL",
OrderType : "BUY"
},
...
{ ... }]
}Gets the full order history of the user.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably requires authentication. |
RESPONSE :
{
success : true,
message : "",
result : [ //array of orders
{
Closed: "2017-07-23T21:01:04.65",
Commission: 0.00024937,
Condition: "NONE",
ConditionTarget: null,
Exchange: "BTC-RDD",
ImmediateOrCancel: false,
IsConditional: false,
Limit: 4.8e-7,
OrderType: "LIMIT_BUY",
OrderUuid: "44e8751c-3df8-4a75-841b-c7c2145b746b",
Price: 0.09975,
PricePerUnit: 4.8e-7,
Quantity: 207812.5,
QuantityRemaining: 0,
TimeStamp: "2017-07-23T18:17:40.387"
},
...
{ ... }]
}Creates a buy order.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably requires authentication. |
RESPONSE :
{
success : true,
message : "",
result : { //results are different from example, this is a real response from a real request.
BuyOrSell: "Buy",
MarketCurrency: "DGB",
MarketName: "BTC-DGB",
OrderId: "cb31d615-91eb-408f-87c3-b35b7d751817",
OrderType: "LIMIT",
Quantity: 49875,
Rate:1e-8
}
}Creates a sell order
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably requires authentication. |
RESPONSE :
{
success : true,
message : "",
result : { //results are different from example, this is a real response from a real request.
BuyOrSell: "Sell",
MarketCurrency: "DGB",
MarketName: "BTC-DGB",
OrderId: "HIDDEN_FOR_PRIVACY",
OrderType: "LIMIT",
Quantity: 49875,
Rate:1e-8
}
}Cancels a submitted order.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
|
COMMENT |
Probably requires authentication. |
RESPONSE :
{
success: true,
message: "",
result:null
}Gets info about a coin.
URL |
|
METHOD |
|
PARAMS |
|
EXAMPLE |
POST |
COMMENT |
Probably this request requires authentication. |
RESPONSE :
{
success : true,
message : "",
result : {
BaseAddress:"0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98",
CoinType: "ETH_CONTRACT",
Currency: "CVC",
CurrencyLong: "Civic"
Health : { // CoinHealth object
BlockHeight: 4067747,
Currency: "CVC",
DepositQueueDepth: 0,
IsActive: true,
LastChecked: "2017-07-24T16:53:00.33",
MinutesSinceBHUpdated: 0,
WalletBalance: 0,
WalletConnections: 0,
WithdrawQueueDepth: 0
},
IsActive: true,
MinConfirmation: 36,
Notice: null,
TxFee: 0.01
}
}Response Type is application/json in case of status code 200 (OK)
while it is text/html in case of error 404 (checked 07/24/2017)
It also seems all URLS are case insensitive, so for example:
https://bittrex.com/Api/v2.0/pub/currencies/GetBTCPrice equals to https://bittrex.com/api/v2.0/pub/currencies/getbtcprice
Private API requires HMAC signature, like v1.1
Golang Bittrex API v2.0.
This wiki has been provided to you by The Bot Guy <[email protected]>
Please check out the license (GPLv3) and respect it.