Список включает только ненулевые балансы, и приблизительную оценку в USD и BTC.
При повторных запросах также показывает изменения относительно предыдущих данных. Бот анализирует покупку-продажу по торговой паре pair
файла конфигурации, но она может быть неправильной, потому что он использует только данные балансов, а не сделок.
Команда получает данные от биржи, которую вы указали в поле exchange
файла конфигурации. Ключи API нужно указать обязательно.
Формат
/balances
Пример
/balances
Resfinex balances:
9 201.27923727 ADM (3 700.36923727 available & 5 500.91 frozen)
0.05603766 RES
97.02754082 USDT (63.22883482 available & 33.798706 frozen)
Total holdings ~ 209.69 USD or 0.00784110 BTC
Changes:
ADM: +117.31
USDT: −1.45405745
Total holdings +4.04 USD or +0.00017664 BTC
I've bought 117.31 ADM at 0.012395 USDT price.
Бот показывает общее количество ордеров по торговой паре на бирже, и количество ордеров по типам из внутреннего хранилища. Общее количество ордеров в хранилище бота может отличаться от реального количества ордеров на бирже по этой паре: вы разместили ордеры на веб-сайте биржи; API биржи может не закрыть ордер, но уведомить бота, что закрыл. Эту разницу бот показывает числом Unknown orders.
При повторных запросах также показывает изменения относительно предыдущих данных.
Типы ордеров:
/enable ob
./enable liq
./enable pw
./buy
, /sell
, /fill
, /make price
.Отдельно бот покажет Unknown orders — ордеры, которых нет в хранилище бота. Эти ордеры вы могли разместить на веб-сайте биржи. Но если количество Unknown orders постоянно нарастает, они появляются из-за ошибок API. Это приведет к блокировке балансов, и у бот перестанет размещать ордеры. Чтобы ошибки API не прерывали работу, настройте параметр clearAllOrdersInterval
в конфиг-файле.
Команда /orders
получает данные от биржи, которую вы указали в поле exchange
файла конфигурации. Указать ключи API нужно обязательно.
Формат
/orders [торговая пара]
Если вы не указали торговую пару, бот покажет ордеры пары pair
конфиг-файла.
Пример
/orders adm/usdt
Atomars open orders for ADM/USDT pair: 61 (−27).
Orders in my database:
Market making: 0,
Dynamic order book: 6 (+1),
Tradebot: 0,
Liquidity: 7 (+1),
Price watching: 0,
Manual orders: 48,
Total — 61 (+2).
Orders which are not in my database (Unknown orders): 0 (−29).
Информация включает общую статистику по торгам за сутки, и статистику маркет-мейкинга за сутки, за месяц и за все время работы бота.
Команда /stats
получает данные от биржи, которую вы указали в поле exchange
файла конфигурации. Возможно, вам также нужно будет указать ключи API.
Формат
/stats [торговая пара]
Если вы не указали торговую пару, бот покажет статистику пары pair
конфиг-файла.
Пример
/stats adm/usdt
Resfinex 24h stats for ADM/USDT pair:
Vol: 68 956.18 ADM & 690.848578 USDT.
Low: 0.009470, high: 0.010455, delta: 0.000985 USDT (9.89%).
Bid: 0.009557, ask: 0.009584, spread: 0.000027 USDT (0.28%).
Market making stats for ADM/USDT pair:
24h: 742 orders with 68 277.88 ADM and 685.511816 USDT, 30d: 18018 orders with 2 012 408.19 ADM and 20 670.789837 USDT, all time: 139591 orders with 96 741 870.44 ADM and 995 097.123482 USDT.
Бот получает курсы валют от infoService и от биржи. Курсы биржи также включают bid, ask, спред.
InfoService — провайдер курсов криптовалют АДАМАНТа, который получает и хранит данные MOEX, Coinmarketcap, CryptoCompare и Coingecko. По умолчанию бот использует https://info.adamant.im
. Если информации о нужной монете нет, запустите свой infoService и укажите его в поле infoservice
конфиг-файла, или попросите нас добавить ее в провайдер по умолчанию.
Команда /rates
получает данные от биржи, которую вы указали в поле exchange
файла конфигурации. Возможно, вам также нужно будет указать ключи API.
Формат
/rates [монета или торговая пара]
Если вы укажете торговую пару, бот также покажет курсы биржи.
Пример
/rates adm/usdt
Global market rates for ADM:
ADM/USD: 0.01162218, ADM/RUB: 0.86203452, ADM/EUR: 0.00952751, ADM/CNY: 0.07569276, ADM/JPY: 1.18330227, ADM/BTC: 4.6e-7, ADM/ETH: 0.00001853.
Bit-Z rates for ADM/USDT pair:
Bid: 0.0102, ask: 0.0110, spread: 0.0008 USDT (7.27%).
Использует рыночные данные InfoService и биржи.
InfoService — провайдер курсов криптовалют АДАМАНТа, который получает и хранит данные MOEX, Coinmarketcap, CryptoCompare и Coingecko. По умолчанию бот использует https://info.adamant.im
. Если информации о нужной монете нет, запустите свой infoService и укажите его в поле infoservice
конфиг-файла, или попросите нас добавить ее в провайдер по умолчанию.
Команда получает данные от биржи, которую вы указали в поле exchange
файла конфигурации. Возможно, вам также нужно будет указать ключи API.
Формат
/calc [количество] [монета-1] in [монета-2]
Пример
/calc 2.05 BTC in USDT
Global market value of 2.05 BTC equals 55 241.17488547 USDT.
Resfinex value of 2.05 BTC:
Bid: 55 403.62800000 USDT, ask: 55 434.05000000 USDT.
Перед запуском маркет-мейкинга задайте интервалы торговли /interval
и количества /amount
. Посмотреть текущие параметры можно командой /params
.
При старте бот сообщит, какие опции включены, а какие нет. Вы может включить и отключить их командами /enable
и /disable
.
Возможные стратегии:
/buyPercent
./enable liq
, бот может покупать сам у себя, снижая риски слива балансов. Если ликвидность отключена, использовать эту стратегию не рекомендую — бот будет покупать дорого, а продавать дешево, увеличит спред и сольет балансы.Команда запускает маркет-мейкинг на бирже exchange
пары pair
файла конфигурации. Указать ключи API нужно обязательно.
Формат
/start mm [стратегия]
Если вы не указали стратегию, бот будет использовать стратегию Optimal.
Пример
/start mm optimal
Starting market making & order book building & liquidity and spread maintenance with optimal policy for ADM/USDT pair. Price watching is disabled—type /enable pw to enable.
Ставит маркет-мейкинг “на паузу”.
Бот оставит все текущие ордеры активными, а не отменит их. Чтобы отменить их, воспользуйтесь командой /clear
.
Формат
/stop mm
Пример
/stop mm
Market making, order book building, liquidity and spread maintenance, price watching for ADM/USDT pair are disabled now.
Задает минимальное и максимальное значения токенов, которые бот размещает в ордерах mm и ob. См. команды /start mm
и /enable ob
.
Увеличивая это значение, вы увеличите объем торгов и объем ордеров в стаканах. Чем больше это значение, тем больше боту нужно активов на балансе. См. также /interval
.
Команда устанавливает значения на бирже exchange
пары pair
файла конфигурации.
Формат
/amount [от-до]
Пример
/amount 1-250
Set to make market with amounts from 1 to 250 ADM for ADM/USDT pair.
Задает минимальное и максимальное время между ордерами маркет-мейкинга.
Уменьшая это значение, вы увеличите объем торгов — ордеры маркет-мейкинга будут размещаться чаще. См. также /amount
.
Команда устанавливает значения на бирже exchange
пары pair
файла конфигурации.
Формат
/interval [от-до] [единица]
Единица времени может быть sec (по умолчанию), min, hour.
Пример
/interval 3-210 sec
Set to make market in intervals from 3 to 210 sec for ADM/USDT pair.
Увеличивая это значение, вы увеличите количество покупок токена, и уменьшите количество продаж.
Для ордеров ob большее значение означает большее кол-во ордеров в “стакане” на продажу, и меньшее на покупку. См. /enable ob
.
Команда устанавливает значение на бирже exchange
пары pair
файла конфигурации.
Формат
/buyPercent [процент]
Пример
/buyPercent 65
Set to make market with 65% of buy orders for ADM/USDT pair. Order book building is set to 35% of buy orders.
Опции можно включить и во время работы бота, и на “на паузе”. Работают опции только при запущенном маркет-мейкинге командой /start mm
. Если маркет-мейкинг не запущен, опции будут в ожидании запуска.
Доступные опции:
/amount
. Процент ордеров на продажу и на покупку можно изменить командой /buyPercent
./orders
. Если цена выйдет за пределы, при достаточном балансе бот вернет ее в заданный диапазон — купит или продаст токены. Диапазон цены можно установить в любой валюте, тогда бот будет сам пересчитывать в валюту торговой пары. Бот умеет контролировать арбитраж — запустив ботов на всех торговых парах, они поддержат одинаковую цену на всех биржах.Формат
/enable [опция] [параметры]
ob:
/enable ob [кол-во ордеров]
Если кол-во ордеров опустить, бот будет использовать предыдущее значение. Первоначальное значение зависит от биржи. Смотрите параметр mm_orderBookOrdersCount
в ответе команды /params
.
Пример
/enable ob 20
Order book building is enabled for ADM/USDT pair with 20 maximum number of orders.
liq:
/enable liq [спред%] [кол-во-1] [монета-1] [кол-во-2] [монета-2] [тренд]
Возможные значения тренда — uptrend, downtrend, middle (по умолчанию). Тренд указывает, где размещать ликвидность относительно текущих bid-ask. При значении uptrend цена токена будет стремиться к росту, но при этом бот будет тратить больше quote-монеты, то есть закупать ваши токены.
Пример
/enable liq 1.5% 200 ADM 2 USDT middle
Liquidity and spread maintenance is enabled for ADM/USDT pair with 200 ADM asks (sell) and 2 USDT bids (buy) within 1.5% spread & middle trend.
pw:
/enable pw [low-high] [монета]
/enable pw [цена] [монета] [отклонение%]
Можно задать диапазон от low до high, а можно цену и процент отклонения от нее.
/enable pw [торговая пара]@[биржа] [отклонение%] [политика]
Если ваш токен торгуется на нескольких торговых парах или биржах, рекомендую настроить ведущую торговую пару в числовом диапазоне, а остальные — ориентировать на цену токена на основной торговой паре. Когда бот получает цену из другой торговой пары, он будет использовать bid и ask при политике strict, или определять реальную цену по “стаканам” при политике smart.
Например, при таких “стаканах” strict даст диапазон 0.0122–0.0128, а smart диапазон 0.0114–0.0133:
Бот покажет текущую информацию по цене токена и попросит подтверждение. Если вы согласны, отправьте команду /y
.
Пример
/enable pw 0.0045-0.0145 USDT
/enable pw 0.0095 USDT 47%
Are you sure to enable Price watching for ADM/USDT pair from 0.005035 to 0.013965 USDT (global rate)—47.00% price deviation? Confirm with /y command or ignore.
Global market rates for ADM:
ADM/USD: 0.01162428, ADM/RUB: 0.86012116, ADM/EUR: 0.00948753, ADM/CNY: 0.07504373, ADM/JPY: 1.20059821, ADM/BTC: 3.7e-7, ADM/ETH: 0.00001135.
Resfinex rates for ADM/USDT pair:
Bid: 0.011570, ask: 0.011708.
Пример
/enable pw ADM/USDT@Bit-Z 0.5% smart
Are you sure to enable Price watching for ADM/USDT pair based on ADM/USDT@Bit-Z with smart policy and 0.50% deviation? Confirm with /y command or ignore.
Global market rates for ADM:
ADM/USD: 0.01154775, ADM/RUB: 0.85445844, ADM/EUR: 0.00942507, ADM/CNY: 0.07454966, ADM/JPY: 1.19269391, ADM/BTC: 3.6e-7, ADM/ETH: 0.00001112.
Resfinex rates for ADM/USDT pair:
Bid: 0.011488, ask: 0.011573.
Опции можно выключить и во время работы бота, и на “на паузе”. Отключение опции не остановит маркет-мейкинг. Чтобы остановить маркет-мейкинг, используйте команду /stop mm
.
Бот оставит все текущие ордеры активными, а не отменит их. Чтобы отменить их, воспользуйтесь командой /clear
.
Доступные опции — как у команды /enable
.
Формат
/disable [опция]
Пример
/disable pw
Price watching is disabled for ADM/USDT pair. Market making is still active. To stop market making, type /stop mm.
Купить токены по рыночной цене, или разместить ордер на покупку в “стакан” — это ордеры типа market и limit. При размещении ордера, бот сохраняет его во внутреннем хранилище с типом man. См. /orders
.
Команда /buy
— покупка токенов “вручную” и не зависит от маркет-мейкинга.
В зависимости от цены ордер может попасть в “стакан” или исполниться сразу.
Формат
/buy [торговая пара] [количество=] [цена=]
Если вы не указали торговую пару, бот разместит ордер на паре pair
конфиг-файла.
Если вы не указали цену, бот разместит ордер по рыночной цене. То же, что и price=market
.
Количество можно указать в токенах (amount), а можно в quote-монете (quote). Заметка: На некоторых биржах купить по рыночной цене можно только с quote. Заметка: в паре ADM/BTC токен ADM — base, BTC — quote.
Примеры
/buy ADM/BTC amount=200 price=0.00000224
Купить 200 ADM по цене 0.00000224 BTC.
/buy ADM/BTC quote=0.01
Купить ADM на 0.01 BTC по рыночной цене.
/buy ADM/BTC amount=200
Купить 200 ADM по рыночной цене.
Order placed to buy 200.00 ADM at Market Price on ADM/BTC market. Order Id: 1jnuw2drCgx2ph0NASIw.
Продать токены по рыночной цене, или разместить ордер на продажу в “стакан” — это ордеры типа market и limit. При размещении ордера, бот сохраняет его во внутреннем хранилище с типом man. См. /orders
.
Команда /sell
— продажа токенов “вручную” и не зависит от маркет-мейкинга.
В зависимости от цены ордер может попасть в “стакан” или исполниться сразу.
Формат
/sell [торговая пара] [количество=] [цена=]
Если вы не указали торговую пару, бот разместит ордер на паре pair
конфиг-файла.
Если вы не указали цену, бот разместит ордер по рыночной цене. То же, что и price=market
.
Количество можно указать в токенах (amount), а можно в quote-монете (quote). Заметка: на некоторых биржах продать по рыночной цене можно только amount. Заметка: в паре ADM/BTC токен ADM — base, BTC — quote.
Примеры
/sell ADM/BTC amount=200 price=0.00000224
Продать 200 ADM по цене 0.00000224 BTC.
/sell ADM/BTC amount=200
Продать 200 ADM по рыночной цене.
Order placed to sell 200.0000 ADM at Market Price on ADM/BTC market. Order Id: 11368932445.
Размещает несколько ордеров на покупкуbuy или на продажу sell в заданном диапазоне цены. Используйте для заполнения “стаканов”.
При размещении ордеров бот сохраняет их во внутреннем хранилище с типом man. См. /orders
.
Команда /fill
размещает ордеры “вручную” и не зависит от маркет-мейкинга.
В зависимости от цены ордеры могут попасть в “стакан” или исполниться сразу.
Формат
/fill [торговая пара] [buy или sell] [quote= или amount=] [low=] [high=] [count=]
Если вы не указали торговую пару, бот разместит ордеры на паре pair
конфиг-файла.
Количество на продажу нужно указать в токенах (amount), а количество на покупку — в quote-монете (quote). Заметка: в паре ADM/USDT токен ADM — base, USDT — quote.
Ордеры размещаются в диапазоне цены от low до high.
Бот разместит не больше count ордеров общим объемом до amount / quote.
Пример
/fill ADM/USDT sell amount=10000 low=0.0120 high=0.0320 count=40
Разместить 40 ордеров на продажу 10,000 ADM по цене от 0.012 до 0.032 USDT за ADM.
Placed 39 orders to sell 9 420.37754383 ADM for 215.97480995 USDT.
Команда /make price
размещает ордер на покупку или на продажу таким образом, чтобы изменить цену токена.
При размещении ордера бот сохраняет его во внутреннем хранилище с типом man. См. /orders
.
Команда /make price
размещает ордер “вручную” и не зависит от маркет-мейкинга. При активном маркет-мейкинге с включенным контролем цены использовать эту команду не рекомендую — вместо этого откорректируйте контроль цены командой /enable pw
.
Команда устанавливает цену на бирже, которую вы указали в поле exchange
файла конфигурации, на торговой паре pair
.
Перед выполнением команды бот покажет текущую информацию по цене токена и попросит подтверждение. Если вы согласны, отправьте команду /y
.
Формат
/make price [цена]
Пример
/make price 0.0119
Are you sure to make ADM/USDT price of 0.0119 USDT? I am going to sell 699.545004 ADM for 8.53103883 USDT.
Warning: Price watcher is enabled for ADM/USDT from 0.00600000 to 0.01550000 USDT.
Confirm with /y command or ignore.
Global market rates for ADM:
ADM/USD: 0.01086942, ADM/RUB: 0.80268438, ADM/EUR: 0.00887441, ADM/CNY: 0.07080874, ADM/JPY: 1.12042521, ADM/BTC: 3.8e-7, ADM/ETH: 0.00001485.
Atomars rates for ADM/USDT pair:
Bid: 0.01227720, ask: 0.01238879.
Список активных ордеров можно получить командой /orders
.
Команда /clear
отменяет ордеры на бирже, которую вы указали в поле exchange
файла конфигурации.
Формат
/clear [торговая пара] [тип или all] [force]
Если вы не указали торговую пару, бот отменит ордеры на паре pair
конфиг-файла.
Типы ордеров смотрите по команде /orders
. Если указать вместо типа all, бот запросит все активные ордеры по выбранной паре на бирже и отменит их. Поскольку API биржи может иметь ограничения по количеству запросов, используйте параметр force, чтобы выполнить несколько проходов.
Пример
/clear adm/usdt all
Closed 64 of 64 orders on Atomars for ADM/USDT.
Если в памяти бота есть команда, которая запрашивала подтверждение, /y
выполнит ее. Например, см. /make price
.
Формат
/y
Пример
/y
Making ADM/USDT price of 0.0119 USDT: Successfully placed an order to sell 703.989338 ADM for 8.58523804 USDT.
Atomars rates for ADM/USDT pair:
Before action — bid: 0.01227720, ask: 0.01238879.
After action — bid: 0.01171761, ask: 0.01190000.
Адрес для депозита предоставляет биржа. Некоторые биржи не создают адреса для депозитов по API, для этого зайдите на веб-сайт биржи.
Ваши балансы на бирже можно получить командой /balances
.
Команда предоставляет адрес для депозита на бирже, которую вы указали в поле exchange
файла конфигурации.
Формат
/deposit [монета]
Пример
/deposit adm
The deposit address for ADM: U9697541665761260814.
Команда показывает параметры маркет-мейкинга на бирже, которую вы указали в поле exchange
файла конфигурации. Для каждой биржи бот хранит параметры в отдельном файле /trade/tradeParams_{exchange}.js.
Не рекомендую менять параметры в файле напрямую. Если вы все же собираетесь это сделать, предварительно остановите приложение бота.
Формат
/params
Пример
/params
I am set to work with ADM/USDT pair on Resfinex. Current trading settings:
{
"mm_buyPercent": 0.65,
"mm_minInterval": 3000,
"mm_maxInterval": 210000,
"mm_isActive": true,
"mm_minAmount": 1,
"mm_maxAmount": 250,
"mm_isOrderBookActive": true,
"mm_orderBookHeight": 19,
"mm_orderBookOrdersCount": 20,
"mm_Policy": "optimal",
"mm_isLiquidityActive": true,
"mm_liquiditySellAmount": 200,
"mm_liquidityBuyQuoteAmount": 2,
"mm_liquiditySpreadPercent": 1.5,
"mm_liquidityTrend": "middle",
"mm_isPriceWatcherActive": false,
"mm_priceWatcherLowPrice": 0.0045,
"mm_priceWatcherMidPrice": 1,
"mm_priceWatcherHighPrice": 0.0145,
"mm_priceWatcherDeviationPercent": 2,
"mm_priceWatcherSource": "const",
"mm_priceWatcherAction": "fill"
}
Показывает версию бота из файла package.json.
Регулярно проверяйте, что вы пользуетесь актуальной версий на Github.
Формат
/version
Пример
/version
I am running on adamant-tradebot software version 2.10.7. Revise code on ADAMANT's GitHub.
Показывает справку бота.
Формат
/help