Команды

  • /balances

    Показывает средства на вашем аккаунте биржи

    Список включает только ненулевые балансы, и приблизительную оценку в 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.

  • /orders

    Показывает открытые ордеры по торговой паре на бирже

    Бот показывает общее количество ордеров по торговой паре на бирже, и количество ордеров по типам из внутреннего хранилища. Общее количество ордеров в хранилище бота может отличаться от реального количества ордеров на бирже по этой паре: вы разместили ордеры на веб-сайте биржи; API биржи может не закрыть ордер, но уведомить бота, что закрыл. Эту разницу бот показывает числом Unknown orders.

    При повторных запросах также показывает изменения относительно предыдущих данных.

    Типы ордеров:

    • Market making — ордеры маркет-мейкинга. Их количество обычно близко к 0, поскольку они “закрывают” друг друга.
    • Dynamic order book — ордеры в “стаканах”. См. команду /enable ob.
    • Tradebot — ордеры торгового бота, который “торгует в плюс”. Не работает, используйте Zenbot.
    • Liquidity — поддержка ликвидности и спреда. См. команду /enable liq.
    • Price watching — поддержка цены токена. См. команду /enable pw.
    • Manual orders — ордеры, которые вы разместили командами /buy, /sell, /fill, /make price.
    • Total — общее число ордеров в хранилище бота.

    Отдельно бот покажет 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

    Показывает статистику по торговой паре на бирже

    Информация включает общую статистику по торгам за сутки, и статистику маркет-мейкинга за сутки, за месяц и за все время работы бота.

    Команда /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.

  • /rates

    Показывает рыночную цену токена

    Бот получает курсы валют от 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%).

  • /calc

    Считает стоимость одной монеты в другой

    Использует рыночные данные 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.

  • /start

    Запускает маркет-мейкинг

    Перед запуском маркет-мейкинга задайте интервалы торговли /interval и количества /amount. Посмотреть текущие параметры можно командой /params.

    При старте бот сообщит, какие опции включены, а какие нет. Вы может включить и отключить их командами /enable и /disable.

    Возможные стратегии:

    • Spread — торговать только “в спред”. Бот размещает ордеры в диапазоне цены между bid и ask, и сам их закрывает следующими ордерами. Если спред меньше минимального, бот прекратит работу до появления спреда, и оповестит вас. С этой стратегией риск слива баланса меньше. Процент ордеров на покупку задайте командой /buyPercent.
    • Orderbook — торговать только в книгу ордеров. Бот покупает и продает из текущих “стаканов”. Торговля выглядит реалистичной, но риск слива балансов велик. Если задана ликвидность /enable liq, бот может покупать сам у себя, снижая риски слива балансов. Если ликвидность отключена, использовать эту стратегию не рекомендую — бот будет покупать дорого, а продавать дешево, увеличит спред и сольет балансы.
    • Optimal — стратегия по умолчанию. Если задана ликвидность, бот будет торговать и в “стаканы”, и в спред. Если ликвидность отключена, бот использует стратегию Spread.

    Команда запускает маркет-мейкинг на бирже 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.

  • /stop

    Останавливает маркет-мейкинг

    Ставит маркет-мейкинг “на паузу”.

    Бот оставит все текущие ордеры активными, а не отменит их. Чтобы отменить их, воспользуйтесь командой /clear.

    Формат

    /stop mm

    Пример

    /stop mm

    Market making, order book building, liquidity and spread maintenance, price watching for ADM/USDT pair are disabled now.

  • /amount

    Устанавливает количество токенов для ордеров маркет-мейкинга

    Задает минимальное и максимальное значения токенов, которые бот размещает в ордерах 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.

  • /interval

    Устанавливает время между ордерами маркет-мейкинга

    Задает минимальное и максимальное время между ордерами маркет-мейкинга.

    Уменьшая это значение, вы увеличите объем торгов — ордеры маркет-мейкинга будут размещаться чаще. См. также /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.

  • /buyPercent

    Устанавливает процент ордеров на покупку и на продажу

    Увеличивая это значение, вы увеличите количество покупок токена, и уменьшите количество продаж.

    Для ордеров 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.

  • /enable

    Включает опции маркет-мейкинга

    Опции можно включить и во время работы бота, и на “на паузе”. Работают опции только при запущенном маркет-мейкинге командой /start mm. Если маркет-мейкинг не запущен, опции будут в ожидании запуска.

    Доступные опции:

    • ob — включить динамическое заполнение стаканов. Бот ставит и убирает ордеры в стаканы, симулируя активность реальных трейдеров. Количества токенов в ордерах задаются командой /amount. Процент ордеров на продажу и на покупку можно изменить командой /buyPercent.
    • liq — поддерживать ликвидность и спред. Бот будет размещать ордеры в стаканах, чтобы обеспечить нужный спред при помощи заданного кол-ва токенов. Обратите внимание: если вы разместите большое кол-во токенов в ликвидности на покупку, найдутся желающие “налить” вашему боту. Бот будет восполнять ликвидность до тех пор, пока позволяет баланс вашего аккаунта.
    • pw — контролировать цену токена в диапазоне low-high. Бот не будет продавать дешевле нижней границы, и покупать дороже верхней. Он будет проверять цену для заказов типа liq, mm, ob. См. /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.

  • /disable

    Выключает опции маркет-мейкинга

    Опции можно выключить и во время работы бота, и на “на паузе”. Отключение опции не остановит маркет-мейкинг. Чтобы остановить маркет-мейкинг, используйте команду /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.

  • /buy

    Размещает ордер на покупку

    Купить токены по рыночной цене, или разместить ордер на покупку в “стакан” — это ордеры типа 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.

  • /sell

    Размещает ордер на продажу

    Продать токены по рыночной цене, или разместить ордер на продажу в “стакан” — это ордеры типа 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.

  • /fill

    Размещает несколько ордеров

    Размещает несколько ордеров на покупку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

    Изменяет показатель для торговой пары

    Команда /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.

  • /clear

    Отменяет активные ордеры по торговой паре

    Список активных ордеров можно получить командой /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

    Подтверждает выполнение команды

    Если в памяти бота есть команда, которая запрашивала подтверждение, /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.

  • /deposit

    Предоставляет адрес для депозита нужной монеты

    Адрес для депозита предоставляет биржа. Некоторые биржи не создают адреса для депозитов по API, для этого зайдите на веб-сайт биржи.

    Ваши балансы на бирже можно получить командой /balances.

    Команда предоставляет адрес для депозита на бирже, которую вы указали в поле exchange файла конфигурации.

    Формат

    /deposit [монета]

    Пример

    /deposit adm

    The deposit address for ADM: U9697541665761260814.

  • /params

    Показывает текущие параметры маркет-мейкинга

    Команда показывает параметры маркет-мейкинга на бирже, которую вы указали в поле 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"
    }

  • /version

    Получить версию приложения бота

    Показывает версию бота из файла package.json.

    Регулярно проверяйте, что вы пользуетесь актуальной версий на Github.

    Формат

    /version

    Пример

    /version

    I am running on adamant-tradebot software version 2.10.7. Revise code on ADAMANT's GitHub.

  • /help

    Показать справку

    Показывает справку бота.

    Формат

    /help

  • Market Making App 2019–2023