Institutions Pro traders Mobile app Bitstamp earn Markets Blog Tradeview Log in Get started HTTP API Websocket API v2 FIX API What is API Request limits Public data functions Ticker Hourly ticker Order book Transactions Trading pairs info OHLC data EUR/USD conversion rate API authentication Private Functions Account balance User transactions Crypto transactions Orders Withdrawal requests Crypto withdrawals Crypto deposits Transfer balance from Sub to Main Account Transfer balance from Main to Sub Account Open bank withdrawal Bank withdrawal status Cancel bank withdrawal New liquidation address Liquidation address info Websockets token WHAT IS API? Bitstamp application programming interface (API) allows our clients to access and control their accounts, using custom written software. API v1 authentication and v1 endpoints are being deprecated and are no longer documented on this page. For now you can still access API v1 documentation here. REQUEST LIMITS Do not make more than 8000 requests per 10 minutes or we will ban your IP address. For real time data please refer to the websocket API. PUBLIC DATA FUNCTIONS Ticker Passing any GET parameters, will result in your request being rejected. Request GET https://www.bitstamp.net/api/v2/ticker/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Response (JSON) last Last BTC price. high Last 24 hours price high. low Last 24 hours price low. vwap Last 24 hours volume weighted average price. volume Last 24 hours volume. bid Highest buy order. ask Lowest sell order. timestamp Unix timestamp date and time. open First price of the day. Hourly ticker Passing any GET parameters, will result in your request being rejected. Request GET https://www.bitstamp.net/api/v2/ticker_hour/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Response (JSON) Returns a JSON dictionary like the ticker call, with the calculated values being from within an hour. Order book Request GET https://www.bitstamp.net/api/v2/order_book/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters group (Optional) The group parameter is used for accessing different data from order book. Possible values are 0 (orders are not grouped at same price), 1 (orders are grouped at same price - default) or 2 (orders with their order ids are not grouped at same price). Response (JSON): success Using optional group parameter with value 2 response will also have "microtimestamp" - when order book was generated and "bids" and "asks" list of orders will show price, amount and order id for each order. Response (JSON): failure status "error" reason The reason for the error. Order_book errors Transactions Request GET https://www.bitstamp.net/api/v2/transactions/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters time (Optional) The time interval from which we want the transactions to be returned. Possible values are minute, hour (default) or day. Response (JSON) - descending list of transactions. Every transaction dictionary contains: date Unix timestamp date and time. tid Transaction ID. price BTC price. amount BTC amount. type 0 (buy) or 1 (sell). Trading pairs info Request GET https://www.bitstamp.net/api/v2/trading-pairs-info/ Response (JSON) - list of trading pairs. Every trading pair dictionary contains: name Trading pair. url_symbol URL symbol of trading pair. base_decimals Decimal precision for base currency (BTC/USD - base: BTC). counter_decimals Decimal precision for counter currency (BTC/USD - counter: USD). minimum_order Minimum order size. trading Trading engine status (Enabled/Disabled). instant_and_market_orders Instant and market orders status (Enabled/Disabled). description Trading pair description. OHLC data Request GET https://www.bitstamp.net/api/v2/ohlc/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters start (Optional) Unix timestamp from when OHLC data will be started. end (Optional) Unix timestamp to when OHLC data will be shown. If none from start or end timestamps are posted then endpoint returns OHLC data to current unixtime. If both start and end timestamps are posted, end timestamp will be used. step Timeframe in seconds. Possible options are 60, 180, 300, 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400, 259200 limit Limit OHLC results (minimum: 1; maximum: 1000) Response (JSON): success - Returns a dictionary of tick data for selected trading pair. Each tick in the dictionary is represented as a list of OHLC data. pair Trading pair high Price high timestamp Unix timestamp date and time volume Volume low Price low close Closing price open Opening price Response (JSON): failure code "Error code" errors List with 'field', 'message' and 'code' fields. OHLC errors EUR/USD conversion rate Request GET https://www.bitstamp.net/api/v2/eur_usd/ Response (JSON) buy Buy conversion rate. sell Sell conversion rate. API authentication All private API calls require authentication. For a successful authentication you need to provide the following authorization headers in your request: Request headers X-Auth "BITSTAMP" + " " + api_key X-Auth-Signature sha256.hmac(string_to_sign, api_secret) X-Auth-Nonce Client generated random nonce: - lowercase, - 36 char string, - each nonce can be used only once within a timeframe of 150 seconds. Example: "f93c979d-b00d-43a9-9b9c-fd4cd9547fa6" X-Auth-Timestamp Request departure timestamp UTC in milliseconds. If timestamp is more than 150 seconds from current server time, it will not allow to make the request. Example: "1567755304968" X-Auth-Version "v2" Content-Type "Please note that you do not need to set Content-Type header if there is no body." string_to_sign is your signature message. Content-Type should not be added to the string if request.body is empty. The following have to be combined into a single string: PYTHON "BITSTAMP" + " " + api_key + \ HTTP Verb + \ url.host + \ url.path + \ url.query + \ Content-Type + \ X-Auth-Nonce + \ X-Auth-Timestamp + \ X-Auth-Version + \ request.body Below are the details describing each part of the signature message. string_to_sign "BITSTAMP" + " " + "$apiKey" Same as authorization header. HTTP Verb The HTTP (uppercase) verb. Example: "GET", "POST" url.host The hostname (lowercase), matching the HTTP "Host" request header field (including any port number). Example: "www.bitstamp.net" url.path The HTTP request path with leading slash. Example: "/api/v2/balance/" url.query Any query parameters or empty string. This should be the exact string sent by the client, including urlencoding. Example: "?limit=100&sort=asc" Content-Type Same as authorization header. X-Auth-Nonce Same as authorization header. X-Auth-Timestamp Same as authorization header. X-Auth-Version Same as authorization header. request.body As is. Authentication errors Authentication examples: PYTHON import hashlib import hmac import time import requests import uuid import sys api_key = 'api_key' API_SECRET = b'api_key_secret' timestamp = str(int(round(time.time() * 1000))) nonce = str(uuid.uuid4()) content_type = 'application/x-www-form-urlencoded' payload = {'offset': '1'} if sys.version_info.major >= 3: from urllib.parse import urlencode else: from urllib import urlencode payload_string = urlencode(payload) # '' (empty string) in message represents any query parameters or an empty string in case there are none message = 'BITSTAMP ' + api_key + \ 'POST' + \ 'www.bitstamp.net' + \ '/api/v2/user_transactions/' + \ '' + \ content_type + \ nonce + \ timestamp + \ 'v2' + \ payload_string message = message.encode('utf-8') signature = hmac.new(API_SECRET, msg=message, digestmod=hashlib.sha256).hexdigest() headers = { 'X-Auth': 'BITSTAMP ' + api_key, 'X-Auth-Signature': signature, 'X-Auth-Nonce': nonce, 'X-Auth-Timestamp': timestamp, 'X-Auth-Version': 'v2', 'Content-Type': content_type } r = requests.post( 'https://www.bitstamp.net/api/v2/user_transactions/', headers=headers, data=payload_string ) if not r.status_code == 200: raise Exception('Status code not 200') string_to_sign = (nonce + timestamp + r.headers.get('Content-Type')).encode('utf-8') + r.content signature_check = hmac.new(API_SECRET, msg=string_to_sign, digestmod=hashlib.sha256).hexdigest() if not r.headers.get('X-Server-Auth-Signature') == signature_check: raise Exception('Signatures do not match') print(r.content) JAVA package com.example.AuthenticationExample; import org.apache.commons.codec.binary.Hex; import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.util.UUID; public class Authentication { public static void main(String[] args) { String apiKey = String.format("%s %s", "BITSTAMP", "api_key"); String apiKeySecret = "api_key_secret"; String httpVerb = "POST"; String urlHost = "www.bitstamp.net"; String urlPath = "/api/v2/user_transactions/"; String urlQuery = ""; String timestamp = String.valueOf(System.currentTimeMillis()); String nonce = UUID.randomUUID().toString(); String contentType = "application/x-www-form-urlencoded"; String version = "v2"; String payloadString = "offset=1"; String signature = apiKey + httpVerb + urlHost + urlPath + urlQuery + contentType + nonce + timestamp + version + payloadString; try { SecretKeySpec secretKey = new SecretKeySpec(apiKeySecret.getBytes(), "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(secretKey); byte[] rawHmac = mac.doFinal(signature.getBytes()); signature = new String(Hex.encodeHex(rawHmac)).toUpperCase(); HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://www.bitstamp.net/api/v2/user_transactions/")) .POST(HttpRequest.BodyPublishers.ofString(payloadString)) .setHeader("X-Auth", apiKey) .setHeader("X-Auth-Signature", signature) .setHeader("X-Auth-Nonce", nonce) .setHeader("X-Auth-Timestamp", timestamp) .setHeader("X-Auth-Version", version) .setHeader("Content-Type", contentType) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); if (response.statusCode() != 200) { throw new RuntimeException("Status code not 200"); } String serverSignature = response.headers().map().get("x-server-auth-signature").get(0); String responseContentType = response.headers().map().get("Content-Type").get(0); String stringToSign = nonce + timestamp + responseContentType + response.body(); mac.init(secretKey); byte[] rawHmacServerCheck = mac.doFinal(stringToSign.getBytes()); String newSignature = new String(Hex.encodeHex(rawHmacServerCheck)); if (!newSignature.equals(serverSignature)) { throw new RuntimeException("Signatures do not match"); } System.out.println(response.body()); } catch (Exception e) { throw new RuntimeException(e); } } } C++ #include <curl/curl.h> #include <openssl/hmac.h> #include <uuid/uuid.h> #include <iostream> #include <string> #include <chrono> #include <iomanip> static size_t write_call_back(void *contents, size_t size, size_t nmemb, void *userp) { ((std::string*)userp)->append((char*)contents, size * nmemb); return size * nmemb; } std::string b2a_hex(char *byte_arr, int n) { const static std::string hex_codes = "0123456789abcdef"; std::string hex_string; for ( int i = 0; i < n ; ++i ) { unsigned char bin_value = byte_arr[i]; hex_string += hex_codes[( bin_value >> 4 ) & 0x0F]; hex_string += hex_codes[bin_value & 0x0F]; } return hex_string; } std::string url_encode(std::string data) { std::string res = data; CURL *curl = curl_easy_init(); if(curl) { char *output = curl_easy_escape(curl, data.c_str(), data.length()); if(output) { res = output; curl_free(output); } } return res; } int main() { const std::string api_key = "api_key"; const std::string api_secret = "api_key_secret"; std::chrono::milliseconds timestamp = std::chrono::duration_cast< std::chrono::milliseconds >( std::chrono::system_clock::now().time_since_epoch() ); uuid_t uuid; uuid_string_t nonce; uuid_generate(uuid); uuid_unparse_lower(uuid, nonce); std::string x_auth = "BITSTAMP " + api_key; std::string x_auth_nonce = nonce; std::string x_auth_timestamp = std::to_string(timestamp.count()); std::string x_auth_version = "v2"; std::string content_type = "application/x-www-form-urlencoded"; std::string payload = url_encode("{offset:1}"); std::string http_method = "POST"; std::string url_host = "www.bitstamp.net"; std::string url_path = "/api/v2/user_transactions/"; std::string url_query = ""; std::string data_to_sign = ""; data_to_sign.append(x_auth); data_to_sign.append(http_method); data_to_sign.append(url_host); data_to_sign.append(url_path); data_to_sign.append(url_query); data_to_sign.append(content_type); data_to_sign.append(x_auth_nonce); data_to_sign.append(x_auth_timestamp); data_to_sign.append(x_auth_version); data_to_sign.append(payload); // calculate hmac signature unsigned char* result; unsigned int len = 20; result = (unsigned char*)malloc(sizeof(char) * len); HMAC_CTX ctx; HMAC_CTX_init(&ctx); HMAC_Init_ex(&ctx, api_secret.c_str(), api_secret.length(), EVP_sha256(), NULL); HMAC_Update(&ctx, (unsigned char*)data_to_sign.c_str(), data_to_sign.length()); HMAC_Final(&ctx, result, &len); HMAC_CTX_cleanup(&ctx); std::string x_auth_signature = b2a_hex( (char *)result, 32 ); free(result); // send request CURL *curl; CURLcode res; std::string read_buffer; curl = curl_easy_init(); if(curl) { struct curl_slist *headers = NULL; headers = curl_slist_append(headers, ("X-Auth: " + x_auth).c_str()); headers = curl_slist_append(headers, ("X-Auth-Signature: " + x_auth_signature).c_str()); headers = curl_slist_append(headers, ("X-Auth-Nonce: " + x_auth_nonce).c_str()); headers = curl_slist_append(headers, ("X-Auth-Timestamp: " + x_auth_timestamp).c_str()); headers = curl_slist_append(headers, ("X-Auth-Version: " + x_auth_version).c_str()); headers = curl_slist_append(headers, ("Content-Type: " + content_type).c_str()); std::string url = "https://" + url_host + url_path + url_query; curl_easy_setopt(curl, CURLOPT_URL, url.c_str()); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload.c_str()); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_call_back); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &read_buffer); res = curl_easy_perform(curl); if(res != CURLE_OK) { std::cout << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl; } std::cout << "curl_easy_perform() response: " << read_buffer << std::endl; curl_easy_cleanup(curl); } return 0; } Private Functions Account balance This API call is cached for 10 seconds. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/balance/ Returns all the balances. POST https://www.bitstamp.net/api/v2/balance/{currency_pair}/ Returns the values relevant to the specified currency_pair parameter. Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Response (JSON) usd_balance USD balance. btc_balance BTC balance. eur_balance EUR balance. xrp_balance XRP balance. usd_reserved USD reserved. btc_reserved BTC reserved. eur_reserved EUR reserved. xrp_reserved XRP reserved. usd_available USD available for trading. btc_available BTC available for trading. eur_available EUR available for trading. xrp_available XRP available for trading. gbp_balance GBP balance. bch_balance BCH balance. eth_balance ETH balance. ltc_balance LTC balance. pax_balance PAX balance. xlm_balance XLM balance. eth2_balance ETH2 balance. eth2r_balance ETH2R balance. link_balance LINK balance. omg_balance OMG balance. usdc_balance USDC balance. aave_balance AAVE balance. bat_balance BAT balance. uma_balance UMA balance. dai_balance DAI balance. knc_balance KNC balance. mkr_balance MKR balance. zrx_balance ZRX balance. gusd_balance GUSD balance. algo_balance ALGO balance. audio_balance AUDIO balance. crv_balance CRV balance. snx_balance SNX balance. uni_balance UNI balance. yfi_balance YFI balance. comp_balance COMP balance. grt_balance GRT balance. usdt_balance USDT balance. eurt_balance EURT balance. matic_balance MATIC balance. sushi_balance SUSHI balance. chz_balance CHZ balance. enj_balance ENJ balance. hbar_balance HBAR balance. alpha_balance ALPHA balance. axs_balance AXS balance. ftt_balance FTT balance. sand_balance SAND balance. storj_balance STORJ balance. ada_balance ADA balance. fet_balance FET balance. rgt_balance RGT balance. skl_balance SKL balance. cel_balance CEL balance. slp_balance SLP balance. sxp_balance SXP balance. gbp_reserved GBP reserved. bch_reserved BCH reserved. eth_reserved ETH reserved. ltc_reserved LTC reserved. pax_reserved PAX reserved. xlm_reserved XLM reserved. eth2_reserved ETH2 reserved. eth2r_reserved ETH2R reserved. link_reserved LINK reserved. omg_reserved OMG reserved. usdc_reserved USDC reserved. aave_reserved AAVE reserved. bat_reserved BAT reserved. uma_reserved UMA reserved. dai_reserved DAI reserved. knc_reserved KNC reserved. mkr_reserved MKR reserved. zrx_reserved ZRX reserved. gusd_reserved GUSD reserved. algo_reserved ALGO reserved. audio_reserved AUDIO reserved. crv_reserved CRV reserved. snx_reserved SNX reserved. uni_reserved UNI reserved. yfi_reserved YFI reserved. comp_reserved COMP reserved. grt_reserved GRT reserved. usdt_reserved USDT reserved. eurt_reserved EURT reserved. matic_reserved MATIC reserved. sushi_reserved SUSHI reserved. chz_reserved CHZ reserved. enj_reserved ENJ reserved. hbar_reserved HBAR reserved. alpha_reserved ALPHA reserved. axs_reserved AXS reserved. ftt_reserved FTT reserved. sand_reserved SAND reserved. storj_reserved STORJ reserved. ada_reserved ADA reserved. fet_reserved FET reserved. rgt_reserved RGT reserved. skl_reserved SKL reserved. cel_reserved CEL reserved. slp_reserved SLP reserved. sxp_reserved SXP reserved. gbp_available GBP available for trading. bch_available BCH available for trading. eth_available ETH available for trading. ltc_available LTC available for trading. pax_available PAX available for trading. xlm_available XLM available for trading. eth2_available ETH2 available for trading. eth2r_available ETH2R available for trading. link_available LINK available for trading. omg_available OMG available for trading. usdc_available USDC available for trading. aave_available AAVE available for trading. bat_available BAT available for trading. uma_available UMA available for trading. dai_available DAI available for trading. knc_available KNC available for trading. mkr_available MKR available for trading. zrx_available ZRX available for trading. gusd_available GUSD available for trading. algo_available ALGO available for trading. audio_available AUDIO available for trading. crv_available CRV available for trading. snx_available SNX available for trading. uni_available UNI available for trading. yfi_available YFI available for trading. comp_available COMP available for trading. grt_available GRT available for trading. usdt_available USDT available for trading. eurt_available EURT available for trading. matic_available MATIC available for trading. sushi_available SUSHI available for trading. chz_available CHZ available for trading. enj_available ENJ available for trading. hbar_available HBAR available for trading. alpha_available ALPHA available for trading. axs_available AXS available for trading. ftt_available FTT available for trading. sand_available SAND available for trading. storj_available STORJ available for trading. ada_available ADA available for trading. fet_available FET available for trading. rgt_available RGT available for trading. skl_available SKL available for trading. cel_available CEL available for trading. slp_available SLP available for trading. sxp_available SXP available for trading. btcusd_fee Customer BTC/USD trading fee. btceur_fee Customer BTC/EUR trading fee. btcgbp_fee Customer BTC/GBP trading fee. btcpax_fee Customer BTC/PAX trading fee. btcusdt_fee Customer BTC/USDT trading fee. btcusdc_fee Customer BTC/USDC trading fee. gbpusd_fee Customer GBP/USD trading fee. gbpeur_fee Customer GBP/EUR trading fee. eurusd_fee Customer EUR/USD trading fee. ethusd_fee Customer ETH/USD trading fee. etheur_fee Customer ETH/EUR trading fee. ethbtc_fee Customer ETH/BTC trading fee. ethgbp_fee Customer ETH/GBP trading fee. ethpax_fee Customer ETH/PAX trading fee. ethusdt_fee Customer ETH/USDT trading fee. ethusdc_fee Customer ETH/USDC trading fee. adausd_fee Customer ADA/USD trading fee. adaeur_fee Customer ADA/EUR trading fee. adabtc_fee Customer ADA/BTC trading fee. xrpusd_fee Customer XRP/USD trading fee. xrpeur_fee Customer XRP/EUR trading fee. xrpbtc_fee Customer XRP/BTC trading fee. xrpgbp_fee Customer XRP/GBP trading fee. xrppax_fee Customer XRP/PAX trading fee. xrpusdt_fee Customer XRP/USDT trading fee. uniusd_fee Customer UNI/USD trading fee. unieur_fee Customer UNI/EUR trading fee. unibtc_fee Customer UNI/BTC trading fee. ltcusd_fee Customer LTC/USD trading fee. ltceur_fee Customer LTC/EUR trading fee. ltcbtc_fee Customer LTC/BTC trading fee. ltcgbp_fee Customer LTC/GBP trading fee. linkusd_fee Customer LINK/USD trading fee. linkeur_fee Customer LINK/EUR trading fee. linkbtc_fee Customer LINK/BTC trading fee. linkgbp_fee Customer LINK/GBP trading fee. linketh_fee Customer LINK/ETH trading fee. maticusd_fee Customer MATIC/USD trading fee. maticeur_fee Customer MATIC/EUR trading fee. xlmusd_fee Customer XLM/USD trading fee. xlmeur_fee Customer XLM/EUR trading fee. xlmbtc_fee Customer XLM/BTC trading fee. xlmgbp_fee Customer XLM/GBP trading fee. fttusd_fee Customer FTT/USD trading fee. ftteur_fee Customer FTT/EUR trading fee. bchusd_fee Customer BCH/USD trading fee. bcheur_fee Customer BCH/EUR trading fee. bchbtc_fee Customer BCH/BTC trading fee. bchgbp_fee Customer BCH/GBP trading fee. aaveusd_fee Customer AAVE/USD trading fee. aaveeur_fee Customer AAVE/EUR trading fee. aavebtc_fee Customer AAVE/BTC trading fee. axsusd_fee Customer AXS/USD trading fee. axseur_fee Customer AXS/EUR trading fee. algousd_fee Customer ALGO/USD trading fee. algoeur_fee Customer ALGO/EUR trading fee. algobtc_fee Customer ALGO/BTC trading fee. compusd_fee Customer COMP/USD trading fee. compeur_fee Customer COMP/EUR trading fee. compbtc_fee Customer COMP/BTC trading fee. snxusd_fee Customer SNX/USD trading fee. snxeur_fee Customer SNX/EUR trading fee. snxbtc_fee Customer SNX/BTC trading fee. hbarusd_fee Customer HBAR/USD trading fee. hbareur_fee Customer HBAR/EUR trading fee. chzusd_fee Customer CHZ/USD trading fee. chzeur_fee Customer CHZ/EUR trading fee. celusd_fee Customer CEL/USD trading fee. celeur_fee Customer CEL/EUR trading fee. enjusd_fee Customer ENJ/USD trading fee. enjeur_fee Customer ENJ/EUR trading fee. batusd_fee Customer BAT/USD trading fee. bateur_fee Customer BAT/EUR trading fee. batbtc_fee Customer BAT/BTC trading fee. mkrusd_fee Customer MKR/USD trading fee. mkreur_fee Customer MKR/EUR trading fee. mkrbtc_fee Customer MKR/BTC trading fee. zrxusd_fee Customer ZRX/USD trading fee. zrxeur_fee Customer ZRX/EUR trading fee. zrxbtc_fee Customer ZRX/BTC trading fee. audiousd_fee Customer AUDIO/USD trading fee. audioeur_fee Customer AUDIO/EUR trading fee. audiobtc_fee Customer AUDIO/BTC trading fee. sklusd_fee Customer SKL/USD trading fee. skleur_fee Customer SKL/EUR trading fee. yfiusd_fee Customer YFI/USD trading fee. yfieur_fee Customer YFI/EUR trading fee. yfibtc_fee Customer YFI/BTC trading fee. sushiusd_fee Customer SUSHI/USD trading fee. sushieur_fee Customer SUSHI/EUR trading fee. alphausd_fee Customer ALPHA/USD trading fee. alphaeur_fee Customer ALPHA/EUR trading fee. storjusd_fee Customer STORJ/USD trading fee. storjeur_fee Customer STORJ/EUR trading fee. sxpusd_fee Customer SXP/USD trading fee. sxpeur_fee Customer SXP/EUR trading fee. grtusd_fee Customer GRT/USD trading fee. grteur_fee Customer GRT/EUR trading fee. umausd_fee Customer UMA/USD trading fee. umaeur_fee Customer UMA/EUR trading fee. umabtc_fee Customer UMA/BTC trading fee. omgusd_fee Customer OMG/USD trading fee. omgeur_fee Customer OMG/EUR trading fee. omgbtc_fee Customer OMG/BTC trading fee. omggbp_fee Customer OMG/GBP trading fee. kncusd_fee Customer KNC/USD trading fee. knceur_fee Customer KNC/EUR trading fee. kncbtc_fee Customer KNC/BTC trading fee. crvusd_fee Customer CRV/USD trading fee. crveur_fee Customer CRV/EUR trading fee. crvbtc_fee Customer CRV/BTC trading fee. sandusd_fee Customer SAND/USD trading fee. sandeur_fee Customer SAND/EUR trading fee. fetusd_fee Customer FET/USD trading fee. feteur_fee Customer FET/EUR trading fee. rgtusd_fee Customer RGT/USD trading fee. rgteur_fee Customer RGT/EUR trading fee. slpusd_fee Customer SLP/USD trading fee. slpeur_fee Customer SLP/EUR trading fee. eurtusd_fee Customer EURT/USD trading fee. eurteur_fee Customer EURT/EUR trading fee. usdtusd_fee Customer USDT/USD trading fee. usdteur_fee Customer USDT/EUR trading fee. usdcusd_fee Customer USDC/USD trading fee. usdceur_fee Customer USDC/EUR trading fee. usdcusdt_fee Customer USDC/USDT trading fee. daiusd_fee Customer DAI/USD trading fee. paxusd_fee Customer PAX/USD trading fee. paxeur_fee Customer PAX/EUR trading fee. paxgbp_fee Customer PAX/GBP trading fee. eth2eth_fee Customer ETH2/ETH trading fee. gusdusd_fee Customer GUSD/USD trading fee. usd_withdrawal_fee Customer USD withdrawal fee. eur_withdrawal_fee Customer EUR withdrawal fee. gbp_withdrawal_fee Customer GBP withdrawal fee. bch_withdrawal_fee Customer BCH withdrawal fee. btc_withdrawal_fee Customer BTC withdrawal fee. eth_withdrawal_fee Customer ETH withdrawal fee. ltc_withdrawal_fee Customer LTC withdrawal fee. pax_withdrawal_fee Customer PAX withdrawal fee. xlm_withdrawal_fee Customer XLM withdrawal fee. xrp_withdrawal_fee Customer XRP withdrawal fee. link_withdrawal_fee Customer LINK withdrawal fee. omg_withdrawal_fee Customer OMG withdrawal fee. usdc_withdrawal_fee Customer USDC withdrawal fee. aave_withdrawal_fee Customer AAVE withdrawal fee. bat_withdrawal_fee Customer BAT withdrawal fee. uma_withdrawal_fee Customer UMA withdrawal fee. dai_withdrawal_fee Customer DAI withdrawal fee. knc_withdrawal_fee Customer KNC withdrawal fee. mkr_withdrawal_fee Customer MKR withdrawal fee. zrx_withdrawal_fee Customer ZRX withdrawal fee. gusd_withdrawal_fee Customer GUSD withdrawal fee. algo_withdrawal_fee Customer ALGO withdrawal fee. audio_withdrawal_fee Customer AUDIO withdrawal fee. crv_withdrawal_fee Customer CRV withdrawal fee. snx_withdrawal_fee Customer SNX withdrawal fee. uni_withdrawal_fee Customer UNI withdrawal fee. yfi_withdrawal_fee Customer YFI withdrawal fee. comp_withdrawal_fee Customer COMP withdrawal fee. grt_withdrawal_fee Customer GRT withdrawal fee. usdt_withdrawal_fee Customer USDT withdrawal fee. eurt_withdrawal_fee Customer EURT withdrawal fee. matic_withdrawal_fee Customer MATIC withdrawal fee. sushi_withdrawal_fee Customer SUSHI withdrawal fee. chz_withdrawal_fee Customer CHZ withdrawal fee. enj_withdrawal_fee Customer ENJ withdrawal fee. hbar_withdrawal_fee Customer HBAR withdrawal fee. alpha_withdrawal_fee Customer ALPHA withdrawal fee. axs_withdrawal_fee Customer AXS withdrawal fee. ftt_withdrawal_fee Customer FTT withdrawal fee. sand_withdrawal_fee Customer SAND withdrawal fee. storj_withdrawal_fee Customer STORJ withdrawal fee. ada_withdrawal_fee Customer ADA withdrawal fee. fet_withdrawal_fee Customer FET withdrawal fee. rgt_withdrawal_fee Customer RGT withdrawal fee. skl_withdrawal_fee Customer SKL withdrawal fee. cel_withdrawal_fee Customer CEL withdrawal fee. slp_withdrawal_fee Customer SLP withdrawal fee. sxp_withdrawal_fee Customer SXP withdrawal fee. Other fee Customer trading fee. Balance errors User transactions This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/user_transactions/ Returns transactions for all currency pairs. POST https://www.bitstamp.net/api/v2/user_transactions/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters offset Skip that many transactions before returning results (default: 0, maximum: 200000). If you need to export older history contact support OR use combination of limit and since_id parameters limit Limit result to that many transactions (default: 100; maximum: 1000). sort Sorting by date and time: asc - ascending; desc - descending (default: desc). since_timestamp (Optional) Show only transactions from unix timestamp (for max 30 days old). since_id (Optional) Show only transactions from specified transaction id. If since_id parameter is used, limit parameter is set to 1000. Response (JSON): success - Returns a descending list of transactions, represented as dictionaries. datetime Date and time. id Transaction ID. type Transaction type: 0 - deposit; 1 - withdrawal; 2 - market trade; 14 - sub account transfer; 25 - credited with staked assets; 26 - sent assets to staking; 27 - staking reward; 32 - referral reward; 35 - inter account transfer. usd USD amount. eur EUR amount. btc BTC amount. xrp XRP amount. gbp GBP amount. bch BCH amount. eth ETH amount. ltc LTC amount. pax PAX amount. xlm XLM amount. eth2 ETH2 amount. eth2r ETH2R amount. link LINK amount. omg OMG amount. usdc USDC amount. aave AAVE amount. bat BAT amount. uma UMA amount. dai DAI amount. knc KNC amount. mkr MKR amount. zrx ZRX amount. gusd GUSD amount. algo ALGO amount. audio AUDIO amount. crv CRV amount. snx SNX amount. uni UNI amount. yfi YFI amount. comp COMP amount. grt GRT amount. usdt USDT amount. eurt EURT amount. matic MATIC amount. sushi SUSHI amount. chz CHZ amount. enj ENJ amount. hbar HBAR amount. alpha ALPHA amount. axs AXS amount. ftt FTT amount. sand SAND amount. storj STORJ amount. ada ADA amount. fet FET amount. rgt RGT amount. skl SKL amount. cel CEL amount. slp SLP amount. sxp SXP amount. btc_usd (or other trading pair used, eg btc_eur) Exchange rate. fee Transaction fee. order_id Executed order ID. Response (JSON): failure status "error" reason The reason for the error. User_transactions errors Crypto transactions This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/crypto-transactions/ Returns data for all cryptocurrency deposits and withdrawals. Request parameters limit Limit result to that many transactions (default: 100; minimum: 1; maximum: 1000). offset Skip that many transactions before returning results (default: 0, maximum: 200000). include_ious (Optional) True - shows also ripple IOU transactions. Response (JSON): success - Returns list of cryptocurrency deposits and withdrawals, where each transaction is represented as a dictionary. currency Currency destinationAddress Destination Address txid Transaction Hash amount Amount datetime Date and Time Response (JSON): failure status "error" reason The reason for the error. Crypto-Transactions errors Open orders This API call is cached for 10 seconds. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/open_orders/all/ Returns data for all currency pairs. POST https://www.bitstamp.net/api/v2/open_orders/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Response (JSON): success - Returns a list of open orders, where each order is represented as a dictionary. id Order ID. datetime Date and time. type Type: 0 - buy; 1 - sell. price Price. amount Amount. currency_pair (if all currency pairs) Currency Pair. client_order_id Client order id. (Only returned if order was placed with client order id parameter.) Response (JSON): failure status "error" reason The reason for the error. Open_orders errors Order status This call will be executed on the account (Sub or Main), to which the used API key is bound to. Order can be fetched by using either id or client_order_id parameter. For closed orders, this call only returns information for the last 30 days. 'Order not found' error will be returned for orders outside this time range. Request POST https://www.bitstamp.net/api/v2/order_status/ Request parameters id Order ID. client_order_id Client order id. (Can only be used if order was placed with client order id parameter.) Response (JSON) status Open, Finished, Expired or Canceled. id Order ID. transactions Each transaction in dictionary is represented as a list of tid, usd, price, fee, btc, datetime and type (0 - deposit; 1 - withdrawal; 2 - market trade). amount_remaining Amount remaining. client_order_id Client order id. (Only returned if order was placed with client order id parameter.) Order_status errors Cancel order This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/cancel_order/ Request parameters id Order ID. Response (JSON): success If https://www.bitstamp.net/api/v2/cancel_order/ id Order id. amount Order amount. price Order price. type Order type. Response (JSON): failure error The reason for the error. Cancel_order errors Cancel all orders This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/cancel_all_orders/ Cancels all orders on an account. POST https://www.bitstamp.net/api/v2/cancel_all_orders/{currency_pair}/ Cancels all orders for specified currency_pair on an account. Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Response (JSON) This call will cancel all open orders. Optionally limited to one currency pair. https://www.bitstamp.net/api/v2/cancel_all_orders/ or https://www.bitstamp.net/api/v2/cancel_all_orders/{currency_pair}/ returns a dictionary with two keys canceled A list of canceled orders. Where each order is represented as a dictionary. An order id Order id. amount Order amount. price Order price. type Order type. currency_pair Currency pair formatted as "BTC/USD". success "true" if all orders were successfully canceled and "false" otherwise. Cancel_all_orders errors Buy limit order This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/buy/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount. price Price. limit_price (Optional) If the order gets executed, a new sell order will be placed, with "limit_price" as its price. daily_order (Optional) Opens buy limit order which will be canceled at 0:00 UTC unless it already has been executed. Possible value: True ioc_order (Optional) An Immediate-Or-Cancel (IOC) order is an order that must be executed immediately. Any portion of an IOC order that cannot be filled immediately will be cancelled. Possible value: True fok_order (Optional) A Fill-Or-Kill (FOK) order is an order that must be executed immediately in its entirety. If the order cannot be immediately executed in its entirety, it will be cancelled. Possible value: True gtd_order (Optional) A Good-Till-Date (GTD) lets you select an expiration date and time up until which the order will be open. Possible value: True expire_time (Optional) Unix timestamp in milliseconds. Required in case of GTD order. client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. Response (JSON): failure status "error" reason The reason for the error. Buy errors Buy market order By placing a market order you acknowledge that the execution of your order depends on the market conditions and that these conditions may be subject to sudden changes that cannot be foreseen. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/buy/market/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount in base currency (Example: For BTC/USD pair, amount is quoted in BTC) Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): failure status "error" reason The reason for the error. Market buy errors Buy instant order By placing an instant order you acknowledge that the execution of your order depends on the market conditions and that these conditions may be subject to sudden changes that cannot be foreseen. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/buy/instant/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount in counter currency (Example: For BTC/USD pair, amount is quoted in USD) Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): failure status "error" reason The reason for the error. Instant buy errors Sell limit order This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/sell/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount. price Price. limit_price (Optional) If the order gets executed, a new buy order will be placed, with "limit_price" as its price. daily_order (Optional) Opens sell limit order which will be canceled at 0:00 UTC unless it already has been executed. Possible value: True ioc_order (Optional) An Immediate-Or-Cancel (IOC) order is an order that must be executed immediately. Any portion of an IOC order that cannot be filled immediately will be cancelled. Possible value: True fok_order (Optional) A Fill-Or-Kill (FOK) order is an order that must be executed immediately in its entirety. If the order cannot be immediately executed in its entirety, it will be cancelled. Possible value: True gtd_order (Optional) A Good-Till-Date (GTD) lets you select an expiration date and time up until which the order will be open. Possible value: True expire_time (Optional) Unix timestamp in milliseconds. Required in case of GTD order. client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. Response (JSON): failure status "error" reason The reason for the error. Sell errors Sell market order By placing a market order you acknowledge that the execution of your order depends on the market conditions and that these conditions may be subject to sudden changes that cannot be foreseen. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/sell/market/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount in base currency (Example: For BTC/USD pair, amount is quoted in BTC) Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): failure status "error" reason The reason for the error. Market sell errors Sell instant order By placing an instant order you acknowledge that the execution of your order depends on the market conditions and that these conditions may be subject to sudden changes that cannot be foreseen. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/sell/instant/{currency_pair}/ Supported values for currency_pair: btcusd, btceur, btcgbp, btcpax, btcusdt, btcusdc, gbpusd, gbpeur, eurusd, ethusd, etheur, ethbtc, ethgbp, ethpax, ethusdt, ethusdc, adausd, adaeur, adabtc, xrpusd, xrpeur, xrpbtc, xrpgbp, xrppax, xrpusdt, uniusd, unieur, unibtc, ltcusd, ltceur, ltcbtc, ltcgbp, linkusd, linkeur, linkbtc, linkgbp, linketh, maticusd, maticeur, xlmusd, xlmeur, xlmbtc, xlmgbp, fttusd, ftteur, bchusd, bcheur, bchbtc, bchgbp, aaveusd, aaveeur, aavebtc, axsusd, axseur, algousd, algoeur, algobtc, compusd, compeur, compbtc, snxusd, snxeur, snxbtc, hbarusd, hbareur, chzusd, chzeur, celusd, celeur, enjusd, enjeur, batusd, bateur, batbtc, mkrusd, mkreur, mkrbtc, zrxusd, zrxeur, zrxbtc, audiousd, audioeur, audiobtc, sklusd, skleur, yfiusd, yfieur, yfibtc, sushiusd, sushieur, alphausd, alphaeur, storjusd, storjeur, sxpusd, sxpeur, grtusd, grteur, umausd, umaeur, umabtc, omgusd, omgeur, omgbtc, omggbp, kncusd, knceur, kncbtc, crvusd, crveur, crvbtc, sandusd, sandeur, fetusd, feteur, rgtusd, rgteur, slpusd, slpeur, eurtusd, eurteur, usdtusd, usdteur, usdcusd, usdceur, usdcusdt, daiusd, paxusd, paxeur, paxgbp, eth2eth, gusdusd Request parameters amount Amount in base currency (Example: For BTC/USD pair, amount is quoted in BTC) amount_in_counter (Optional) Instant sell orders allow you to sell an amount of the base currency determined by the value of it in the counter-currency. Amount_in_counter sets the amount parameter to refer to the counter currency instead of the base currency of the selected trading pair. Possible value: True client_order_id (Optional) Unique client order id set by client. Client order id needs to be unique string. Client order id value can only be used once. Response (JSON): success id Order ID. datetime Date and time. type 0 (buy) or 1 (sell). price Price. amount Amount. Response (JSON): failure status "error" reason The reason for the error. Instant sell errors 'Order could not be placed' error response Should you receive the error response 'Order could not be placed' when trying to place an order, please retry order placement. Withdrawal requests This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/withdrawal-requests/ Request parameters timedelta (Optional, default 86400) Withdrawal requests from number of seconds ago to now (max. 50000000). Response (JSON) id Withdrawal ID. datetime Date and time. type 0 (SEPA), 2 (WIRE transfer), 17 (BCH), 1 (BTC), 16 (ETH), 15 (LTC), 18 (PAX), 19 (XLM), 14 (XRP), 20 (LINK), 21 (OMG), 22 (USDC), 24 (AAVE), 25 (BAT), 26 (UMA), 27 (DAI), 28 (KNC), 29 (MKR), 30 (ZRX), 31 (GUSD), 32 (ALGO), 33 (AUDIO), 34 (CRV), 35 (SNX), 36 (UNI), 38 (YFI), 39 (COMP), 40 (GRT), 42 (USDT), 43 (EURT), 46 (MATIC), 47 (SUSHI), 48 (CHZ), 49 (ENJ), 50 (HBAR), 51 (ALPHA), 52 (AXS), 53 (FTT), 54 (SAND), 55 (STORJ), 56 (ADA), 57 (FET), 58 (RGT), 59 (SKL), 60 (CEL), 61 (SLP), 62 (SXP) currency Currency. amount Amount. status 0 (open), 1 (in process), 2 (finished), 3 (canceled) or 4 (failed). address (crypto withdrawals only) Withdrawal address. transaction_id (crypto withdrawals only) Transaction id. Withdrawal_requests errors Bitcoin Cash withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/bch_withdrawal/ Request parameters amount Bitcoin Cash amount. address Bitcoin Cash address. Response (JSON) id Withdrawal ID. BCH withdrawal errors Bitcoin withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/btc_withdrawal/ Request parameters amount Bitcoin amount. address Bitcoin address. Response (JSON) id Withdrawal ID. BTC withdrawal errors Ether withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/eth_withdrawal/ Request parameters amount Ether amount. address Ether address. Response (JSON) id Withdrawal ID. ETH withdrawal errors Litecoin withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/ltc_withdrawal/ Request parameters amount Litecoin amount. address Litecoin address. Response (JSON) id Withdrawal ID. LTC withdrawal errors Paxos Standard withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/pax_withdrawal/ Request parameters amount Paxos Standard amount. address Paxos Standard address. Response (JSON) id Withdrawal ID. PAX withdrawal errors Stellar Lumens withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/xlm_withdrawal/ Request parameters amount Stellar Lumens amount. address Stellar Lumens address. memo_id (Optional) Address memo id. Response (JSON) id Withdrawal ID. XLM withdrawal errors XRP withdrawal This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/xrp_withdrawal/ Request parameters amount XRP amount. address XRP address. destination_tag (Optional) Address destination tag. Response (JSON) id Withdrawal ID. XRP withdrawal errors Chainlink withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/link_withdrawal/ Request parameters amount Chainlink amount. address Chainlink address. Response (JSON) id Withdrawal ID. LINK withdrawal errors OMG Network withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/omg_withdrawal/ Request parameters amount OMG Network amount. address OMG Network address. Response (JSON) id Withdrawal ID. OMG withdrawal errors USD Coin withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/usdc_withdrawal/ Request parameters amount USD Coin amount. address USD Coin address. Response (JSON) id Withdrawal ID. USDC withdrawal errors AAVE withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/aave_withdrawal/ Request parameters amount AAVE amount. address AAVE address. Response (JSON) id Withdrawal ID. AAVE withdrawal errors Basic Attention Token withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/bat_withdrawal/ Request parameters amount Basic Attention Token amount. address Basic Attention Token address. Response (JSON) id Withdrawal ID. BAT withdrawal errors UMA withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/uma_withdrawal/ Request parameters amount UMA amount. address UMA address. Response (JSON) id Withdrawal ID. UMA withdrawal errors DAI withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/dai_withdrawal/ Request parameters amount DAI amount. address DAI address. Response (JSON) id Withdrawal ID. DAI withdrawal errors Kyber Network withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/knc_withdrawal/ Request parameters amount Kyber Network amount. address Kyber Network address. Response (JSON) id Withdrawal ID. KNC withdrawal errors Maker withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/mkr_withdrawal/ Request parameters amount Maker amount. address Maker address. Response (JSON) id Withdrawal ID. MKR withdrawal errors 0x withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/zrx_withdrawal/ Request parameters amount 0x amount. address 0x address. Response (JSON) id Withdrawal ID. ZRX withdrawal errors Gemini Dollar withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/gusd_withdrawal/ Request parameters amount Gemini Dollar amount. address Gemini Dollar address. Response (JSON) id Withdrawal ID. GUSD withdrawal errors Algorand withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/algo_withdrawal/ Request parameters amount Algorand amount. address Algorand address. Response (JSON) id Withdrawal ID. ALGO withdrawal errors Audius withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/audio_withdrawal/ Request parameters amount Audius amount. address Audius address. Response (JSON) id Withdrawal ID. AUDIO withdrawal errors Curve withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/crv_withdrawal/ Request parameters amount Curve amount. address Curve address. Response (JSON) id Withdrawal ID. CRV withdrawal errors Synthetix withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/snx_withdrawal/ Request parameters amount Synthetix amount. address Synthetix address. Response (JSON) id Withdrawal ID. SNX withdrawal errors Uniswap withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/uni_withdrawal/ Request parameters amount Uniswap amount. address Uniswap address. Response (JSON) id Withdrawal ID. UNI withdrawal errors yearn.finance withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/yfi_withdrawal/ Request parameters amount yearn.finance amount. address yearn.finance address. Response (JSON) id Withdrawal ID. YFI withdrawal errors Compound withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/comp_withdrawal/ Request parameters amount Compound amount. address Compound address. Response (JSON) id Withdrawal ID. COMP withdrawal errors The Graph withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/grt_withdrawal/ Request parameters amount The Graph amount. address The Graph address. Response (JSON) id Withdrawal ID. GRT withdrawal errors Tether withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/usdt_withdrawal/ Request parameters amount Tether amount. address Tether address. Response (JSON) id Withdrawal ID. USDT withdrawal errors Euro Tether withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/eurt_withdrawal/ Request parameters amount Euro Tether amount. address Euro Tether address. Response (JSON) id Withdrawal ID. EURT withdrawal errors Polygon withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/matic_withdrawal/ Request parameters amount Polygon amount. address Polygon address. Response (JSON) id Withdrawal ID. MATIC withdrawal errors SushiSwap withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/sushi_withdrawal/ Request parameters amount SushiSwap amount. address SushiSwap address. Response (JSON) id Withdrawal ID. SUSHI withdrawal errors Chiliz withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/chz_withdrawal/ Request parameters amount Chiliz amount. address Chiliz address. Response (JSON) id Withdrawal ID. CHZ withdrawal errors Enjin Coin withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/enj_withdrawal/ Request parameters amount Enjin Coin amount. address Enjin Coin address. Response (JSON) id Withdrawal ID. ENJ withdrawal errors Hedera Hashgraph withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/hbar_withdrawal/ Request parameters amount Hedera Hashgraph amount. address Hedera Hashgraph address. memo_id (Optional) Address memo id. Response (JSON) id Withdrawal ID. HBAR withdrawal errors Alpha Finance withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/alpha_withdrawal/ Request parameters amount Alpha Finance amount. address Alpha Finance address. Response (JSON) id Withdrawal ID. ALPHA withdrawal errors Axie Infinity withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/axs_withdrawal/ Request parameters amount Axie Infinity amount. address Axie Infinity address. Response (JSON) id Withdrawal ID. AXS withdrawal errors FTX Token withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/ftt_withdrawal/ Request parameters amount FTX Token amount. address FTX Token address. Response (JSON) id Withdrawal ID. FTT withdrawal errors The Sandbox withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/sand_withdrawal/ Request parameters amount The Sandbox amount. address The Sandbox address. Response (JSON) id Withdrawal ID. SAND withdrawal errors Storj withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/storj_withdrawal/ Request parameters amount Storj amount. address Storj address. Response (JSON) id Withdrawal ID. STORJ withdrawal errors Cardano withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/ada_withdrawal/ Request parameters amount Cardano amount. address Cardano address. Response (JSON) id Withdrawal ID. ADA withdrawal errors Fetch.ai withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/fet_withdrawal/ Request parameters amount Fetch.ai amount. address Fetch.ai address. Response (JSON) id Withdrawal ID. FET withdrawal errors Rari Governance Token withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/rgt_withdrawal/ Request parameters amount Rari Governance Token amount. address Rari Governance Token address. Response (JSON) id Withdrawal ID. RGT withdrawal errors SKALE Network withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/skl_withdrawal/ Request parameters amount SKALE Network amount. address SKALE Network address. Response (JSON) id Withdrawal ID. SKL withdrawal errors Celsius Network withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/cel_withdrawal/ Request parameters amount Celsius Network amount. address Celsius Network address. Response (JSON) id Withdrawal ID. CEL withdrawal errors Smooth Love Potion withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/slp_withdrawal/ Request parameters amount Smooth Love Potion amount. address Smooth Love Potion address. Response (JSON) id Withdrawal ID. SLP withdrawal errors Swipe withdrawal This call will be executed on the account, to which the used API key is bound to. This call is for your main account only. Request POST https://www.bitstamp.net/api/v2/sxp_withdrawal/ Request parameters amount Swipe amount. address Swipe address. Response (JSON) id Withdrawal ID. SXP withdrawal errors Ripple withdrawal This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/ripple_withdrawal/ Request parameters amount Currency amount. address XRP address. currency Currency. Response (JSON) id Withdrawal ID. Ripple withdrawal errors Bitcoin Cash deposit address Request POST https://www.bitstamp.net/api/v2/bch_address/ Response (JSON) Returns your BCH deposit address. BCH deposit address errors Bitcoin deposit address Request POST https://www.bitstamp.net/api/v2/btc_address/ Response (JSON) Returns your BTC deposit address. BTC deposit address errors Ether deposit address Request POST https://www.bitstamp.net/api/v2/eth_address/ Response (JSON) Returns your ETH deposit address. ETH deposit address errors Litecoin deposit address Request POST https://www.bitstamp.net/api/v2/ltc_address/ Response (JSON) Returns your LTC deposit address. LTC deposit address errors Paxos Standard deposit address Request POST https://www.bitstamp.net/api/v2/pax_address/ Response (JSON) Returns your PAX deposit address. PAX deposit address errors Stellar Lumens deposit address Request POST https://www.bitstamp.net/api/v2/xlm_address/ Response (JSON) Returns your XLM deposit address. XLM deposit address errors XRP deposit address This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/xrp_address/ Response (JSON) Returns your XRP deposit address and destination tag. XRP deposit address errors Chainlink deposit address Request POST https://www.bitstamp.net/api/v2/link_address/ Response (JSON) Returns your LINK deposit address. LINK deposit address errors OMG Network deposit address Request POST https://www.bitstamp.net/api/v2/omg_address/ Response (JSON) Returns your OMG deposit address. OMG deposit address errors USD Coin deposit address Request POST https://www.bitstamp.net/api/v2/usdc_address/ Response (JSON) Returns your USDC deposit address. USDC deposit address errors AAVE deposit address Request POST https://www.bitstamp.net/api/v2/aave_address/ Response (JSON) Returns your AAVE deposit address. AAVE deposit address errors Basic Attention Token deposit address Request POST https://www.bitstamp.net/api/v2/bat_address/ Response (JSON) Returns your BAT deposit address. BAT deposit address errors UMA deposit address Request POST https://www.bitstamp.net/api/v2/uma_address/ Response (JSON) Returns your UMA deposit address. UMA deposit address errors DAI deposit address Request POST https://www.bitstamp.net/api/v2/dai_address/ Response (JSON) Returns your DAI deposit address. DAI deposit address errors Kyber Network deposit address Request POST https://www.bitstamp.net/api/v2/knc_address/ Response (JSON) Returns your KNC deposit address. KNC deposit address errors Maker deposit address Request POST https://www.bitstamp.net/api/v2/mkr_address/ Response (JSON) Returns your MKR deposit address. MKR deposit address errors 0x deposit address Request POST https://www.bitstamp.net/api/v2/zrx_address/ Response (JSON) Returns your ZRX deposit address. ZRX deposit address errors Gemini Dollar deposit address Request POST https://www.bitstamp.net/api/v2/gusd_address/ Response (JSON) Returns your GUSD deposit address. GUSD deposit address errors Algorand deposit address Request POST https://www.bitstamp.net/api/v2/algo_address/ Response (JSON) Returns your ALGO deposit address. ALGO deposit address errors Audius deposit address Request POST https://www.bitstamp.net/api/v2/audio_address/ Response (JSON) Returns your AUDIO deposit address. AUDIO deposit address errors Curve deposit address Request POST https://www.bitstamp.net/api/v2/crv_address/ Response (JSON) Returns your CRV deposit address. CRV deposit address errors Synthetix deposit address Request POST https://www.bitstamp.net/api/v2/snx_address/ Response (JSON) Returns your SNX deposit address. SNX deposit address errors Uniswap deposit address Request POST https://www.bitstamp.net/api/v2/uni_address/ Response (JSON) Returns your UNI deposit address. UNI deposit address errors yearn.finance deposit address Request POST https://www.bitstamp.net/api/v2/yfi_address/ Response (JSON) Returns your YFI deposit address. YFI deposit address errors Compound deposit address Request POST https://www.bitstamp.net/api/v2/comp_address/ Response (JSON) Returns your COMP deposit address. COMP deposit address errors The Graph deposit address Request POST https://www.bitstamp.net/api/v2/grt_address/ Response (JSON) Returns your GRT deposit address. GRT deposit address errors Tether deposit address Request POST https://www.bitstamp.net/api/v2/usdt_address/ Response (JSON) Returns your USDT deposit address. USDT deposit address errors Euro Tether deposit address Request POST https://www.bitstamp.net/api/v2/eurt_address/ Response (JSON) Returns your EURT deposit address. EURT deposit address errors Polygon deposit address Request POST https://www.bitstamp.net/api/v2/matic_address/ Response (JSON) Returns your MATIC deposit address. MATIC deposit address errors SushiSwap deposit address Request POST https://www.bitstamp.net/api/v2/sushi_address/ Response (JSON) Returns your SUSHI deposit address. SUSHI deposit address errors Chiliz deposit address Request POST https://www.bitstamp.net/api/v2/chz_address/ Response (JSON) Returns your CHZ deposit address. CHZ deposit address errors Enjin Coin deposit address Request POST https://www.bitstamp.net/api/v2/enj_address/ Response (JSON) Returns your ENJ deposit address. ENJ deposit address errors Hedera Hashgraph deposit address Request POST https://www.bitstamp.net/api/v2/hbar_address/ Response (JSON) Returns your HBAR deposit address. HBAR deposit address errors Alpha Finance deposit address Request POST https://www.bitstamp.net/api/v2/alpha_address/ Response (JSON) Returns your ALPHA deposit address. ALPHA deposit address errors Axie Infinity deposit address Request POST https://www.bitstamp.net/api/v2/axs_address/ Response (JSON) Returns your AXS deposit address. AXS deposit address errors FTX Token deposit address Request POST https://www.bitstamp.net/api/v2/ftt_address/ Response (JSON) Returns your FTT deposit address. FTT deposit address errors The Sandbox deposit address Request POST https://www.bitstamp.net/api/v2/sand_address/ Response (JSON) Returns your SAND deposit address. SAND deposit address errors Storj deposit address Request POST https://www.bitstamp.net/api/v2/storj_address/ Response (JSON) Returns your STORJ deposit address. STORJ deposit address errors Cardano deposit address Request POST https://www.bitstamp.net/api/v2/ada_address/ Response (JSON) Returns your ADA deposit address. ADA deposit address errors Fetch.ai deposit address Request POST https://www.bitstamp.net/api/v2/fet_address/ Response (JSON) Returns your FET deposit address. FET deposit address errors Rari Governance Token deposit address Request POST https://www.bitstamp.net/api/v2/rgt_address/ Response (JSON) Returns your RGT deposit address. RGT deposit address errors SKALE Network deposit address Request POST https://www.bitstamp.net/api/v2/skl_address/ Response (JSON) Returns your SKL deposit address. SKL deposit address errors Celsius Network deposit address Request POST https://www.bitstamp.net/api/v2/cel_address/ Response (JSON) Returns your CEL deposit address. CEL deposit address errors Smooth Love Potion deposit address Request POST https://www.bitstamp.net/api/v2/slp_address/ Response (JSON) Returns your SLP deposit address. SLP deposit address errors Swipe deposit address Request POST https://www.bitstamp.net/api/v2/sxp_address/ Response (JSON) Returns your SXP deposit address. SXP deposit address errors Ripple IOU deposit address This API call is cached for 60 seconds. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/ripple_address/ Response (JSON) Returns your Ripple IOU deposit address. Ripple_address errors Unconfirmed bitcoin deposits This API call is cached for 60 seconds. This call will be executed on the account (Sub or Main), to which the used API key is bound to. Request POST https://www.bitstamp.net/api/v2/btc_unconfirmed/ Response (JSON) - list of unconfirmed bitcoin transactions. Each transaction is represented as dictionary amount Bitcoin amount. address Deposit address used. confirmations Number of confirmations. Unconfirmed_btc errors Transfer balance from Sub to Main account Transfers the desired balance from a Sub Account to your Main Account. Can be called by either the Main Account or a Sub Account, but requires a permission in both cases. The subAccount parameter must be provided if the Main Account is initiating the call. If a Sub Account is making the call, then it is the target Sub Account for the transfer and no further clarification is required. In that case, passing this parameter will have no additional effect. Request POST https://www.bitstamp.net/api/v2/transfer-to-main/ Request parameters amount Amount. currency Currency. subAccount (Optional) The Sub Account unique identifier. Response (JSON) status "ok" or "error" reason (available only if status is "error") Additional error info. Transfer-to-main errors Transfer balance from Main to Sub Account Transfers the desired balance from your Main Account to a Sub Account, specified by the subAccount parameter. This call can only be performed by your Main Account. Request POST https://www.bitstamp.net/api/v2/transfer-from-main/ Request parameters amount Amount. currency Currency. subAccount The Sub Account unique identifier. Response (JSON) status "ok" or "error" reason (available only if status is "error") Additional error info. Transfer-from-main errors Open bank withdrawal Opens a bank withdrawal request (SEPA or international). Withdrawal requests opened via API are automatically confirmed (no confirmation e-mail will be sent), but are processed just like withdrawals opened through the platform's interface. This call can only be performed by your Main Account. Request POST https://www.bitstamp.net/api/v2/withdrawal/open/ Request parameters amount The amount to withdraw. account_currency The balance from which you wish to withdraw. Can be either "USD", "EUR" or "GBP". name Full user or company name. iban User or company IBAN. bic The target bank BIC. address User or company address. postal_code User or company postal code. city User or company city. country User or company country. Country codes must be in accordance with the ISO 3166-1 standard (use two character Alpha-2 codes). Disclaimer: Not all country choices listed at this reference URL are supported. For a detailed list please refer to our platform's withdrawal interfaces. type Type of the withdrawal request ("sepa" or "international"). bank_name (international withdrawals only) Target bank name. bank_address (international withdrawals only) Target bank address. bank_postal_code (international withdrawals only) Target bank postal code. bank_city (international withdrawals only) Target bank city. bank_country (international withdrawals only) Target bank country. Country codes must be in accordance with the ISO 3166-1 standard (use two character Alpha-2 codes). Disclaimer: Not all country choices listed at this reference URL are supported. For a detailed list please refer to our platform's withdrawal interfaces. currency (international withdrawals only) The currency in which the funds should be withdrawn (may involve conversion fees). Currency codes must be in accordance with the ISO 4217 standard. Disclaimer: Not all currency choices listed at this reference URL are supported. For a detailed list please refer to our platform's withdrawal interfaces. comment (Optional) Withdrawal comment. Response (JSON): success id Id of the opened withdrawal request. Response (JSON): failure status "error" reason (available only if status is "error") Additional error info. Open bank withdrawal errors Bank withdrawal status Checks the status of a bank withdrawal request. This call can only be performed by your Main Account. Request POST https://www.bitstamp.net/api/v2/withdrawal/status/ Request parameters id ID of the withdrawal request. Response (JSON): success status Status of the withdrawal request. Response (JSON): failure status "error" reason The reason for the error. Bank withdrawal status errors Cancel bank withdrawal Cancels a bank withdrawal request. This call can only be performed by your Main Account. Request POST https://www.bitstamp.net/api/v2/withdrawal/cancel/ Request parameters id ID of the withdrawal request. Response (JSON): success id ID of the cancelled withdrawal request. amount Amount of the cancelled withdrawal request. currency Currency of the cancelled withdrawal request. account_currency Account currency (balance currency from which the withdrawal was requested) of the cancelled withdrawal request. type The type of the cancelled withdrawal request. Response (JSON): failure status "error" reason The reason for the error. Cancel bank withdrawal errors New liquidation address Creates new liquidation address which will automatically sell your BTC for specified liquidation_currency. Request POST https://www.bitstamp.net/api/v2/liquidation_address/new/ Request parameters liquidation_currency Deposited BTCs will be automatically converted to liquidation_currency. address_format Address format. Can be either "P2SHP2WSH" or "BECH32". Response (JSON): success address Address set for automatic conversion. Response (JSON): failure status "error" reason The reason for the error. New liquidation address errors Liquidation address info Shows transactions (BTC to liquidation_currency) for liquidation address. Request POST https://www.bitstamp.net/api/v2/liquidation_address/info/ Request parameters address (Optional) Shows transactions for specific liquidation address or for all users liquidation addresses. Response (JSON): success address Address for automatic conversion. currency_pair Currency pair used for automatic conversion. transactions List of JSON objects which include order_id(conversion order id), count(number of transactions) and trades (JSON with exchange_rate, btc_amount and fees). Response (JSON): failure status "error" reason The reason for the error. Liquidation address info errors Websockets token Generates token required for subscribing to private WebSocket channels. Request POST https://www.bitstamp.net/api/v2/websockets_token/ Response (JSON) token Token. valid_sec Validity of token in seconds. Websockets token error ABOUT Who We Are Careers Legal & Privacy Fee Schedule FAQ PRODUCTS Mobile App Tradeview Bitstamp Earn SERVICES Institutions & Partners Crypto-as-a-Service Pro Traders RESOURCES API Documentation PGP Key Lightning Network ADDRESS Bitstamp Ltd 5 New Street Square London EC4A 3TW United Kingdom CONTACT info@bitstamp.net press@bitstamp.net support@bitstamp.net complaints@bitstamp.net +44 20 3868 9628 +1 800 712 5702 +352 20 88 10 96 All rights reserved © 2021 Bitstamp. NMLS #1905429 We use cookies and similar technologies to operate core site features, customize core services, analyze our traffic, and for security and marketing. Accept all cookies, customize your settings or read our full Cookie Policy. Customize Enable all