Max Agent
Artykuły

Od alertu do zamknięcia pozycji: jak uporządkować historię zdarzeń

Proponowany dziennik kontroli: oddziel warunek alertu, próbę wysłania zlecenia, wykonane ilości i rozliczenie pozycji. Następnie porównaj dowody z historią giełdy.

RedakcjaOpublikowano Zaktualizowano

Najpierw ustal, co chcesz potwierdzić

Zacznij od jednego pytania: jaki dokładnie etap chcesz uznać za potwierdzony? W tym poradniku proponujemy prowadzenie osobnych zapisów dla alertu, wysłania zlecenia, potwierdzenia przyjęcia, wykonanych ilości oraz zamknięcia pozycji. To nasza konwencja dokumentowania procesu. Nie traktuj tych nazw jako specyfikacji statusów konkretnej giełdy ani deklaracji sposobu działania integracji MaxData.

Wybierz jedną automatyzację, jeden instrument i jeden przedział czasu. Na początek proponujemy ćwiczenie na zapisach testowych albo wcześniej wyeksportowanej historii. Celem zadania niech będzie odpowiedź: „Które zdarzenia umiem połączyć za pomocą dokumentów?”, zamiast oceny, czy należało kupić lub sprzedać.

Dokumentacja MaxData opisuje Alert jako powiadomienie o spełnieniu pojedynczego warunku, a Pro Alert jako powiadomienie o spełnieniu kilku warunków. [PL1] Opis alertów.

Nasza propozycja: w dzienniku używaj słowa „alert” wyłącznie dla etapu warunku i powiadomienia. Dla kolejnych etapów wymagaj oddzielnych pól oraz oddzielnych dowodów. Tak zdefiniuj zakres własnego audytu, zanim zaczniesz oceniać pojedynczy przypadek.

Pięć etykiet i dowód wymagany przy każdej

Poniższy słownik jest naszą proponowaną konwencją, a nie listą uniwersalnych statusów giełdowych:

  1. Alert / alert triggered. Zapisz identyfikator reguły, jej wersję, instrument, warunek oraz czas zdarzenia. Jako dowód przyjmuj zapis wywołania reguły.
  2. Wysłano / submitted. Tę etykietę przypisuj do udokumentowanej próby przekazania żądania. Dołącz identyfikator próby, żądaną ilość, kierunek i treść odpowiedzi, jeżeli ją posiadasz.
  3. Przyjęto / acknowledged. W swoim dzienniku wymagaj tutaj odpowiedzi giełdy identyfikującej zlecenie. Bez niej pozostaw wynik przyjęcia jako nieustalony.
  4. Częściowo wykonano / partially filled. W tej konwencji używaj etykiety dopiero po zapisaniu wykonanej ilości większej od zera i mniejszej od ilości objętej badanym zleceniem. Zachowaj odwołania do wykonanych transakcji.
  5. Zamknięto / position reconciled as closed. Rezerwuj tę etykietę dla rozliczenia ilości przypisanej do badanego procesu według jawnie zapisanych zasad.

Dla każdego wiersza dodaj także „źródło dowodu” i „czego jeszcze nie ustalono”. Zamiast wpisywać ogólne „sukces”, wybierz konkretny etap. Zamiast „błąd”, zapisz pytanie wymagające sprawdzenia, na przykład: „Brakuje odpowiedzi zawierającej identyfikator zlecenia”.

Przy zamknięciu ustal własną zasadę dotyczącą reszty ilościowej. Jeżeli przyjmiesz dopuszczalne odchylenie, nazwij je, uzasadnij i pokaż obok wyniku. Nie ukrywaj go przez zaokrąglenie prezentowanej liczby. Proponujemy osobne pole „pozostałość”, nawet gdy końcową etykietą jest „rozliczone”.

Nasza konwencja

Trzy pytania do dokumentów

Alert
Pytanie
Która reguła?
Wymagaj
Zapisu wywołania
Przy braku dowodu
Nieustalone
Wysłanie
Pytanie
Która próba?
Wymagaj
Zapisu żądania
Przy braku dowodu
Nieustalone
Wykonana ilość
Pytanie
Które wykonania?
Wymagaj
Rekordów wykonania
Przy braku dowodu
Nieustalone
Proponowane wymagania dla własnego dziennika, a nie opis statusów giełdy. Porównanie proponowanych dowodów dla alertu, wysłania żądania i wykonanej ilości.

Zbuduj kartę reguły i zegar zdarzeń

Dokumentacja Pro Alertów opisuje okno czasowe spełnienia warunków, uśpienie po wywołaniu, wybór momentu aktywacji oraz wybór źródła danych, na przykład otwarcia lub zamknięcia. [PL2] Parametry Pro Alertu.

Na tej podstawie proponujemy kartę konfiguracji. Zapisz nazwę metryki, dokładne źródło danych, instrument, interwał, próg, okno warunków, uśpienie i termin obowiązywania konfiguracji. Dodaj wersję reguły, aby podczas przeglądu wskazywać konkretny zestaw ustawień.

Oddziel czas zdarzenia od czasu jego odebrania i czasu pobrania historii. Przy każdym polu zanotuj strefę czasową oraz pochodzenie znacznika. Jeżeli eksport pokazuje tylko minuty, zachowaj tę dokładność. Nie dopisuj sekund na podstawie kolejności w tabeli.

Dla opóźnienia proponujemy trzy rubryki: „pomiar”, „zakres obserwacji” i „brak danych”. Ten poradnik nie przyjmuje typowego opóźnienia ani gwarantowanego czasu realizacji. Własny pomiar opisuj wraz z początkiem i końcem mierzonego odcinka. Horyzont analizy również ustal wcześniej: przykładowo od wywołania reguły do zakończenia uzgadniania konkretnego zlecenia.

Uzgadnianie z giełdą krok po kroku

Poniższa procedura jest naszą propozycją pracy z dokumentami. Nazwy pól dopasuj do eksportu i dokumentacji wybranej giełdy; nie zakładaj ich obecności.

Krok pierwszy: zamroź zakres. Zapisz konto, instrument, rodzaj rynku oraz początek i koniec badanego okresu. Zachowaj kopię danych wejściowych z datą pobrania. Oznacz, czy analizujesz pojedyncze zlecenie, czy cały cykl wejścia i wyjścia.

Krok drugi: zbierz trzy grupy zapisów. Przygotuj historię alertów, dziennik żądań automatyzacji oraz historię zleceń i wykonanych transakcji z giełdy. Przy brakującym eksporcie wpisz „niepozyskany”, zamiast odtwarzać jego zawartość z pamięci.

Krok trzeci: połącz identyfikatory. Proponujemy zapisywać powiązanie reguła → próba wysłania → zlecenie → wykonanie. Przy każdym połączeniu wskaż pole, na którym je oparto. Dopasowanie wyłącznie po podobnym czasie oznacz jako hipotezę do sprawdzenia.

Krok czwarty: porównaj ilości. W osobnych kolumnach umieść ilość żądaną, wykonania uwzględnione w rozliczeniu i pozostałość. Zachowaj jednostkę przy każdej liczbie. Nie zastępuj ilości tokena wartością pieniężną bez opisania sposobu przeliczenia.

Krok piąty: sprawdź status i kompletność. Odczytaj znaczenie statusu w dokumentacji używanej giełdy. Zaznacz zakres eksportu, wykorzystane filtry i moment pobrania. Przy ponownym odczycie zachowaj poprzednią wersję porównania.

Krok szósty: zapisz rozstrzygnięcie. Wybierz „potwierdzone”, „częściowo potwierdzone” albo „nieustalone” i dopisz uzasadnienie. Dla otwartego pytania wskaż brakujący dokument oraz następny krok, bez automatycznego ponawiania transakcji w ramach tego ćwiczenia.

Proponowany workflow

Od zakresu do rozstrzygnięcia

  1. 1

    Ustal zakres

    Wskaż konto, instrument, okres i jednostkę analizy.

  2. 2

    Zbierz dokumenty

    Zachowaj historię alertów, żądań i dane z giełdy.

  3. 3

    Porównaj

    Połącz identyfikatory oraz rozpisz ilości i pozostałości.

  4. 4

    Rozstrzygnij

    Zapisz potwierdzenie albo konkretną lukę w dowodach.

Przy każdym połączeniu zapisz dokument i pole stanowiące podstawę dopasowania. Cztery etapy proponowanej procedury: zakres, dokumenty, porównanie i rozstrzygnięcie.

Przykład ćwiczeniowy: 10 jednostek i dwa wykonania

Przyjmijmy całkowicie wymyślony zestaw danych. Reguła A ma wywołanie o 10:00. Próba R dotyczy zakupu 10 jednostek instrumentu X. W materiale ćwiczeniowym odpowiedź przypisuje jej zlecenie O. Dwa rekordy wykonania mają ilości 3 i 4 jednostki. Późniejszy rekord oznacza niewykonaną resztę jako anulowaną.

Zastosuj naszą konwencję: oznacz alert, próbę wysłania i przyjęcie osobno. Dla ilości wykonanej wpisz 7, a dla niewykonanej części badanego żądania 3. Nie oznaczaj całego cyklu jako zamkniętej pozycji. W ćwiczeniu brakuje jeszcze dokumentów rozliczających wyjście z przypisanych 7 jednostek.

Następnie dodaj wymyślony rekord sprzedaży 5 jednostek. W rubryce roboczej pozostaw 2 jednostki do rozliczenia według przyjętych założeń. Jeśli ćwiczenie obejmuje opłaty pobierane w tokenie, dodaj je jako osobny element zadania i jawnie zmień równanie uzgodnienia.

Dla każdego dopasowania przygotuj warunek unieważnienia. Przykłady: inny instrument w odpowiedzi, identyfikator przypisany do innego konta albo brak rekordu wskazanego wykonania. Po wykryciu takiego warunku cofnij własne rozstrzygnięcie do „nieustalone” i opisz powód.

Dane wymyślone

Prześledź jeden przypadek

  1. Reguła A

    Przypisz zapis wywołania o 10:00.

  2. Próba R

    Przypisz żądanie 10 jednostek i odpowiedź ze zleceniem O.

  3. Wykonania

    W ćwiczeniu rozpisz 3 i 4 jednostki oraz anulowaną resztę.

  4. Wyjście

    Po fikcyjnej sprzedaży 5 jednostek pozostaw 2 do rozliczenia.

Ćwiczenie według przyjętej konwencji; liczby nie opisują rzeczywistej transakcji. Kolejne etapy fikcyjnego przypadku: reguła A, próba R, wykonania 3 i 4 oraz rozliczenie wyjścia.

Oddziel badanie sygnału od badania wykonania

Opis backtestów MaxData wskazuje dane z Pro Alertów i historię ceny instrumentu jako podstawę analizy oraz wymienia symulacje TP, SL i zamknięcia po czasie. [PL3] Opis backtestów.

Proponujemy dwa osobne arkusze. W pierwszym badaj historyczne zdarzenia: definicję reguły, okres próby, liczbę obserwacji i horyzont po sygnale. W drugim oceniaj kompletność dokumentacji wykonania: żądania, odpowiedzi, ilości, ceny i koszty.

Przy porównywaniu modelu z własnymi zapisami dodaj rubryki na prowizje, przyjętą definicję poślizgu, założenia płynności i zasady doboru próby. Oznacz, które parametry dobrano na tej samej historii, a które sprawdzano na osobnym okresie. Nie przypisuj brakującym kosztom wartości zero; wpisz „nieustalone”. Wynikom historycznym nie nadawaj w tym arkuszu etykiety oczekiwanego przyszłego zysku.

Pakiet do wyjaśnienia rozbieżności

Na koniec przygotuj naszą proponowaną paczkę diagnostyczną: wersję reguły, zakres czasu, identyfikatory, oczekiwany etap, zaobserwowany etap i listę braków. Dołącz tylko informacje potrzebne do odtworzenia pytania; usuń dane uwierzytelniające.

Help Hub przedstawia MaxData Info Bot jako asystenta odpowiadającego na pytania o MaxData i workspace. [PL4] MaxData Help Hub.

Pytanie sformułuj konkretnie: „Mam zapis wywołania reguły A i próbę R; jak odnaleźć odpowiedź przypisującą zlecenie O?”. Za kryterium zakończenia przeglądu przyjmij udokumentowane rozstrzygnięcie albo precyzyjnie nazwaną lukę. To nasza propozycja standardu pracy z historią zdarzeń.

Źródła

  1. MaxData Help Hub – Pomoc i przewodniki Mój workspace — agent.maxdata.app; dostęp 17 listopada 2026
  2. Pro Alerty Alerty Notyfikacje Sygnaly Szablony — agent.maxdata.app; dostęp 17 listopada 2026
  3. Backtesty Automatyczne Weryfikowanie Strategii — agent.maxdata.app; dostęp 17 listopada 2026

Zacznij działać z własnym agentem

Agent zna kontekst tego artykułu i nadal realizuje checklistę przypisanego działu.

Załóż konto MaxData
Max Agent
Alert, zlecenie i realizacja: uzgadnianie historii zdarzeń