Public Api

GET GetCurrencies
Description Uri: https://tradesatoshi.com/api/public/getcurrencies Parameters: None
                {
                "success":true,
                "message":null,
                "result":[
                {
                "currency":"BOLI",
                "currencyLong":"Bolivarcoin",
                "minConfirmation":3,
                "txFee":0.00000000,
                "status":"OK"
                },
                {
                "currency":"BTC",
                "currencyLong":"Bitcoin",
                "minConfirmation":6,
                "txFee":0.00000000,
                "status":"OK"
                }
                ]
                }
                
GET GetTicker
Description Uri: https://tradesatoshi.com/api/public/getticker?market=LTC_BTC Parameters: market: The market name e.g. 'LTC_BTC' (required)
                {
                "success":true,
                "message":null,
                "result":{
                "bid":0.01500000,
                "ask":100.00000000,
                "last":0.01000000,
                "market":"LTC_BTC"
                }
                }
                
GET GetMarketHistory
Description Uri: https://tradesatoshi.com/api/public/getmarkethistory?market=LTC_BTC&count=20 Parameters: market: The market name e.g. 'LTC_BTC' (required) count: The max amount of records to return (optional, default: 20)
                {
                "success":true,
                "message":null,
                "result":[{
                "id":512,
                "timeStamp":"2016-04-28T01:34:02.397",
                "quantity":0.00784797,
                "price":0.01000000,
                "orderType":"Buy",
                "total":0.00007848
                },
                {
                "id":503,
                "timeStamp":"2016-04-23T08:16:38.087",
                "quantity":0.00134797,
                "price":0.08555000,
                "orderType":"Buy",
                "total":0.00011532
                },
                {
                "id":502,
                "timeStamp":"2016-04-23T08:16:34.91",
                "quantity":0.00650000,
                "price":0.07900000,
                "orderType":"Buy",
                "total":0.00051350
                }]
                }
                
GET GetMarketSummary
Description Uri: https://tradesatoshi.com/api/public/getmarketsummary?market=LTC_BTC Parameters: market: The market name e.g. 'LTC_BTC' (required)
                {
                "success":true,
                "message":null,
                "result":{
                "market":"LTC_BTC",
                "high":0.01000000,
                "low":0.01000000,
                "volume":0.00784797,
                "baseVolume":0.00007848,
                "last":0.01000000,
                "bid":0.01500000,
                "ask":100.00000000,
                "openBuyOrders":2,
                "openSellOrders":7
                }
                }
                
GET GetMarketSummaries
Description Uri: https://tradesatoshi.com/api/public/getmarketsummaries Parameters: None
                {
                "success":true,
                "message":null,
                "result":[
                {
                "market":"TRAD_BTC",
                "high":0.00000000,
                "low":0.00000000,
                "volume":0.00000000,
                "baseVolume":0.00000000,
                "last":0.00000000,
                "bid":0.00000000,
                "ask":0.00000000,
                "openBuyOrders":0,
                "openSellOrders":0
                },
                {
                "market":"BUMBA_BTC",
                "high":0.00000000,
                "low":0.00000000,
                "volume":0.00000000,
                "baseVolume":0.00000000,
                "last":0.00000000,
                "bid":0.00000000,
                "ask":0.00000000,
                "openBuyOrders":0,
                "openSellOrders":0
                }]
                }
                
GET GetOrderBook
Description Uri: https://tradesatoshi.com/api/public/getorderbook?market=LTC_BTC&type=both&depth=20 Parameters: market: The market name e.g. 'LTC_BTC' (required) type: The order book type 'buy', 'sell', 'both' (optional, default: 'both') depth: Max of records to return (optional, default: 20)
                {
                "success":true,
                "message":null,
                "result":{
                "buy":[
                {
                "quantity":0.00000000,
                "rate":0.01500000
                },
                {
                "quantity":1.00000000,
                "rate":0.00750000
                }
                ],
                "sell":[
                {
                "quantity":0.00000000,
                "rate":0.00756150
                },
                {
                "quantity":0.00000000,
                "rate":0.00770000
                },
                {
                "quantity":0.00000000,
                "rate":0.01000000
                }
                ]
                }
                }
                

Private API

Authentication

Authenticated methods require the use of an api key and can only be accessed via the POST method.

Authentication Header

Authorization is performed by sending the following variables into the request authentication header:
API_PUBLIC_KEY + ':' + SIGNATURE + ':' + NONCE

Request Signature:

URI:
The uri endpoint e.g. https://tradesatoshi.com/api/private/getbalance
API_PUBLIC_KEY:
Your TradeSatoshi api key
POST_PARAMS:
JSON post parameters (base64 encoded)
NONCE:
Unique indicator for each request.
SIGNATURE:
API_KEY + "POST" + URI + NONCE + POST_PARAMS (signed by secret key according to HMAC-SHA512 method.)
POST GetBalance
Return information for a specific balance Uri: https://tradesatoshi.com/api/private/getbalance Parameters: Currency: The currency of the balance to return e.g. 'BTC' (required)
{  
   "success":true,
   "message":null,
   "result": {  
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Avaliable": 49.00000000,
         "Total": 53.00000000,
         "HeldForTrades": 1.00000000,
         "Unconfirmed": 1.00000000,
         "PendingWithdraw": 1.00000000,
         "Address": "1HB5XMLmzFVj8ALj6mfBsbifRoD4miY36v"
      }
}
POST GetBalances
Return information for a all balances Uri: https://tradesatoshi.com/api/private/getbalances Parameters: None
{  
   "success":true,
   "message":null,
   "result":[{  
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Avaliable": 49.00000000,
         "Total": 53.00000000,
         "HeldForTrades": 1.00000000,
         "Unconfirmed": 1.00000000,
         "PendingWithdraw": 1.00000000,
         "Address": "1HB5XMLmzFVj8ALj6mfBsbifRoD4miY36v"
      },{  
         "Currency": "LTC",
         "CurrencyLong": "Litecoin",
         "Avaliable": 49.00000000,
         "Total": 53.00000000,
         "HeldForTrades": 1.00000000,
         "Unconfirmed": 1.00000000,
         "PendingWithdraw": 1.00000000,
         "Address": "3KBUuGko4H5ke7EVsq9B7PLK1c5Askdd7y"
      }, ......
   ]
}
POST GetOrder
Description Uri: https://tradesatoshi.com/api/private/getorder Parameters: OrderId: The order to return (required)
{  
   "success":true,
   "message":null,
   "result":{  
         "Id": "18253",
         "Market": "LTC_BTC",
         "Type": "Buy",
         "Amount": 100.00000000,
         "Rate": 0.01000000,
         "Remaining": 0.50000000,
         "Total": 1.00000000,
         "Status": "Partial",
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi": true
      }
}
POST GetOrders
Description Uri: https://tradesatoshi.com/api/private/getorders Parameters: Market: The market name e.g. 'LTC_BTC' (optional, default: 'all') Count: The maximum count of records to return (optional, deefault: 20)
{  
   "success":true,
   "message":null,
   "result": [{  
         "Id": "18253",
         "Market": "LTC_BTC",
         "Type": "Buy",
         "Amount": 100.00000000,
         "Rate": 0.01000000,
         "Remaining": 0.50000000,
         "Total": 1.00000000,
         "Status": "Partial",
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi": true
      },{  
         "Id": "18253",
         "Market": "LTC_BTC",
         "Type": "Buy",
         "Amount": 100.00000000,
         "Rate": 0.01000000,
         "Remaining": 0.50000000,
         "Total": 1.00000000,
         "Status": "Partial",
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi": true
      }, ....
   ]
}
POST SubmitOrder
Description Uri: https://tradesatoshi.com/api/private/submitorder Parameters: Market: The market name e.g. 'LTC_BTC' (required) Type: The order type name e.g. 'Buy', 'Sell' (required) Amount: The amount to buy/sell (required) Price: The price to buy/sell for (required)
{  
   "success":true,
   "message":null,
   "result":{
         "OrderId": 343526,
         "Filled":[24124,41284,57548]
    }
}
POST CancelOrder
Description Uri: https://tradesatoshi.com/api/private/cancelorder Parameters: Type: The cancel type, options: 'Single','Market','MarketBuys','MarketSells','AllBuys','AllSells','All'(required) OrderId: The order to cancel(required if cancel type 'Single') Market: The order to cancel(required if cancel type 'Market','MarketBuys','MarketSells')
{  
   "success":true,
   "message":null,
   "result": {
         "CanceledOrders": [233544, 233545, 233546]
   }
}
POST GetTradeHistory
Description Uri: https://tradesatoshi.com/api/private/gettradehistory Parameters: Market: The market name e.g. 'LTC_BTC' (optional, default: 'all') Count: The maximum count of records to return (optional, default: 20)
{  
   "success":true,
   "message":null,
   "result": [{  
         "Id": "18253",
         "Market": "LTC_BTC",
         "Type": "Buy",
         "Amount": 100.00000000,
         "Rate": 0.01000000,
         "Fee": 0.00020000,
         "Total": 0.99980000,
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi": true
      },{  
         "Id": "18253",
         "Market": "LTC_BTC",
         "Type": "Buy",
         "Amount": 100.00000000,
         "Rate": 0.01000000,
         "Fee": 0.00020000,
         "Total": 0.99980000,
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi": true
      }, ....
   ]
}
POST GenerateAddress
Description Uri: https://tradesatoshi.com/api/private/generateaddress Parameters: Currency: The currency to generate address for e.g. 'BTC' (required)
{  
   "success":true,
   "message":null,
   "result": {  
         "Currency": "LTC",
         "Address": "3KBUuGko4H5ke7EVsq9B7PLK1c5Askdd7y"
      }
}
POST SubmitWithdraw
Description Uri: https://tradesatoshi.com/api/private/submitwithdraw Parameters: Currency: The currency name e.g. 'BTC' (required) Address: The receiving address (required) Amount: The amount to withdraw (required)
{  
   "success":true,
   "message":null,
   "result": {
         "WithdrawalId": 546474
   }
}
POST GetDeposits
Description Uri: https://tradesatoshi.com/api/private/getdeposits Parameters: Currency: The currency name e.g. 'BTC' (optional, default: 'all') Count: The maximum count of records to return (optional, default: 20)
{  
   "success":true,
   "message":null,
   "result": [{  
         "Id": "436436",
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Amount": 100.00000000,
         "Status": "Unconfirmed",
         "Txid": "9281eacaad58335b884adc24be884c00200a4fc17b2e05c72e255976223de187",
         "Confirmations": 0,
         "Timestamp": "2015-12-07T20:04:05.3947572"
      },{  
         "Id": "436437",
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Amount": 100.00000000,
         "Status": "Confirmed",
         "Txid": "6ddbaca454c97ba4e8a87a1cb49fa5ceace80b89eaced84b46a8f52c2b8c8ca3",
         "Confirmations": 12,
         "Timestamp": "2015-12-07T20:04:05.3947572"
      }, ....
   ]
}
POST GetWithdrawals
Description Uri: https://tradesatoshi.com/api/private/getwithdrawals Parameters: Currency: The currency name e.g. 'BTC' (optional, default: 'all') Count: The maximum count of records to return (optional, default: 20)
{  
   "success":true,
   "message":null,
   "result": [{  
         "Id": "436436",
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Amount": 100.00000000,
         "Fee": 0.00040000,
         "Address": "3KBUuGko4H5ke7EVsq9B7PLK1c5Askdd7y"
         "Status": "Unconfirmed",
         "Txid": null,
         "Confirmations": 0,
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi" : false
      },{  
         "Id": "436437",
         "Currency": "BTC",
         "CurrencyLong": "Bitcoin",
         "Amount": 100.00000000,
         "Fee": 0.00040000,
         "Address": "3KBUuGko4H5ke7EVsq9B7PLK1c5Askdd7y",
         "Status": "Complete",
         "Txid": "9281eacaad58335b884adc24be884c00200a4fc17b2e05c72e255976223de187",
         "Confirmations": 12,
         "Timestamp": "2015-12-07T20:04:05.3947572",
         "IsApi" : false
      }, ....
   ]
}