diff --git a/go/market-data/market-data-service/README.md b/go/market-data/market-data-service/README.md
new file mode 100644
index 00000000..2274917b
--- /dev/null
+++ b/go/market-data/market-data-service/README.md
@@ -0,0 +1,4 @@
+# market-data-service
+
+This service implements the [market data service api](https://github.com/ettec/open-trading-platform/blob/master/protobuf/services/marketdataservice.proto).  The market data service load balances quote subscriptions across market data gateways by listing id for a given market and fans out market data to clients.  Internally it has a per client conflated queue to ensure that slow clients always get the latest quote.  The service can be scaled by increasing the deployments replica count.
+
diff --git a/go/market-data/quote-aggregator/README.md b/go/market-data/quote-aggregator/README.md
new file mode 100644
index 00000000..ede0579f
--- /dev/null
+++ b/go/market-data/quote-aggregator/README.md
@@ -0,0 +1,3 @@
+# quote-aggregator
+
+This service implements the [market data source api](https://github.com/ettec/open-trading-platform/blob/master/protobuf/services/marketdatasource.proto).  It sources data for multiple listings of the same instrument according to what markets  are available and creates an aggregated quote.  Internally it implements a per client conflating queue such that slow clients will always receive the latest quote.  The service can be scaled by increasing the statefulset replica count.  
\ No newline at end of file
diff --git a/go/order-data-service/.idea/modules.xml b/go/order-data-service/.idea/modules.xml
new file mode 100644
index 00000000..1799f991
--- /dev/null
+++ b/go/order-data-service/.idea/modules.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/order-data-service.iml" filepath="$PROJECT_DIR$/.idea/order-data-service.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file
diff --git a/go/order-data-service/.idea/order-data-service.iml b/go/order-data-service/.idea/order-data-service.iml
new file mode 100644
index 00000000..5e764c4f
--- /dev/null
+++ b/go/order-data-service/.idea/order-data-service.iml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="Go" enabled="true" />
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
\ No newline at end of file
diff --git a/go/order-data-service/.idea/vcs.xml b/go/order-data-service/.idea/vcs.xml
new file mode 100644
index 00000000..b2bdec2d
--- /dev/null
+++ b/go/order-data-service/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/../.." vcs="Git" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/go/order-data-service/.idea/workspace.xml b/go/order-data-service/.idea/workspace.xml
new file mode 100644
index 00000000..c6bbb1a5
--- /dev/null
+++ b/go/order-data-service/.idea/workspace.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ChangeListManager">
+    <list default="true" id="0673e2c7-ddff-4f6f-baa0-12f558d705bc" name="Default Changelist" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="GOROOT" path="/usr/local/go" />
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$/../.." />
+  </component>
+  <component name="GoLibraries">
+    <option name="indexEntireGoPath" value="false" />
+  </component>
+  <component name="ProjectId" id="1iQ442lXkBwCWm4p3noSDRZonMi" />
+  <component name="ProjectLevelVcsManager" settingsEditedManually="true" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">
+    <property name="RunOnceActivity.OpenProjectViewOnStart" value="true" />
+    <property name="WebServerToolWindowFactoryState" value="false" />
+    <property name="go.import.settings.migrated" value="true" />
+    <property name="go.sdk.automatically.set" value="true" />
+    <property name="go.tried.to.enable.integration.vgo.integrator" value="true" />
+    <property name="last_opened_file_path" value="$PROJECT_DIR$/../market-data/market-data-service" />
+  </component>
+  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="VgoProject">
+    <integration-enabled>true</integration-enabled>
+  </component>
+  <component name="WindowStateProjectService">
+    <state x="779" y="311" width="424" height="491" key="FileChooserDialogImpl" timestamp="1601837919216">
+      <screen x="72" y="27" width="1848" height="1053" />
+    </state>
+    <state x="779" y="311" width="424" height="491" key="FileChooserDialogImpl/72.27.1848.1053@72.27.1848.1053" timestamp="1601837919216" />
+  </component>
+</project>
\ No newline at end of file