From eaadc74242a4476c6fe1dc7344ab0504e3e3cbdc Mon Sep 17 00:00:00 2001 From: Eric Harding Date: Tue, 12 Nov 2019 10:36:29 -0500 Subject: [PATCH] SP-230 overview/blog --- .../server/getting-started/orderbook.png | Bin 62267 -> 0 bytes .../server/getting-started/overview.md | 24 ++- .../server/getting-started/paramsui.png | Bin 0 -> 7362 bytes doc/api/content/server/ref/registration.md | 4 + doc/api/content/server/samples/template.md | 146 ++++++++++++++++++ src/lib/plugin/plugin.cpp | 3 + .../examples/algo_template/algo_template.cpp | 24 +++ 7 files changed, 187 insertions(+), 14 deletions(-) delete mode 100644 doc/api/content/server/getting-started/orderbook.png create mode 100644 doc/api/content/server/getting-started/paramsui.png create mode 100644 doc/api/content/server/samples/template.md diff --git a/doc/api/content/server/getting-started/orderbook.png b/doc/api/content/server/getting-started/orderbook.png deleted file mode 100644 index d51380963f6dd3ee6def4fb0ffa85e4f109a77fd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 62267 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 z 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 Nw=?kD+uMKm + -View and change parameters directly in the Spark order book window. - - - -### Algo Studio - -Compose your Algo with out of the box Algos to create new functionality on the fly. +Compose your Algo with out of the box Algos in the Spark Algo Studio to create new functionality on the fly.
- + diff --git a/doc/api/content/server/getting-started/paramsui.png b/doc/api/content/server/getting-started/paramsui.png new file mode 100644 index 0000000000000000000000000000000000000000..d81b39c354d4e5c28c81198a091f324708531999 GIT binary patch literal 7362 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 QK$d~v+D2NX&^yom4+P;?(f|Me literal 0 HcmV?d00001 diff --git a/doc/api/content/server/ref/registration.md b/doc/api/content/server/ref/registration.md index f77f3a17e..c909a42ac 100644 --- a/doc/api/content/server/ref/registration.md +++ b/doc/api/content/server/ref/registration.md @@ -42,6 +42,10 @@ The above parameters look like this when rendered in the Spark ladder. +And like this when viewed in the Spark order book. + + + Each descriptor can be one of the following types: ``` // Primitive diff --git a/doc/api/content/server/samples/template.md b/doc/api/content/server/samples/template.md new file mode 100644 index 000000000..48c8150c0 --- /dev/null +++ b/doc/api/content/server/samples/template.md @@ -0,0 +1,146 @@ ++++ +title = "Template" +weight = 5 ++++ + +A mostly blank Algo template that can be used as a jump-start for developing a new Algo. + +
+ +This sample is part of the Server SDK examples included in the spark_sdk.zip download. +
+ +```cpp +#include "spark/lib/config/config.h" +#include "spark/lib/config/protos/system.pb.h" +#include "spark/lib/domain_model/Security.h" +#include "spark/lib/orderman/orders/algo/IAlgoOrder.h" +#include "spark/lib/orderman/orders/algo/IAlgoServices.h" +#include "spark/lib/plugin/SparkServices.h" + +#include "spark/lib/orderman/order_factory/IOrderFactory.h" +#include "spark/lib/orderman/orderman_utils/Book.h" +#include "spark/lib/orderman/orderman_utils/orderman_utils.h" +#include "spark/lib/utils/PBUtils.h" + +using namespace bts::api::orderman; +using namespace bts::orderman; + +namespace bts { +namespace order_example { + +// MyAlgo is a blank IAlgoOrder which you can copy when starting a new Algo +class MyAlgo : public IAlgoOrder { + public: + MyAlgo(); + ~MyAlgo(); + + OrderOpResult do_before_launch(IBeforeLaunchAlgoServices &) override; + void do_launch(IAlgoServices &) override; + void do_launch_attached(IAlgoServices &, OrderKey, ChildState) override; + void do_update(api::orderman::Update const &) override; + void on_book(SecurityKey, Book const &) override; + void on_child_change(OrderKey, ChildState const &) override; + + private: + IAlgoServices* algo_services; + ChildTemplate *child_template = nullptr; + OrderKey child_key = null_order_key(); +}; + + +MyAlgo::MyAlgo() : algo_services(nullptr) {} +MyAlgo::~MyAlgo() {} + +// This is called outside of the latency sensitive path. +// Expensive initialization should be done here, rather than in do_launch() +OrderOpResult MyAlgo::do_before_launch(IBeforeLaunchAlgoServices &serv) { + LOG(Sdk,Info, "MyAlgo: do_before_launch"); + // If we are not attaching, create a child template so we can + // quickly launch our child when the time comes. + if (!serv.is_attaching()) { + // We will be sending a limit order with the same side, + // security, trader, account, etc, as this algo order, so just + // copy our definition to the child definition to start with. + auto child_def = serv.definition(); + // Now add a limit order component to mark our child as a limit + // order. Limit orders do not require any extra parameters + // beyond those already inherited from this algo order + // (i.e. beyond what we obtained through serv.definition()) so + // we can just use a default constructed LimitOrderDefinition. + *child_def.mutable_custom_def()->mutable_limit() = LimitOrderDefinition{}; + // Now just build the child template and cache it for future use + child_template = &(serv.make_child_template(child_def)); + } + // Default constructed result is successful + return {}; +} + +// Called in the latency sensitive path, once, when the algo is first launched. +// If the Algo is attaching to an existing order do_launch_attached is called instead. +void MyAlgo::do_launch(IAlgoServices &services) { + algo_services = &services; + // Subscribe to book updates for this security + services.subscribe_book(SecurityKey(services.security().id())); + // Launch a child limit order + child_key = + services.launch_child(*child_template, services.price(), services.quantity()); + LOG(Sdk,Info, "MyAlgo: do_launch"); +} + +// Called in the latency sensitive path, once, when the algo is first +// launched. In this case the algo is provided with an existing order +// it is now responsible for managing. +void MyAlgo::do_launch_attached(IAlgoServices &services, + OrderKey attached_order, ChildState st) { + algo_services = &services; + // Subscribe to book updates for this security + services.subscribe_book(SecurityKey(services.security().id())); + // Keep track of the child key + child_key = attached_order; + LOG(Sdk,Info, "MyAlgo: do_launch_attached"); +} + +// Called when a human (or a supervising algo) updates a parameter for +// this algo. The implementation validates the update and depending on +// the validation outcome either applies the update or terminates the algo. +void MyAlgo::do_update(api::orderman::Update const &update) { +} + +// Called when the book for the specified security has changed +void MyAlgo::on_book(SecurityKey, Book const &b) { +} + +// Our child reported a change +void MyAlgo::on_child_change(OrderKey, ChildState const &st) { +} + +// This is called by the spark daemon at startup. In this call we +// describe our algo's parameters and register a factory function to +// create an instance of the algo. +extern "C" void init_spark_plugin(bts::SparkServices &serv) { + using namespace bts; + + DynamicOrderDescriptor desc; + + // Start by naming our order type + desc.set_dynamic_order_type("My Algo"); + + *desc.add_param_desc() = param_bool("Enable Feature"); + *desc.add_param_desc() = param_uint32("Feature Quantity"); + + // Associate the descriptor with a builder function and register + // that with the Spark server. + auto result = + serv.register_dynamic_algo_order( + desc, []() { return std::make_unique(); }); + + if (result != bts::AlgoRegistrationResult::SUCCESS) { + // The desc has errors + // Check the error log (/sparkdata/data/logging/log) for more details + } +} + +} // namespace order_example +} // namespace bts +``` \ No newline at end of file diff --git a/src/lib/plugin/plugin.cpp b/src/lib/plugin/plugin.cpp index 5cab0e815..0c72dad5c 100644 --- a/src/lib/plugin/plugin.cpp +++ b/src/lib/plugin/plugin.cpp @@ -9,11 +9,14 @@ #include #include +void init_spark_plugin(bts::SparkServices &serv); + namespace bts { namespace plugin { using namespace bts::orderman; + void init_plugins(SparkServices &services) { static std::vector( diff --git a/src/sdk/examples/algo_template/algo_template.cpp b/src/sdk/examples/algo_template/algo_template.cpp index 276177dda..41e55969a 100644 --- a/src/sdk/examples/algo_template/algo_template.cpp +++ b/src/sdk/examples/algo_template/algo_template.cpp @@ -31,6 +31,8 @@ class MyAlgo : public IAlgoOrder { private: IAlgoServices* algo_services; + ChildTemplate *child_template = nullptr; + OrderKey child_key = null_order_key(); }; @@ -41,6 +43,22 @@ MyAlgo::~MyAlgo() {} // Expensive initialization should be done here, rather than in do_launch() OrderOpResult MyAlgo::do_before_launch(IBeforeLaunchAlgoServices &serv) { LOG(Sdk,Info, "MyAlgo: do_before_launch"); + // If we are not attaching, create a child template so we can + // quickly launch our child when the time comes. + if (!serv.is_attaching()) { + // We will be sending a limit order with the same side, + // security, trader, account, etc, as this algo order, so just + // copy our definition to the child definition to start with. + auto child_def = serv.definition(); + // Now add a limit order component to mark our child as a limit + // order. Limit orders do not require any extra parameters + // beyond those already inherited from this algo order + // (i.e. beyond what we obtained through serv.definition()) so + // we can just use a default constructed LimitOrderDefinition. + *child_def.mutable_custom_def()->mutable_limit() = LimitOrderDefinition{}; + // Now just build the child template and cache it for future use + child_template = &(serv.make_child_template(child_def)); + } // Default constructed result is successful return {}; } @@ -51,6 +69,9 @@ void MyAlgo::do_launch(IAlgoServices &services) { algo_services = &services; // Subscribe to book updates for this security services.subscribe_book(SecurityKey(services.security().id())); + // Launch a child limit order + child_key = + services.launch_child(*child_template, services.price(), services.quantity()); LOG(Sdk,Info, "MyAlgo: do_launch"); } @@ -60,7 +81,10 @@ void MyAlgo::do_launch(IAlgoServices &services) { void MyAlgo::do_launch_attached(IAlgoServices &services, OrderKey attached_order, ChildState st) { algo_services = &services; + // Subscribe to book updates for this security services.subscribe_book(SecurityKey(services.security().id())); + // Keep track of the child key + child_key = attached_order; LOG(Sdk,Info, "MyAlgo: do_launch_attached"); }