CCXT

hitbtc

hitbtc cryptocurrency exchange — CCXT unified API: methods, parameters and endpoints.

hitbtc

Kind: global class
Extends: Exchange

fetchMarkets

retrieves data on all markets for hitbtc

Kind: instance method of hitbtc
Returns: Array<object> - an array of objects representing market data

See: https://api.hitbtc.com/#symbols

ParamTypeRequiredDescription
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchMarkets (params?)

fetchCurrencies

fetches all available currencies on an exchange

Kind: instance method of hitbtc
Returns: object - an associative dictionary of currencies

See: https://api.hitbtc.com/#currencies

ParamTypeRequiredDescription
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchCurrencies (params?)

createDepositAddress

create a currency deposit address

Kind: instance method of hitbtc
Returns: object - an address structure

See: https://api.hitbtc.com/#generate-deposit-crypto-address

ParamTypeRequiredDescription
codestringYesunified currency code of the currency for the deposit address
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.createDepositAddress (code, params?)

fetchDepositAddress

fetch the deposit address for a currency associated with this account

Kind: instance method of hitbtc
Returns: object - an address structure

See: https://api.hitbtc.com/#get-deposit-crypto-address

ParamTypeRequiredDescription
codestringYesunified currency code
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchDepositAddress (code, params?)

fetchBalance

query for balance and get the amount of funds available for trading or funds locked in orders

Kind: instance method of hitbtc
Returns: object - a balance structure

See

ParamTypeRequiredDescription
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchBalance (params?)

fetchTicker

fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market

Kind: instance method of hitbtc
Returns: object - a ticker structure

See: https://api.hitbtc.com/#tickers

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to fetch the ticker for
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchTicker (symbol, params?)

fetchTickers

fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market

Kind: instance method of hitbtc
Returns: object - a dictionary of ticker structures

See: https://api.hitbtc.com/#tickers

ParamTypeRequiredDescription
symbolsArray<string>, undefinedYesunified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchTickers (symbols, params?)

fetchTrades

get the list of most recent trades for a particular symbol

Kind: instance method of hitbtc
Returns: Array<Trade> - a list of trade structures

See: https://api.hitbtc.com/#trades

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to fetch trades for
sinceintNotimestamp in ms of the earliest trade to fetch
limitintNothe maximum amount of trades to fetch
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchTrades (symbol, since?, limit?, params?)

fetchMyTrades

fetch all trades made by the user

Kind: instance method of hitbtc
Returns: Array<Trade> - a list of trade structures

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
sinceintNothe earliest time in ms to fetch trades for
limitintNothe maximum number of trades structures to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching margin trades
hitbtc.fetchMyTrades (symbol, since?, limit?, params?)

fetchDepositsWithdrawals

fetch history of deposits and withdrawals

Kind: instance method of hitbtc
Returns: object - a list of transaction structure

See: https://api.hitbtc.com/#get-transactions-history

ParamTypeRequiredDescription
codestringNounified currency code for the currency of the deposit/withdrawals, default is undefined
sinceintNotimestamp in ms of the earliest deposit/withdrawal, default is undefined
limitintNomax number of deposit/withdrawals to return, default is undefined
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchDepositsWithdrawals (code?, since?, limit?, params?)

fetchDeposits

fetch all deposits made to an account

Kind: instance method of hitbtc
Returns: Array<object> - a list of transaction structures

See: https://api.hitbtc.com/#get-transactions-history

ParamTypeRequiredDescription
codestringYesunified currency code
sinceintNothe earliest time in ms to fetch deposits for
limitintNothe maximum number of deposits structures to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchDeposits (code, since?, limit?, params?)

fetchWithdrawals

fetch all withdrawals made from an account

Kind: instance method of hitbtc
Returns: Array<object> - a list of transaction structures

See: https://api.hitbtc.com/#get-transactions-history

ParamTypeRequiredDescription
codestringYesunified currency code
sinceintNothe earliest time in ms to fetch withdrawals for
limitintNothe maximum number of withdrawals structures to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchWithdrawals (code, since?, limit?, params?)

fetchOrderBooks

fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data for multiple markets

Kind: instance method of hitbtc
Returns: object - a dictionary of order book structures indexed by market symbol

See: https://api.hitbtc.com/#order-books

ParamTypeRequiredDescription
symbolsArray<string>Nolist of unified market symbols, all symbols fetched if undefined, default is undefined
limitintNomax number of entries per orderbook to return, default is undefined
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchOrderBooks (symbols?, limit?, params?)

fetchOrderBook

fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data

Kind: instance method of hitbtc
Returns: object - A dictionary of order book structures indexed by market symbols

See: https://api.hitbtc.com/#order-books

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to fetch the order book for
limitintNothe maximum amount of order book entries to return
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchOrderBook (symbol, limit?, params?)

fetchTradingFee

fetch the trading fees for a market

Kind: instance method of hitbtc
Returns: object - a fee structure

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchTradingFee (symbol, params?)

fetchTradingFees

fetch the trading fees for multiple markets

Kind: instance method of hitbtc
Returns: object - a dictionary of fee structures indexed by market symbols

See

ParamTypeRequiredDescription
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchTradingFees (params?)

fetchOHLCV

fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market

Kind: instance method of hitbtc
Returns: Array<Array<int>> - A list of candles ordered as timestamp, open, high, low, close, volume

See

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to fetch OHLCV data for
timeframestringYesthe length of time each candle represents
sinceintNotimestamp in ms of the earliest candle to fetch
limitintNothe maximum amount of candles to fetch
paramsobjectNoextra parameters specific to the exchange API endpoint
params.untilintNotimestamp in ms of the latest funding rate
params.paginatebooleanNodefault false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the availble parameters
hitbtc.fetchOHLCV (symbol, timeframe, since?, limit?, params?)

fetchClosedOrders

fetches information on multiple closed orders made by the user

Kind: instance method of hitbtc
Returns: Array<Order> - a list of order structures

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol of the market orders were made in
sinceintNothe earliest time in ms to fetch orders for
limitintNothe maximum number of order structures to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching margin orders
hitbtc.fetchClosedOrders (symbol, since?, limit?, params?)

fetchOrder

fetches information on an order made by the user

Kind: instance method of hitbtc
Returns: object - An order structure

See

ParamTypeRequiredDescription
idstringYesorder id
symbolstringYesunified symbol of the market the order was made in
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching a margin order
hitbtc.fetchOrder (id, symbol, params?)

fetchOrderTrades

fetch all the trades made from a single order

Kind: instance method of hitbtc
Returns: Array<object> - a list of trade structures

See

ParamTypeRequiredDescription
idstringYesorder id
symbolstringYesunified market symbol
sinceintNothe earliest time in ms to fetch trades for
limitintNothe maximum number of trades to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching margin trades
hitbtc.fetchOrderTrades (id, symbol, since?, limit?, params?)

fetchOpenOrders

fetch all unfilled currently open orders

Kind: instance method of hitbtc
Returns: Array<Order> - a list of order structures

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
sinceintNothe earliest time in ms to fetch open orders for
limitintNothe maximum number of open orders structures to retrieve
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching open margin orders
hitbtc.fetchOpenOrders (symbol, since?, limit?, params?)

fetchOpenOrder

fetch an open order by it's id

Kind: instance method of hitbtc
Returns: object - an order structure

See

ParamTypeRequiredDescription
idstringYesorder id
symbolstringYesunified market symbol, default is undefined
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for fetching an open margin order
hitbtc.fetchOpenOrder (id, symbol, params?)

cancelAllOrders

cancel all open orders

Kind: instance method of hitbtc
Returns: Array<object> - a list of order structures

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol, only orders in the market of this symbol are cancelled when symbol is not undefined
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for canceling margin orders
hitbtc.cancelAllOrders (symbol, params?)

cancelOrder

cancels an open order

Kind: instance method of hitbtc
Returns: object - An order structure

See

ParamTypeRequiredDescription
idstringYesorder id
symbolstringYesunified symbol of the market the order was made in
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported
params.marginboolNotrue for canceling a margin order
hitbtc.cancelOrder (id, symbol, params?)

createOrder

create a trade order

Kind: instance method of hitbtc
Returns: object - an order structure

See

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to create an order in
typestringYes'market' or 'limit'
sidestringYes'buy' or 'sell'
amountfloatYeshow much of currency you want to trade in units of base currency
pricefloatNothe price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported for spot-margin, swap supports both, default is 'cross'
params.marginboolNotrue for creating a margin order
params.triggerPricefloatNoThe price at which a trigger order is triggered at
params.postOnlyboolNoif true, the order will only be posted to the order book and not executed immediately
params.timeInForcestringNo"GTC", "IOC", "FOK", "Day", "GTD"
hitbtc.createOrder (symbol, type, side, amount, price?, params?)

fetchMarginModes

fetches margin mode of the user

Kind: instance method of hitbtc
Returns: object - a list of margin mode structures

See

ParamTypeRequiredDescription
symbolsArray<string>Yesunified market symbols
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchMarginModes (symbols, params?)

transfer

transfer currency internally between wallets on the same account

Kind: instance method of hitbtc
Returns: object - a transfer structure

See: https://api.hitbtc.com/#transfer-between-wallet-and-exchange

ParamTypeRequiredDescription
codestringYesunified currency code
amountfloatYesamount to transfer
fromAccountstringYesaccount to transfer from
toAccountstringYesaccount to transfer to
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.transfer (code, amount, fromAccount, toAccount, params?)

withdraw

make a withdrawal

Kind: instance method of hitbtc
Returns: object - a transaction structure

See: https://api.hitbtc.com/#withdraw-crypto

ParamTypeRequiredDescription
codestringYesunified currency code
amountfloatYesthe amount to withdraw
addressstringYesthe address to withdraw to
tagstringYes
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.withdraw (code, amount, address, tag, params?)

fetchFundingRates

fetches funding rates for multiple markets

Kind: instance method of hitbtc
Returns: Array<object> - a list of funding rate structures

See: https://api.hitbtc.com/#futures-info

ParamTypeRequiredDescription
symbolsArray<string>Yesunified symbols of the markets to fetch the funding rates for, all market funding rates are returned if not assigned
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchFundingRates (symbols, params?)

fetchFundingRateHistory

fetches historical funding rate prices

Kind: instance method of hitbtc
Returns: Array<object> - a list of funding rate structures

See: https://api.hitbtc.com/#funding-history

ParamTypeRequiredDescription
symbolstringYesunified symbol of the market to fetch the funding rate history for
sinceintNotimestamp in ms of the earliest funding rate to fetch
limitintNothe maximum amount of funding rate structures to fetch
paramsobjectNoextra parameters specific to the exchange API endpoint
params.untilintNotimestamp in ms of the latest funding rate
params.paginatebooleanNodefault false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the availble parameters
hitbtc.fetchFundingRateHistory (symbol, since?, limit?, params?)

fetchPositions

fetch all open positions

Kind: instance method of hitbtc
Returns: Array<object> - a list of position structure

See

ParamTypeRequiredDescription
symbolsArray<string>, undefinedYesnot used by hitbtc fetchPositions ()
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported, defaults to spot-margin endpoint if this is set
params.marginboolNotrue for fetching spot-margin positions
hitbtc.fetchPositions (symbols, params?)

fetchPosition

fetch data on a single open contract trade position

Kind: instance method of hitbtc
Returns: object - a position structure

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol of the market the position is held in, default is undefined
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported, defaults to spot-margin endpoint if this is set
params.marginboolNotrue for fetching a spot-margin position
hitbtc.fetchPosition (symbol, params?)

fetchOpenInterests

Retrieves the open interest for a list of symbols

Kind: instance method of hitbtc
Returns: Array<object> - a list of open interest structures

See: https://api.hitbtc.com/#futures-info

ParamTypeRequiredDescription
symbolsArray<string>Noa list of unified CCXT market symbols
paramsobjectNoexchange specific parameters
hitbtc.fetchOpenInterests (symbols?, params?)

fetchOpenInterest

Retrieves the open interest of a derivative trading pair

Kind: instance method of hitbtc
Returns: object - an open interest structure/docs/manual#interest-history-structure

See: https://api.hitbtc.com/#futures-info

ParamTypeRequiredDescription
symbolstringYesUnified CCXT market symbol
paramsobjectNoexchange specific parameters
hitbtc.fetchOpenInterest (symbol, params?)

fetchFundingRate

fetch the current funding rate

Kind: instance method of hitbtc
Returns: object - a funding rate structure

See: https://api.hitbtc.com/#futures-info

ParamTypeRequiredDescription
symbolstringYesunified market symbol
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchFundingRate (symbol, params?)

reduceMargin

remove margin from a position

Kind: instance method of hitbtc
Returns: object - a margin structure

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
amountfloatYesthe amount of margin to remove
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported, defaults to the spot-margin endpoint if this is set
params.marginboolNotrue for reducing spot-margin
hitbtc.reduceMargin (symbol, amount, params?)

addMargin

add margin

Kind: instance method of hitbtc
Returns: object - a margin structure

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
amountfloatYesamount of margin to add
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported, defaults to the spot-margin endpoint if this is set
params.marginboolNotrue for adding spot-margin
hitbtc.addMargin (symbol, amount, params?)

fetchLeverage

fetch the set leverage for a market

Kind: instance method of hitbtc
Returns: object - a leverage structure

See

ParamTypeRequiredDescription
symbolstringYesunified market symbol
paramsobjectNoextra parameters specific to the exchange API endpoint
params.marginModestringNo'cross' or 'isolated' only 'isolated' is supported, defaults to the spot-margin endpoint if this is set
params.marginboolNotrue for fetching spot-margin leverage
hitbtc.fetchLeverage (symbol, params?)

setLeverage

set the level of leverage for a market

Kind: instance method of hitbtc
Returns: object - response from the exchange

See: https://api.hitbtc.com/#create-update-margin-account-2

ParamTypeRequiredDescription
leveragefloatYesthe rate of leverage
symbolstringYesunified market symbol
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.setLeverage (leverage, symbol, params?)

fetchDepositWithdrawFees

fetch deposit and withdraw fees

Kind: instance method of hitbtc
Returns: Array<object> - a list of fees structures

See: https://api.hitbtc.com/#currencies

ParamTypeRequiredDescription
codesArray<string>, undefinedYeslist of unified currency codes
paramsobjectNoextra parameters specific to the exchange API endpoint
hitbtc.fetchDepositWithdrawFees (codes, params?)

closePosition

closes open positions for a market

Kind: instance method of hitbtc
Returns: object - An order structure

See: https://api.hitbtc.com/#close-all-futures-margin-positions

ParamTypeRequiredDescription
symbolstringYesunified ccxt market symbol
sidestringYes'buy' or 'sell'
paramsobjectNoextra parameters specific to the okx api endpoint
params.symbolstringNorequired unified market symbol
params.marginModestringNo'cross' or 'isolated', default is 'cross'
hitbtc.closePosition (symbol, side, params?)

On this page