API Spec by Method

CCXT unified API specification — every method and the exchanges that implement it.

addMargin

add margin

Kind: instance
Returns: object - a margin structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
amount	`float`	Yes	amount of margin to add
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account id to use, required

borrowCrossMargin

create a loan to borrow margin

Kind: instance
Returns: object - a margin loan structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code of the currency to borrow
amount	`float`	Yes	the amount to borrow
params	`object`	No	extra parameters specific to the exchange API endpoint
params.portfolioMargin	`boolean`	No	set to true if you would like to borrow margin in a portfolio margin account

borrowIsolatedMargin

create a loan to borrow margin

Kind: instance
Returns: object - a margin loan structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol, required for isolated margin
code	`string`	Yes	unified currency code of the currency to borrow
amount	`float`	Yes	the amount to borrow
params	`object`	No	extra parameters specific to the exchange API endpoint

Param	Type	Description
price	`float`	the price to use in the calculation
amountPrecision	`int`	the amountPrecision to use in the calculation
maxDecimals	`int`	the maxDecimals to use in the calculation

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol, only orders in the market of this symbol are cancelled when symbol is not undefined
params	`object`	No	extra parameters specific to the exchange API endpoint
params.trigger	`object`	No	When true, all the trigger orders will be cancelled

cancelAllOrders

cancel all open orders in a market

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

Param	Type	Required	Description
symbol	`string`	Yes	alpaca cancelAllOrders cannot setting symbol, it will cancel all open orders
params	`object`	No	extra parameters specific to the exchange API endpoint

cancelAllOrdersAfter

dead man's switch, cancel all orders after the given timeout

Kind: instance
Returns: object - the api result

Param	Type	Required	Description
timeout	`number`	Yes	time in milliseconds, 0 represents cancel the timer
params	`object`	No	extra parameters specific to the exchange API endpoint
params.type	`string`	No	spot or swap market

cancelAllOrdersWs

cancel all open orders in a market

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

Param	Type	Required	Description
symbol	`string`	No	unified market symbol of the market to cancel orders in
params	`object`	No	extra parameters specific to the exchange API endpoint

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol, only orders in the market of this symbol are cancelled when symbol is not undefined
params	`object`	No	extra parameters specific to the exchange API endpoint
params.trigger	`bool`	No	invalid for isolated margin true if cancelling all stop orders
params.marginMode	`string`	No	'cross' or 'isolated'
params.orderIds	`string`	No	stop orders only Comma separated order IDs
params.hf	`bool`	No	false, // true for hf order

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol, only orders in the market of this symbol are cancelled when symbol is not undefined
params	`object`	No	extra parameters specific to the exchange API endpoint
params.trigger	`bool`	No	true if cancelling all stop orders
params.marginMode	`string`	No	'CROSS' or 'ISOLATED'

cancelOrder

cancels an open order

Kind: instance
Returns: object - An order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	Yes	unified symbol of the market the order was made in
params	`object`	No	extra parameters specific to the exchange API endpoint

cancelOrderWs

cancel multiple orders

Kind: instance
Returns: object - an list of order structures

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	No	unified market symbol, default is undefined
params	`object`	No	extra parameters specific to the exchange API endpoint
params.cancelRestrictions	`string`, `undefined`	No	Supported values: ONLY_NEW - Cancel will succeed if the order status is NEW. ONLY_PARTIALLY_FILLED - Cancel will succeed if order status is PARTIALLY_FILLED.
params.trigger	`boolean`	No	set to true if you would like to cancel a conditional order

cancelOrders

cancel multiple orders

Kind: instance
Returns: Array<Order> - an list of order structures

Param	Type	Required	Description
ids	`Array<string>`	Yes	order ids
symbol	`string`	No	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account to cancel orders for, required

cancelOrdersForSymbols

cancel multiple orders for multiple symbols

Kind: instance
Returns: object - an list of order structures

Param	Type	Required	Description
orders	`Array<CancellationRequest>`	Yes	list of order ids with symbol, example [{"id": "a", "symbol": "BTC/USDT"}, {"id": "b", "symbol": "ETH/USDT"}]
params	`object`	No	extra parameters specific to the exchange API endpoint

cancelOrdersWs

cancel multiple orders

Kind: instance
Returns: object - a list of order structures

Param	Type	Required	Description
ids	`Array<string>`	Yes	order ids
symbol	`string`	Yes	not used by cex cancelOrders()
params	`object`	No	extra parameters specific to the cex api endpoint

closeAllPositions

closes all open positions for a market type

Kind: instance
Returns: Array<object> - A list of position structures

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint
params.productType	`string`	No	'USDT-FUTURES', 'USDC-FUTURES', 'COIN-FUTURES', 'SUSDT-FUTURES', 'SUSDC-FUTURES' or 'SCOIN-FUTURES'
params.uta	`boolean`	No	set to true for the unified trading account (uta), defaults to false

closePosition

closes open positions for a market

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	Unified CCXT market symbol
side	`string`	No	not used by bingx
params	`object`	No	extra parameters specific to the bingx api endpoint
params.positionId	`string`, `undefined`	No	the id of the position you would like to close

closePositions

closes open positions for a market

Kind: instance
Returns: Array<object> - a list of position structures

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the bingx api endpoint
params.recvWindow	`string`	No	request valid time window value

Param	Type	Required	Description
name	`string`	Yes	the name of the sub-account
params	`object`	No	extra parameters specific to the exchange API endpoint
params.expiresAfter	`int`	No	time in ms after which the sub-account will expire

createConvertTrade

convert from one currency to another

Kind: instance
Returns: object - a conversion structure

Param	Type	Required	Description
id	`string`	Yes	the id of the trade that you want to make
fromCode	`string`	Yes	the currency that you want to sell and convert from
toCode	`string`	Yes	the currency that you want to buy and convert into
amount	`float`	No	how much you want to trade in units of the from currency
params	`object`	No	extra parameters specific to the exchange API endpoint

createDepositAddress

create a currency deposit address

Kind: instance
Returns: object - an address structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code of the currency for the deposit address
params	`object`	No	extra parameters specific to the exchange API endpoint

Param	Type	Required	Description
code	`string`	Yes	gift code
amount	`float`	Yes	amount of currency for the gift
params	`object`	No	extra parameters specific to the exchange API endpoint

createMarketBuyOrderWithCost

create a market buy order by providing the symbol and cost

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
cost	`float`	Yes	how much you want to trade in units of the quote currency
params	`object`	No	extra parameters specific to the exchange API endpoint

createMarketOrderWithCost

create a market order by providing the symbol, side and cost

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
side	`string`	Yes	'buy' or 'sell'
cost	`float`	Yes	how much you want to trade in units of the quote currency
params	`object`	No	extra parameters specific to the exchange API endpoint

createMarketSellOrderWithCost

create a market sell order by providing the symbol and cost

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
cost	`float`	Yes	how much you want to trade in units of the quote currency
params	`object`	No	extra parameters specific to the exchange API endpoint

createOrder

create a trade order

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much of currency you want to trade in units of base currency
price	`float`	No	the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint
params.reduceOnly	`bool`	No	true or false whether the order is reduce-only
params.account	`Account`	No	account id to use, required

createOrderWs

create a trade order

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much of currency you want to trade in units of base currency
price	`float`, `undefined`	No	the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint
params.test	`boolean`	Yes	test order, default false
params.returnRateLimits	`boolean`	Yes	set to true to return rate limit information, default false

createOrders

create a list of trade orders

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
orders	`Array`	Yes	list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account id to use, required

Param	Type	Description
orders	`Array`	list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params

createOrdersWs

create a list of trade orders

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
orders	`Array`	Yes	list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params
params	`object`	No	extra parameters specific to the exchange API endpoint

createSpotOrder

create a trade order on spot market

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit' or 'LIMIT_MAKER'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much of you want to trade in units of the base currency
price	`float`	No	the price that the order is to be fulfilled, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint
params.cost	`float`	No	market buy only the quote quantity that can be used as an alternative for the amount
params.test	`bool`	No	whether to use the test endpoint or not, default is false
params.postOnly	`bool`	No	if true, the order will only be posted to the order book and not executed immediately
params.timeInForce	`string`	No	'GTC', 'IOC', or 'PO'
params.clientOrderId	`string`	No	a unique id for the order

Param	Type	Required	Description
name	`string`	Yes	unused argument
params	`object`	No	extra parameters specific to the exchange API endpoint
params.expiryWindow	`int`	No	time to live in milliseconds
params.subAccountAddress	`string`	No	The public key (address) of the sub-account to use for creation
params.subAccountPrivateKey	`string`	No	The private key of the sub-account to use for creation

createTrailingAmountOrder

create a trailing order by providing the symbol, type, side, amount, price and trailingAmount

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much you want to trade in units of the base currency, or number of contracts
price	`float`	No	the price for the order to be filled at, in units of the quote currency, ignored in market orders
trailingAmount	`float`	Yes	the quote amount to trail away from the current market price
trailingTriggerPrice	`float`	Yes	the price to activate a trailing order, default uses the price argument
params	`object`	No	extra parameters specific to the exchange API endpoint

createTrailingPercentOrder

create a trailing order by providing the symbol, type, side, amount, price and trailingPercent

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much you want to trade in units of the base currency, or number of contracts
price	`float`	No	the price for the order to be filled at, in units of the quote currency, ignored in market orders
trailingPercent	`float`	Yes	the percent to trail away from the current market price
trailingTriggerPrice	`float`	Yes	the price to activate a trailing order, default uses the price argument
params	`object`	No	extra parameters specific to the exchange API endpoint

Param	Type	Required	Description
name	`string`	Yes	The name of the vault
description	`string`	Yes	The description of the vault
initialUsd	`number`	Yes	The initialUsd of the vault
params	`object`	No	extra parameters specific to the exchange API endpoint

Param	Type	Required	Description
id	`string`	Yes	cancel order id
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much of currency you want to trade in units of base currency
price	`float`	No	the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint
params.portfolioMargin	`boolean`	No	set to true if you would like to edit an order in a portfolio margin account

editOrder

edit a trade order

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	No	unified symbol of the market to create an order in
type	`string`	No	'market', 'limit' or 'stop_limit'
side	`string`	No	'buy' or 'sell'
amount	`float`	No	how much of the currency you want to trade in units of the base currency
price	`float`	No	the price for the order, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint
params.triggerPrice	`string`	No	the price to trigger a stop order
params.timeInForce	`string`	No	for crypto trading either 'gtc' or 'ioc' can be used
params.clientOrderId	`string`	No	a unique identifier for the order, automatically generated if not sent

editOrderWs

edit a trade order

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	Yes	unified symbol of the market to create an order in
type	`string`	Yes	'market' or 'limit'
side	`string`	Yes	'buy' or 'sell'
amount	`float`	Yes	how much of the currency you want to trade in units of the base currency
price	`float`, `undefined`	No	the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
params	`object`	No	extra parameters specific to the exchange API endpoint

editOrders

edit a list of trade orders

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
orders	`Array`	Yes	list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params
params	`object`	No	extra parameters specific to the exchange API endpoint

enableDemoTrading

enables or disables demo trading mode

Kind: instance

Param	Type	Required	Description
enable	`boolean`	No	true if demo trading should be enabled, false otherwise

fetchAccount

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

Kind: instance
Returns: object - a balance structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchAccountIdByType

fetch all the accounts by a type and marginModeassociated with a profile

Kind: instance
Returns: object - a dictionary of account structures indexed by the account type

Param	Type	Required	Description
type	`string`	Yes	'spot', 'swap' or 'future
marginMode	`string`	No	'cross' or 'isolated'
symbol	`string`	No	unified ccxt market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchAccounts

query for accounts owned by the walletAddress. An Account is needed for all trading methods.

Kind: instance
Returns: Array - a list of account structures

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchAllGreeks

fetches all option contracts greeks, financial metrics used to measure the factors that affect the price of an options contract

Kind: instance
Returns: object - a greeks structure

Param	Type	Required	Description
symbols	`Array<string>`	No	unified symbols of the markets to fetch greeks for, all markets are returned if not assigned
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchBalance

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

Kind: instance
Returns: object - a balance structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`string`	No	account object ID, required

fetchBalanceWs

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

Kind: instance
Returns: object - a balance structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint
params.type	`string`, `undefined`	No	'future', 'delivery', 'savings', 'funding', or 'spot'
params.marginMode	`string`, `undefined`	No	'cross' or 'isolated', for margin trading, uses this.options.defaultMarginMode if not passed, defaults to undefined/None/null
params.symbols	`Array<string>`, `undefined`	No	unified market symbols, only used in isolated margin mode
params.method	`string`, `undefined`	No	method to use. Can be account.balance, account.status, v2/account.balance or v2/account.status

fetchBidsAsks

fetches the bid and ask price and volume for multiple markets

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

Param	Type	Required	Description
symbols	`Array<string>`, `undefined`	Yes	unified symbols of the markets to fetch the bids and asks for, all markets are returned if not assigned
params	`object`	No	extra parameters specific to the exchange API endpoint
params.subType	`string`	No	"linear" or "inverse"

fetchBorrowInterest

fetch the interest owed by the user for borrowing currency for margin trading

Kind: instance
Returns: Array<object> - a list of borrow interest structures

Param	Type	Required	Description
code	`string`	No	unified currency code
symbol	`string`	No	unified market symbol when fetch interest in isolated markets
since	`int`	No	the earliest time in ms to fetch borrrow interest for
limit	`int`	No	the maximum number of structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.portfolioMargin	`boolean`	No	set to true if you would like to fetch the borrow interest in a portfolio margin account

fetchBorrowRateHistory

retrieves a history of a currencies borrow interest rate at specific time slots

Kind: instance
Returns: Array<object> - an array of borrow rate structures

Param	Type	Required	Description
code	`string`	Yes	unified currency code
since	`int`	No	timestamp for the earliest borrow rate
limit	`int`	No	the maximum number of borrow rate structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchCanceledAndClosedOrders

fetches information on multiple canceled orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market the orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters
params.portfolioMargin	`boolean`	No	set to true if you would like to fetch orders in a portfolio margin account
params.trigger	`boolean`	No	set to true if you would like to fetch portfolio margin account trigger or conditional orders

fetchCanceledOrders

fetches information on multiple canceled orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market the orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters
params.portfolioMargin	`boolean`	No	set to true if you would like to fetch orders in a portfolio margin account
params.trigger	`boolean`	No	set to true if you would like to fetch portfolio margin account trigger or conditional orders

fetchClosedOrder

fetch an open order by it's id

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	Yes	unified market symbol, default is undefined
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchClosedOrders

fetches information on multiple closed orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	the latest time in ms to fetch orders for

fetchConvertCurrencies

fetches all available currencies that can be converted

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

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchConvertQuote

fetch a quote for converting from one currency to another

Kind: instance
Returns: object - a conversion structure

Param	Type	Required	Description
fromCode	`string`	Yes	the currency that you want to sell and convert from
toCode	`string`	Yes	the currency that you want to buy and convert into
amount	`float`	Yes	how much you want to trade in units of the from currency
params	`object`	No	extra parameters specific to the exchange API endpoint
params.walletType	`string`	No	either 'SPOT' or 'FUNDING', the default is 'SPOT'

fetchConvertTrade

fetch the data for a conversion trade

Kind: instance
Returns: object - a conversion structure

Param	Type	Required	Description
id	`string`	Yes	the id of the trade that you want to fetch
code	`string`	No	the unified currency code of the conversion trade
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchConvertTradeHistory

fetch the users history of conversion trades

Kind: instance
Returns: Array<object> - a list of conversion structures

Param	Type	Required	Description
code	`string`	No	the unified currency code
since	`int`	No	the earliest time in ms to fetch conversions for
limit	`int`	No	the maximum number of conversion structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	timestamp in ms of the latest conversion to fetch

fetchCrossBorrowRate

fetch the rate of interest to borrow a currency for margin trading

Kind: instance
Returns: object - a borrow rate structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchCrossBorrowRates

fetch the borrow interest rates of all currencies

Kind: instance
Returns: object - a list of borrow rate structures

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchCurrencies

fetches all available currencies on an exchange

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

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDeposit

fetch information on a deposit

Kind: instance
Returns: object - a transaction structure

Param	Type	Required	Description
id	`string`	Yes	deposit id
code	`string`	Yes	not used by bitmart fetchDeposit ()
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDepositAddress

fetch the deposit address for a currency associated with this account

Kind: instance
Returns: object - an address structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDepositAddresses

fetch deposit addresses for multiple currencies (when available)

Kind: instance
Returns: object - a dictionary of address structures indexed by currency code

Param	Type	Required	Description
codes	`Array<string>`	No	list of unified currency codes, default is undefined (all currencies)
params	`object`	No	extra parameters specific to the exchange API endpoint
params.accountId	`string`	No	account ID to fetch deposit addresses for

fetchDepositAddressesByNetwork

fetch the deposit addresses for a currency associated with this account

Kind: instance
Returns: object - a dictionary address structures, indexed by the network

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDepositWithdrawFee

fetch the fee for deposits and withdrawals

Kind: instance
Returns: object - a fee structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint
params.network	`string`	No	the network code of the currency

fetchDepositWithdrawFees

fetch deposit and withdraw fees

Kind: instance
Returns: object - a list of fee structures

Param	Type	Required	Description
codes	`Array<string>`, `undefined`	Yes	list of unified currency codes
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDeposits

fetch all deposits made to an account

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

Param	Type	Required	Description
code	`string`	No	unified currency code
since	`int`	No	the earliest time in ms to fetch deposits for
limit	`int`	No	the maximum number of deposit structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchDepositsWithdrawals

fetch history of deposits and withdrawals

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

Param	Type	Required	Description
code	`string`	No	unified currency code for the currency of the deposit/withdrawals, default is undefined
since	`int`	No	timestamp in ms of the earliest deposit/withdrawal, default is undefined
limit	`int`	No	max number of deposit/withdrawals to return, default is undefined
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchFundingHistory

fetches information on multiple orders made by the user classic accounts only

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve, default 100
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`object`	No	end time, ms
params.side	`boolean`	No	BUY or SELL
params.page	`boolean`	No	Page numbers start from 0

fetchFundingInterval

fetch the current funding rate interval

Kind: instance
Returns: object - a funding rate structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint
params.uta	`boolean`	No	set to true for the unified trading account (uta), defaults to false

fetchFundingIntervals

fetch the funding rate interval for multiple markets

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

Param	Type	Required	Description
symbols	`Array<string>`	No	list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchFundingRate

fetch the current funding rate

Kind: instance
Returns: object - a funding rate structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchFundingRateHistory

fetches historical funding rate prices

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the funding rate history for
since	`int`	No	timestamp in ms of the earliest funding rate to fetch
limit	`int`	No	the maximum amount of funding rate structures to fetch
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	timestamp in ms of the latest funding rate
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the availble parameters

fetchFundingRates

fetch the funding rate for multiple markets

Kind: instance
Returns: Array<object> - a list of funding rates structures, indexe by market symbols

Param	Type	Required	Description
symbols	`Array<string>`, `undefined`	Yes	list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchGreeks

fetches an option contracts greeks, financial metrics used to measure the factors that affect the price of an options contract

Kind: instance
Returns: object - a greeks structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch greeks for
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchIsolatedBorrowRate

fetch the rate of interest to borrow a currency for margin trading

Kind: instance
Returns: object - an isolated borrow rate structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint EXCHANGE SPECIFIC PARAMETERS
params.vipLevel	`object`	No	user's current specific margin data will be returned if viplevel is omitted

fetchIsolatedBorrowRates

fetch the borrow interest rates of all currencies

Kind: instance
Returns: object - a borrow rate structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint
params.symbol	`object`	No	unified market symbol EXCHANGE SPECIFIC PARAMETERS
params.vipLevel	`object`	No	user's current specific margin data will be returned if viplevel is omitted

fetchLastPrices

fetches the last price for multiple markets

Kind: instance
Returns: object - a dictionary of lastprices structures

Param	Type	Required	Description
symbols	`Array<string>`, `undefined`	Yes	unified symbols of the markets to fetch the last prices
params	`object`	No	extra parameters specific to the exchange API endpoint
params.subType	`string`	No	"linear" or "inverse"

fetchLedger

fetch the history of changes, actions done by the user or operations that altered the balance of the user

Kind: instance
Returns: object - a ledger structure

Param	Type	Required	Description
code	`string`	No	unified currency code
since	`int`	No	timestamp in ms of the earliest ledger entry
limit	`int`	No	max number of ledger entries to return
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	timestamp in ms of the latest ledger entry

fetchLeverage

fetch the set leverage for a market

Kind: instance
Returns: object - a leverage structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchLeverageTiers

retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes

Kind: instance
Returns: object - a dictionary of leverage tiers structures, indexed by market symbols

Param	Type	Required	Description
symbols	`Array<string>`, `undefined`	Yes	list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchLeverages

fetch the set leverage for all contract markets

Kind: instance
Returns: object - a list of leverage structures

Param	Type	Required	Description
symbols	`Array<string>`	No	a list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchLiquidations

retrieves the public liquidations of a trading pair

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbol	`string`	Yes	unified CCXT market symbol
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters
params.until	`int`	No	timestamp in ms of the latest liquidation
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters

fetchLongShortRatioHistory

fetches the long short ratio history for a unified market symbol

Kind: instance
Returns: Array<object> - an array of long short ratio structures

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the long short ratio for
timeframe	`string`	No	the period for the ratio, default is 24 hours
since	`int`	No	the earliest time in ms to fetch ratios for
limit	`int`	No	the maximum number of long short ratio structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	timestamp in ms of the latest ratio to fetch

fetchMarginAdjustmentHistory

fetches the history of margin added or reduced from contract isolated positions

Kind: instance
Returns: Array<object> - a list of margin structures

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
type	`string`	No	"add" or "reduce"
since	`int`	No	timestamp in ms of the earliest change to fetch
limit	`int`	No	the maximum amount of changes to fetch
params	`object`	Yes	extra parameters specific to the exchange api endpoint
params.until	`int`	No	timestamp in ms of the latest change to fetch

fetchMarginMode

fetches the margin mode of a specific symbol

Kind: instance
Returns: object - a margin mode structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market the order was made in
params	`object`	No	extra parameters specific to the exchange API endpoint
params.subType	`string`	No	"linear" or "inverse"

fetchMarginModes

fetches the set margin mode of the user

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

Param	Type	Required	Description
symbols	`Array<string>`	No	a list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchMarkPrice

fetches mark price for the market

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.subType	`string`	No	"linear" or "inverse"

fetchMarkPrices

fetches mark prices for multiple markets

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

Param	Type	Required	Description
symbols	`Array<string>`	No	unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned
params	`object`	No	extra parameters specific to the exchange API endpoint
params.subType	`string`	No	"linear" or "inverse"

fetchMarketLeverageTiers

retrieve information on the maximum leverage, for different trade sizes for a single market

Kind: instance
Returns: object - a leverage tiers structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchMarkets

retrieves data on all markets for woo

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

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchMyLiquidations

retrieves the users liquidated positions

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbol	`string`	No	unified CCXT market symbol
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters for the binance api endpoint
params.until	`int`	No	timestamp in ms of the latest liquidation
params.paginate	`boolean`	No	spot only default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters
params.portfolioMargin	`boolean`	No	set to true if you would like to fetch liquidations in a portfolio margin account
params.type	`string`	No	"spot"
params.subType	`string`	No	"linear" or "inverse"

fetchMySettlementHistory

fetches historical settlement records of the user

Kind: instance
Returns: Array<object> - a list of [settlement history objects]

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the settlement history
since	`int`	No	timestamp in ms
limit	`int`	No	number of records
params	`object`	No	exchange specific params

fetchMyTrades

fetch all trades made by the user

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

Param	Type	Required	Description
symbol	`string`	No	unified market symbol
since	`int`	No	the earliest time in ms to fetch trades for
limit	`int`	No	the maximum number of trade structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	the latest time in ms to fetch trades for
params.page_token	`string`	No	page_token - used for paging

fetchMyTradesWs

fetch all trades made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
since	`int`, `undefined`	No	the earliest time in ms to fetch trades for
limit	`int`, `undefined`	No	the maximum number of trades structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.endTime	`int`	No	the latest time in ms to fetch trades for
params.fromId	`int`	No	first trade Id to fetch

fetchOHLCV

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch OHLCV data for
timeframe	`string`	Yes	the length of time each candle represents
since	`int`	No	timestamp in ms of the earliest candle to fetch
limit	`int`	No	max=1000, max=100 when since is defined and is less than (now - (999 * (timeframe in ms)))
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOHLCVWs

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

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

Param	Type	Description
symbol	`string`	unified symbol of the market to query OHLCV data for
timeframe	`string`	the length of time each candle represents
since	`int`	timestamp in ms of the earliest candle to fetch
limit	`int`	the maximum amount of candles to fetch
params	`object`	extra parameters specific to the exchange API endpoint
params.until	`int`	timestamp in ms of the earliest candle to fetch EXCHANGE SPECIFIC PARAMETERS
params.timeZone	`string`	default=0 (UTC)

fetchOpenInterest

retrieves the open interest of a contract trading pair

Kind: instance
Returns: object - an open interest structure/docs/manual#open-interest-structure

Param	Type	Required	Description
symbol	`string`	Yes	unified CCXT market symbol
params	`object`	No	exchange specific parameters

fetchOpenInterestHistory

Retrieves the open interest history of a currency

Kind: instance
Returns: object - an array of open interest structure

Param	Type	Required	Description
symbol	`string`	Yes	Unified CCXT market symbol
timeframe	`string`	Yes	"5m","15m","30m","1h","2h","4h","6h","12h", or "1d"
since	`int`	No	the time(ms) of the earliest record to retrieve as a unix timestamp
limit	`int`	No	default 30, max 500
params	`object`	No	exchange specific parameters
params.until	`int`	No	the time(ms) of the latest record to retrieve as a unix timestamp
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the availble parameters

fetchOpenInterests

Retrieves the open interest for a list of symbols

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

Param	Type	Required	Description
symbols	`Array<string>`	No	a list of unified CCXT market symbols
params	`object`	No	exchange specific parameters

fetchOpenOrder

fetch an open order by the id

Kind: instance
Returns: object - an order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOpenOrders

fetch all unfilled currently open orders

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
since	`int`	No	the earliest time in ms to fetch open orders for
limit	`int`	No	the maximum number of open orders structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.accountNumber	`int`	No	account number to query orders for, required

fetchOpenOrdersWs

fetch all unfilled currently open orders

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
since	`int`, `undefined`	No	the earliest time in ms to fetch open orders for
limit	`int`, `undefined`	No	the maximum number of open orders structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOption

fetches option data that is commonly found in an option chain

Kind: instance
Returns: object - an option chain structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOptionChain

fetches data for an underlying asset that is commonly found in an option chain

Kind: instance
Returns: object - a list of option chain structures

Param	Type	Required	Description
code	`string`	Yes	base currency to fetch an option chain for
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrder

fetches information on an order made by the user

Kind: instance
Returns: object - An order structure

Param	Type	Required	Description
id	`string`	Yes	the order id
symbol	`string`	Yes	unified symbol of the market the order was made in
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrderBook

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the order book for
limit	`int`	No	the maximum amount of order book entries to return
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrderBookWs

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the order book for
limit	`int`	No	the maximum amount of order book entries to return
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrderBooks

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

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

Param	Type	Required	Description
symbols	`Array<string>`, `undefined`	Yes	list of unified market symbols, all symbols fetched if undefined, default is undefined
limit	`int`	No	max number of entries per orderbook to return, default is undefined
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrderTrades

fetch all the trades made from a single order

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

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	Yes	unified market symbol
since	`int`	No	the earliest time in ms to fetch trades for
limit	`int`	No	the maximum number of trades to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrderWs

fetches information on an order made by the user

Kind: instance
Returns: object - An order structure

Param	Type	Required	Description
id	`string`	Yes	order id
symbol	`string`	No	unified symbol of the market the order was made in
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchOrders

fetches information on multiple orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	the latest time in ms to fetch orders for

fetchOrdersByStatus

fetch a list of orders

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

Param	Type	Required	Description
status	`string`	Yes	order status to fetch for
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.trigger	`boolean`	No	set to true for fetching trigger orders
params.marginMode	`string`	No	'cross' or 'isolated' for fetching spot margin orders

fetchOrdersWs

fetches information on multiple orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`, `undefined`	No	the earliest time in ms to fetch orders for
limit	`int`, `undefined`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.orderId	`int`	No	order id to begin at
params.startTime	`int`	No	earliest time in ms to retrieve orders for
params.endTime	`int`	No	latest time in ms to retrieve orders for
params.limit	`int`	No	the maximum number of order structures to retrieve

fetchPosition

fetch data on an open position

Kind: instance
Returns: object - a position structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market the position is held in
params	`object`	No	extra parameters specific to the exchange API endpoint
params.accountNumber	`int`	No	account number to query positions for, required

fetchPositionHistory

fetches historical positions

Kind: instance
Returns: Array<object> - a list of position structures

Param	Type	Required	Description
symbol	`string`	Yes	unified contract symbol
since	`int`	No	the earliest time in ms to fetch positions for
limit	`int`	No	the maximum amount of records to fetch
params	`object`	No	extra parameters specific to the exchange api endpoint
params.until	`int`	No	the latest time in ms to fetch positions for

fetchPositionMode

fetchs the position mode, hedged or one way, hedged for aster is set identically for all linear markets or all inverse markets

Kind: instance
Returns: object - an object detailing whether the market is in hedged or one-way mode

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the order book for
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchPositions

fetch all open positions

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint
params.accountNumber	`int`	No	account number to query positions for, required

fetchPositionsADLRank

fetches the auto deleveraging rank and risk percentage for a list of symbols that have open positions

Kind: instance
Returns: Array<object> - an array of auto de leverage structure

Param	Type	Required	Description
symbols	`Array<string>`	No	list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint
params.portfolioMargin	`boolean`	No	set to true for the portfolio margin account

fetchPositionsForSymbol

fetch all open positions for specific symbol

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint
params.contractType	`string`	No	FUTURE or DELIVERY, default is FUTURE

fetchPositionsHistory

fetches historical positions

Kind: instance
Returns: Array<object> - a list of position structures

Param	Type	Required	Description
symbols	`Array<string>`	No	unified contract symbols
since	`int`	No	timestamp in ms of the earliest position to fetch, default=3 months ago, max range for params["until"] - since is 3 months
limit	`int`	No	the maximum amount of records to fetch, default=20, max=100
params	`object`	Yes	extra parameters specific to the exchange api endpoint
params.until	`int`	No	timestamp in ms of the latest position to fetch, max range for params["until"] - since is 3 months
params.productType	`string`	No	USDT-FUTURES (default), COIN-FUTURES, USDC-FUTURES, SUSDT-FUTURES, SCOIN-FUTURES, or SUSDC-FUTURES
params.uta	`boolean`	No	set to true for the unified trading account (uta), defaults to false

fetchSettlementHistory

fetches historical settlement records

Kind: instance
Returns: Array<object> - a list of settlement history objects

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the settlement history
since	`int`	No	timestamp in ms
limit	`int`	No	number of records, default 100, max 100
params	`object`	No	exchange specific params

fetchStatus

the latest known information on the availability of the exchange API

Kind: instance
Returns: object - a status structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchSwapMarkets

retrieves data on all swap markets for hyperliquid

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

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTicker

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

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTickerWs

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

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.method	`string`	No	method to use can be ticker.price or ticker.book
params.returnRateLimits	`boolean`	No	return the rate limits for the exchange

fetchTickers

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

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbols of the markets to fetch tickers for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.loc	`string`	No	crypto location, default: us

fetchTime

fetches the current integer timestamp in milliseconds from the exchange server

Kind: instance
Returns: int - the current integer timestamp in milliseconds from the exchange server

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTrades

get the list of most recent trades for a particular symbol

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch trades for
since	`int`	No	timestamp in ms of the earliest trade to fetch
limit	`int`	No	the maximum amount of trades to fetch
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	the latest time in ms to fetch trades for

fetchTradesWs

fetch all trades made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
since	`int`	No	the earliest time in ms to fetch trades for
limit	`int`	No	the maximum number of trades structures to retrieve, default=500, max=1000
params	`object`	No	extra parameters specific to the exchange API endpoint EXCHANGE SPECIFIC PARAMETERS
params.fromId	`int`	No	trade ID to begin at

fetchTradingFee

fetch the trading fees for a market

Kind: instance
Returns: object - a fee structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTradingFees

fetch the trading fees for multiple markets

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

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTransactionFee

please use fetchDepositWithdrawFee instead

Kind: instance
Returns: object - a fee structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint
params.network	`string`	No	the network code of the currency

fetchTransactionFees

please use fetchDepositWithdrawFees instead

Kind: instance
Returns: Array<object> - a list of fee structures

Param	Type	Required	Description
codes	`Array<string>`, `undefined`	Yes	not used by binance fetchTransactionFees ()
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchTransactions

fetch history of deposits, withdrawals, and transfers

Kind: instance
Returns: Array<Transaction> - a list of transaction structures

Param	Type	Required	Description
code	`string`	No	unified currency code
since	`int`	No	the earliest time in ms to fetch transactions for
limit	`int`	No	the maximum number of transaction structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters

fetchTransfers

fetch a history of internal transfers made on an account

Kind: instance
Returns: Array<object> - a list of transfer structures

Param	Type	Required	Description
code	`string`	Yes	unified currency code of the currency transferred
since	`int`	No	the earliest time in ms to fetch transfers for
limit	`int`	No	the maximum number of transfers structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.until	`int`	No	the latest time in ms to fetch transfers for
params.paginate	`boolean`	No	default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the available parameters
params.internal	`boolean`	No	default false, when true will fetch pay trade history

fetchVolatilityHistory

fetch the historical volatility of an option market based on an underlying asset

Kind: instance
Returns: Array<object> - a list of volatility history objects

Param	Type	Required	Description
code	`string`	Yes	unified currency code
params	`object`	No	extra parameters specific to the exchange API endpoint
params.period	`int`	No	the period in days to fetch the volatility for: 7,14,21,30,60,90,180,270

fetchWithdrawal

fetch data on a currency withdrawal via the withdrawal id

Kind: instance
Returns: object - a transaction structure

Param	Type	Required	Description
id	`string`	Yes	withdrawal id
code	`string`	Yes	not used by bitmart.fetchWithdrawal
params	`object`	No	extra parameters specific to the exchange API endpoint

fetchWithdrawals

fetch all withdrawals made from an account

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

Param	Type	Required	Description
code	`string`	No	unified currency code
since	`int`	No	the earliest time in ms to fetch withdrawals for
limit	`int`	No	the maximum number of withdrawal structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

isUnifiedEnabled

returns [enableUnifiedMargin, enableUnifiedAccount] so the user can check if unified account is enabled

Kind: instance
Returns: any - [enableUnifiedMargin, enableUnifiedAccount]

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

market

calculates the presumptive fee that would be charged for an order

Kind: instance
Returns: object - contains the rate, the percentage multiplied to the order amount to obtain the fee amount, and cost, the total value of the fee in units of the quote currency, for the order

Param	Type	Description
symbol	`string`	unified market symbol
type	`string`	not used by btcmarkets.calculateFee
side	`string`	not used by btcmarkets.calculateFee
amount	`float`	how much you want to trade, in units of the base currency on most exchanges, or number of contracts
price	`float`	the price for the order to be filled at, in units of the quote currency
takerOrMaker	`string`	'taker' or 'maker'
params	`object`

Supported exchanges

<anonymous>

preLoadLighterLibrary

if the required credentials are available in options, it will pre-load the lighter Signer to avoid delaying sensitive calls like createOrder the first time they're executed

Kind: instance
Returns: boolean - true if the signer was loaded, false otherwise

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

lighter

redeemGiftCode

redeem gift code

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
giftcardCode	`string`	Yes
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

binance

reduceMargin

remove margin from a position

Kind: instance
Returns: object - a margin structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
amount	`float`	Yes	amount of margin to remove
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account id to use, required

Supported exchanges

repayCrossMargin

repay borrowed margin and interest

Kind: instance
Returns: object - a margin loan structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code of the currency to repay
amount	`float`	Yes	the amount to repay
params	`object`	No	extra parameters specific to the exchange API endpoint
params.portfolioMargin	`boolean`	No	set to true if you would like to repay margin in a portfolio margin account
params.repayCrossMarginMethod	`string`	No	portfolio margin only 'papiPostRepayLoan' (default), 'papiPostMarginRepayDebt' (alternative)
params.specifyRepayAssets	`string`	No	portfolio margin papiPostMarginRepayDebt only specific asset list to repay debt

Supported exchanges

repayIsolatedMargin

repay borrowed margin and interest

Kind: instance
Returns: object - a margin loan structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol, required for isolated margin
code	`string`	Yes	unified currency code of the currency to repay
amount	`float`	Yes	the amount to repay
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

repayMargin

repay borrowed margin and interest

Kind: instance
Returns: object - a margin loan structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code of the currency to repay
amount	`float`	Yes	the amount to repay
symbol	`string`	Yes	not used by woo.repayMargin ()
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

reserveRequestWeight

Instead of trading to increase the address based rate limits, this action allows reserving additional actions for 0.0005 USDC per request. The cost is paid from the Perps balance.

Kind: instance
Returns: object - a response object

Param	Type	Required	Description
weight	`number`	Yes	the weight to reserve, 1 weight = 1 action, 0.0005 USDC per action
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

hyperliquid

setAgentAbstraction

set agent abstraction mode

Kind: instance
Returns: dictionary response from the exchange

Param	Type	Required	Description
abstraction	`string`	Yes	one of the strings ["i", "u", "p"] where "i" is "disabled", "u" is "unifiedAccount", and "p" is "portfolioMargin"
params	`object`	No

Supported exchanges

hyperliquid

setContractLeverage

set the level of leverage for a market

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
leverage	`float`	Yes	the rate of leverage
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint
params.uta	`boolean`	No	set to true for the unified trading account (uta)

Supported exchanges

kucoin

setLeverage

set the level of leverage for a market

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
leverage	`float`	Yes	the rate of leverage
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account id to use, required

Supported exchanges

setMargin

Either adds or reduces margin in an isolated position in order to set the margin to a specific value

Kind: instance
Returns: object - A margin structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market to set margin in
amount	`float`	Yes	the amount to set the margin to
params	`object`	No	parameters specific to the bingx api endpoint

Supported exchanges

setMarginMode

set margin mode to 'cross' or 'isolated'

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
marginMode	`string`	Yes	'cross' or 'isolated'
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

setPositionMode

set hedged to true or false for a market

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
hedged	`bool`	Yes	set to true to use dualSidePosition
symbol	`string`	Yes	not used by bingx setPositionMode ()
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

setSandboxMode

enables or disables demo trading mode, if enabled will send PAPTRADING=1 in headers

Kind: instance

Param
enabled

Supported exchanges

bitget

setUserAbstraction

set user abstraction mode

Kind: instance
Returns: dictionary response from the exchange

Param	Type	Required	Description
abstraction	`string`	Yes	one of the strings ["disabled", "unifiedAccount", "portfolioMargin"],
params	`object`	No
params.type	`string`	No	'userSetAbstraction' or 'agentSetAbstraction' default is 'userSetAbstraction'

Supported exchanges

hyperliquid

Kind: instance
Returns: response from exchange

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

signTxEd25519

Helper to sign some transaction bytes and return a generic transaction execution request.

Kind: instance
Returns: object - the input transaction bytes and the signed digest

Param	Type	Required	Description
tx	`object`	No	transaction bytes and the signing digest for them

Supported exchanges

aftermath

transfer

transfer currency internally between wallets on the same account

Kind: instance
Returns: object - a transfer structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
amount	`float`	Yes	amount to transfer
fromAccount	`string`	Yes	account to transfer from
toAccount	`string`	Yes	account to transfer to
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

transferClassic

transfer currency internally between wallets on the same account with classic endpoints

Kind: instance
Returns: object - a transfer structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
amount	`float`	Yes	amount to transfer
fromAccount	`string`	Yes	account to transfer from
toAccount	`string`	Yes	account to transfer to
params	`object`	No	extra parameters specific to the exchange API endpoint
params.transferType	`string`	No	INTERNAL, PARENT_TO_SUB, SUB_TO_PARENT (default is INTERNAL)
params.fromUserId	`string`	No	required if transferType is SUB_TO_PARENT
params.toUserId	`string`	No	required if transferType is PARENT_TO_SUB

Supported exchanges

kucoin

transferOut

transfer from spot wallet to futures wallet

Kind: instance
Returns: a transfer structure

Param	Type	Required	Description
code	`str`	Yes	Unified currency code
amount	`float`	Yes	Size of the transfer
params	`dict`	No	Exchange specific parameters

Supported exchanges

transferUta

transfer currency internally between wallets on the same account with uta endpoint

Kind: instance
Returns: object - a transfer structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
amount	`float`	Yes	amount to transfer
fromAccount	`string`	Yes	account to transfer from
toAccount	`string`	Yes	account to transfer to
params	`object`	No	extra parameters specific to the exchange API endpoint
params.transferType	`string`	No	INTERNAL, PARENT_TO_SUB, SUB_TO_PARENT, SUB_TO_SUB (default is INTERNAL)
params.fromUserId	`string`	No	required if transferType is SUB_TO_PARENT or SUB_TO_SUB
params.toUserId	`string`	No	required if transferType is PARENT_TO_SUB or SUB_TO_SUB

Supported exchanges

kucoin

unWatchBalance

unWatches balance

Kind: instance
Returns: object - status of the unwatch request

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

hyperliquid

unWatchBidsAsks

unWatches best bid & ask for symbols

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchFundingRate

unWatches the current funding rate for a symbol

Kind: instance
Returns: object - a funding rate structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

mexc

unWatchMarkPrice

unWatches a mark price for a specific market

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.use1sFreq	`boolean`	No	default is true if set to true, the mark price will be updated every second, otherwise every 3 seconds

Supported exchanges

unWatchMarkPrices

watches the mark price for all markets

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.use1sFreq	`boolean`	No	default is true if set to true, the mark price will be updated every second, otherwise every 3 seconds

Supported exchanges

unWatchMyTrades

unWatches information on multiple trades made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
params	`object`	No	extra parameters specific to the exchange API endpoint
params.unifiedMargin	`boolean`	No	use unified margin account
params.executionFast	`boolean`	No	use fast execution

Supported exchanges

unWatchOHLCV

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch OHLCV data for
timeframe	`string`	Yes	the length of time each candle represents
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchOHLCVForSymbols

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

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

Param	Type	Required	Description
symbolsAndTimeframes	`Array<Array<string>>`	Yes	array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchOrderBook

unsubscribe from the orderbook channel

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

Param	Type	Required	Description
symbol	`string`	Yes	symbol of the market to unwatch the trades for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.limit	`int`	No	orderbook limit, default is undefined

Supported exchanges

unWatchOrderBookForSymbols

unsubscribe from the orderbook channel

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to unwatch the trades for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.limit	`int`	No	orderbook limit, default is undefined

Supported exchanges

unWatchOrders

unWatches information on multiple orders made by the user

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

Param	Type	Required	Description
symbol	`string`	No	unified market symbol of the market orders were made in
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchPositions

unWatches from the stream channel

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

Param	Type	Required	Description
symbols	`Array<string>`	No	list of unified market symbols to watch positions for
params	`object`	Yes	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchTicker

unWatches a price ticker

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchTickers

unWatches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchTrades

unsubscribe from the trades channel

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market trades were made in
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

unWatchTradesForSymbols

unsubscribe from the trades channel

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch trades for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

upgradeUnifiedTradeAccount

upgrades the account to unified trade account warning this is irreversible

Kind: instance
Returns: any - nothing

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

bybit

verifyGiftCode

verify gift code

Kind: instance
Returns: object - response from the exchange

Param	Type	Required	Description
id	`string`	Yes	reference number id
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

binance

watchBalance

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

Kind: instance
Returns: object - a balance structure

Param	Type	Required	Description
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchBidsAsks

watches best bid & ask for symbols

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchFundingRate

watch the current funding rate

Kind: instance
Returns: object - a funding rate structure

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchFundingRates

watch the funding rate for multiple markets

Kind: instance
Returns: object - a dictionary of funding rate structures, indexed by market symbols

Param	Type	Required	Description
symbols	`Array<string>`	Yes	a list of unified market symbols
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

bitmart
okx

watchLiquidations

watch the public liquidations of a trading pair

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbol	`string`	Yes	unified CCXT market symbol
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters for the bitmex api endpoint

Supported exchanges

watchLiquidationsForSymbols

watch the public liquidations of a trading pair

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbols	`Array<string>`	Yes	list of unified market symbols
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters for the bitmex api endpoint

Supported exchanges

watchMarkPrice

watches a mark price for a specific market

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.use1sFreq	`boolean`	No	default is true if set to true, the mark price will be updated every second, otherwise every 3 seconds

Supported exchanges

watchMarkPrices

watches the mark price for all markets

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint
params.use1sFreq	`boolean`	No	default is true if set to true, the mark price will be updated every second, otherwise every 3 seconds

Supported exchanges

watchMyLiquidations

watch the private liquidations of a trading pair

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbol	`string`	Yes	unified CCXT market symbol
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters for the bitmex api endpoint

Supported exchanges

binance
gate

watchMyLiquidationsForSymbols

watch the private liquidations of a trading pair

Kind: instance
Returns: object - an array of liquidation structures

Param	Type	Required	Description
symbols	`Array<string>`	Yes	list of unified market symbols
since	`int`	No	the earliest time in ms to fetch liquidations for
limit	`int`	No	the maximum number of liquidation structures to retrieve
params	`object`	No	exchange specific parameters for the bitmex api endpoint

Supported exchanges

watchMyTrades

watches information on multiple trades made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market trades were made in
since	`int`	No	the earliest time in ms to fetch trades for
limit	`int`	No	the maximum number of trade structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.unifiedMargin	`boolean`	No	use unified margin account

Supported exchanges

watchMyTradesForSymbols

watches information on multiple trades made by the user

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch trades for
since	`int`	No	the earliest time in ms to fetch trades for
limit	`int`	No	the maximum number of trade structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

coinbaseexchange

watchOHLCV

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch OHLCV data for
timeframe	`string`	Yes	the length of time each candle represents
since	`int`	No	timestamp in ms of the earliest candle to fetch
limit	`int`	No	the maximum amount of candles to fetch
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchOHLCVForSymbols

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

Kind: instance
Returns: object - A list of candles ordered as timestamp, open, high, low, close, volume

Param	Type	Required	Description
symbolsAndTimeframes	`Array<Array<string>>`	Yes	array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
since	`int`	No	timestamp in ms of the earliest candle to fetch
limit	`int`	No	the maximum amount of candles to fetch
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchOrderBook

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

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

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the order book for
limit	`int`	No	the maximum amount of order book entries to return.
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchOrderBookForSymbols

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

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified array of symbols
limit	`int`	No	the maximum amount of order book entries to return.
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchOrders

watches information on multiple orders made by the user

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market orders were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchOrdersForSymbols

watches information on multiple orders made by the user across multiple symbols

Kind: instance
Returns: Array<object> - a list of [order structures]{@link /docs/manual#order-structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of order structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint
params.trigger	`boolean`	No	set to true for trigger orders

Supported exchanges

watchPosition

watch open positions for a specific symbol

Kind: instance
Returns: object - a position structure

Param	Type	Description
symbol	`string`, `undefined`	unified market symbol
params	`object`	extra parameters specific to the exchange API endpoint

Supported exchanges

kucoin

watchPositions

watch all open positions

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

Param	Type	Required	Description
symbols	`Array<string>`	No	list of unified market symbols
since	`int`	No	the earliest time in ms to fetch positions for
limit	`int`	No	the maximum number of positions to retrieve
params	`object`	Yes	extra parameters specific to the exchange API endpoint

Supported exchanges

watchTicker

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

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbol	`string`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchTickers

watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list

Kind: instance
Returns: object - a ticker structure

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch the ticker for
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchTrades

watches information on multiple trades made in a market

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

Param	Type	Required	Description
symbol	`string`	Yes	unified market symbol of the market trades were made in
since	`int`	No	the earliest time in ms to fetch orders for
limit	`int`	No	the maximum number of trade structures to retrieve
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

watchTradesForSymbols

get the list of most recent trades for a list of symbols

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

Param	Type	Required	Description
symbols	`Array<string>`	Yes	unified symbol of the market to fetch trades for
since	`int`	No	timestamp in ms of the earliest trade to fetch
limit	`int`	No	the maximum amount of trades to fetch
params	`object`	No	extra parameters specific to the exchange API endpoint

Supported exchanges

withdraw

make a withdrawal

Kind: instance
Returns: object - a transaction structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
amount	`float`	Yes	the amount to withdraw
address	`string`	Yes	the address to withdraw to
tag	`string`	Yes
params	`object`	No	extra parameters specific to the exchange API endpoint
params.account	`Account`	No	account id to use, required

Supported exchanges

withdrawWs

make a withdrawal

Kind: instance
Returns: object - a transaction structure

Param	Type	Required	Description
code	`string`	Yes	unified currency code
amount	`float`	Yes	the amount to withdraw
address	`string`	Yes	the address to withdraw to
tag	`string`	Yes
params	`object`	No	extra parameters specific to the bitvavo api endpoint

Supported exchanges

bitvavo