Статьи ·
Какие рыночные данные принимает бэктест Metrand
Бэктест правдив ровно настолько, насколько правдивы бары, которые он получил. Одна кривая свеча может открыть позицию по цене, по которой рынок никогда не торговал; время, ошибочное в тысячу раз, превращает год в несколько часов; бары, присланные от новых к старым, дают стратегии решать по будущему. Поэтому движок проверяет каждый бар до того, как что-либо проигрывать, и отклоняет запрос, называя первый неверный бар и причину.
Те же проверки действуют для баров рынка, которым торгует стратегия, для каждого другого рынка, который она читает, и для мелких свечей, которые можно передать под бары.
Каждый бар
| Поле | Правило |
|---|---|
o, h, l, c |
конечные числа больше нуля |
h, l |
максимум не ниже открытия и закрытия; минимум не выше их |
v |
конечный и неотрицательный (можно не передавать — тогда 0) |
t |
время открытия бара в миллисекундах с 1970-01-01 UTC, неотрицательное |
Ряд
- Вперёд по времени, каждый бар один раз. Каждый бар открывается позже предыдущего. Дубликат или бар не по порядку отклоняются.
- Миллисекунды, а не секунды. Бары с шагом меньше секунды отклоняются: их время почти наверняка в секундах.
- Время открытия, а не закрытия. Ряд, где у каждого бара стоит время закрытия (
открытие + таймфрейм − 1 мс, как некоторые API отдают рядом со временем открытия), отклоняется: иначе движок считал бы каждый бар на бар позже. - Один таймфрейм. Таймфрейм — это шаг, которому следует большинство баров. Любой другой шаг должен быть кратен ему: получасовой бар внутри часового ряда отклоняется. У месячных баров длина разная, у них проверяется только порядок.
- Дыр не больше, чем баров. Ряд, в котором пропущено больше шагов, чем в нём есть баров, — не один таймфрейм, и он отклоняется.
- Не пустой. Пустой список отклоняется. Синтетический демо-ряд движка получает только запрос, в котором баров нет
вовсе, и его отчёт пишет
"source": "synthetic".
Где кончается окно
Окно кончается последним баром, который закрылся к его концу. Конец посреди часа заканчивает часовое окно на предыдущем баре — никогда не на баре, который идёт дальше запрошенного момента, и никогда не на баре, который ещё формируется сейчас.
Только бары самого торгуемого рынка
Бэктест проигрывает бары рынка, которым торгует стратегия: фьючерсов Binance USDⓈ-M или бессрочных контрактов Bybit. Бары по 5 и 15 секунд, которые графики платформы собирают из спотовых секунд Binance, — это другой рынок, а фьючерсный рынок секундных баров не публикует, поэтому бэктест отклоняет эти таймфреймы, а не проигрывает молча спотовые цены.
Другие рынки
Стратегия, читающая другие рынки, получает их бары на том же таймфрейме, что и рынок, которым она торгует. Бары сливаются в порядке открытия, а он совпадает с порядком закрытия, только если бары одной длины: 4-часовой бар другого рынка под часовой стратегией дошёл бы до неё за часы до своего закрытия, поэтому такой запрос отклоняется. Когда бары двух рынков открываются в один момент, первым идёт бар торгуемого рынка — в том же порядке их получает живой запуск.
Баров, которых нет у биржи
В истории бирж есть дыры: обслуживание, сбои, пробелы в опубликованных архивах. Дыра — это история рынка, а не ошибка, поэтому движок проходит её так, как рынок возобновился: позиция, удерживаемая через разрыв, оценивается по открытию следующего бара, а стоп, через который цена перепрыгнула, исполняется там же.
Изменилось то, что дыра больше не невидима. Отчёт сообщает, сколько баров не хватало между первым и последним баром и
какой был самый длинный отрезок без баров (report.config.missing_bars, report.config.largest_gap_ms), а приложение
пишет это под результатом.
Прогон этих проверок по пяти годам 15-минутной истории фьючерсов Binance для десяти крупных монет показал, что все бары корректны, и нашёл одну дыру: три дня у LTCUSDT, XLMUSDT и XRPUSDT, по 480 пропущенных баров, которые прежние отчёты проходили молча.
Фандинг
Расчёты фандинга должны идти по порядку времени, каждый с конечной ставкой в долях за расчёт (0.0001 — это 0,01%). Ставка больше 10% по модулю отклоняется как ошибочно присланные проценты.
Ряд фандинга должен быть ещё и полным на торгуемом отрезке: ни одного промежутка длиннее 8,5 часа — самого длинного
интервала расчётов у бирж и получаса на публикацию свежего расчёта — без расчёта. Ряд с дырой списал бы фандинг за часть окна, а остальное оставил бы бесплатным,
никак об этом не сообщив. Не присылать фандинг вовсе можно: бэктест тогда идёт без него, а отчёт пишет
funding_applied: false. Собственная история фандинга платформы прошла эту проверку на пяти годах десяти крупных монет,
включая те три дня, когда у них не было свечей.
В API
Отклонённый запрос возвращает ошибку, которая начинается с backtest_candles_invalid: или backtest_funding_invalid:
и называет ряд (рынок стратегии, detail или инструмент другого рынка), номер бара и что с ним не так, — чтобы клиент
или ИИ-агент мог исправить данные и прислать их снова.