dexbot 1.1.10

package/dist/analysis/bot_usage/kibana_bot_queries.d.ts

@@ -0,0 +1,546 @@
+/**
+ * KIBANA BOT QUERIES
+ *
+ * Elasticsearch query builders for analyzing DEXBot / DEXBot2 order activity
+ * on the BitShares blockchain via the public Kibana instance.
+ *
+ * Data source:
+ *   https://kibana.bitshares.dev / bitshares-* index
+ *   Time field: block_data.block_time
+ *
+ * BitShares operation types used here:
+ *   1 = limit_order_create  (field: op_object.seller)
+ *   2 = limit_order_cancel  (field: op_object.fee_paying_account)
+ *   4 = fill_order          (field: op_object.account_id)
+ *
+ * Relevant ES field paths:
+ *   limit_order_create:
+ *     op_object.seller                    — account that placed the order
+ *     op_object.amount_to_sell.amount     — integer sell amount
+ *     op_object.amount_to_sell.asset_id   — sell asset ID (e.g. '1.3.0' = BTS)
+ *     op_object.min_to_receive.amount     — integer min-receive (= limit price numerator)
+ *     op_object.min_to_receive.asset_id   — receive asset ID
+ *     op_object.expiration                — ISO datetime
+ *
+ *   fill_order:
+ *     op_object.account_id                — whose order was filled
+ *     op_object.pays.amount / .asset_id   — what was paid
+ *     op_object.receives.amount / .asset_id — what was received
+ *     op_object.order_id                  — the limit order that filled
+ *
+ *   limit_order_cancel:
+ *     op_object.fee_paying_account        — account that cancelled
+ *     op_object.order                     — the order ID cancelled
+ */
+/**
+ * Time-bucketed count of limit_order_create ops for an account.
+ * Optionally filtered to orders selling a specific asset.
+ */
+declare function buildOrderCreateQuery(accountId: any, lookbackHours: any, intervalSeconds?: number, sellAssetId?: any): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.seller.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.seller.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_time: {
+            date_histogram: {
+                field: string;
+                fixed_interval: any;
+                min_doc_count: number;
+            };
+        };
+        total: {
+            value_count: {
+                field: string;
+            };
+        };
+    };
+};
+/**
+ * Time-bucketed count of fill_order ops for an account.
+ * Optionally filtered to fills where account pays a specific asset.
+ */
+declare function buildFillOrderQuery(accountId: any, lookbackHours: any, intervalSeconds?: number, paysAssetId?: any): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.account_id.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.account_id.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_time: {
+            date_histogram: {
+                field: string;
+                fixed_interval: any;
+                min_doc_count: number;
+            };
+        };
+        total: {
+            value_count: {
+                field: string;
+            };
+        };
+    };
+};
+/**
+ * Time-bucketed count of limit_order_cancel ops for an account.
+ */
+declare function buildOrderCancelQuery(accountId: any, lookbackHours: any, intervalSeconds?: number): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.fee_paying_account.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.fee_paying_account.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_time: {
+            date_histogram: {
+                field: string;
+                fixed_interval: any;
+                min_doc_count: number;
+            };
+        };
+        total: {
+            value_count: {
+                field: string;
+            };
+        };
+    };
+};
+/**
+ * Daily activity breakdown by operation type for an account.
+ * Merges creates (by seller), fills (by account_id), cancels (by fee_paying_account)
+ * into one aggregation using a filter per op type.
+ */
+declare function buildDailyActivityQuery(accountId: any, lookbackHours: any): {
+    size: number;
+    query: {
+        bool: {
+            filter: {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+            }[];
+        };
+    };
+    aggs: {
+        creates: {
+            filter: {
+                bool: {
+                    filter: ({
+                        term: {
+                            operation_type: number;
+                            'operation_history.op_object.seller.keyword'?: undefined;
+                        };
+                    } | {
+                        term: {
+                            'operation_history.op_object.seller.keyword': any;
+                            operation_type?: undefined;
+                        };
+                    })[];
+                };
+            };
+            aggs: {
+                by_day: {
+                    date_histogram: {
+                        field: string;
+                        fixed_interval: string;
+                        min_doc_count: number;
+                    };
+                };
+            };
+        };
+        fills: {
+            filter: {
+                bool: {
+                    filter: ({
+                        term: {
+                            operation_type: number;
+                            'operation_history.op_object.account_id.keyword'?: undefined;
+                        };
+                    } | {
+                        term: {
+                            'operation_history.op_object.account_id.keyword': any;
+                            operation_type?: undefined;
+                        };
+                    })[];
+                };
+            };
+            aggs: {
+                by_day: {
+                    date_histogram: {
+                        field: string;
+                        fixed_interval: string;
+                        min_doc_count: number;
+                    };
+                };
+            };
+        };
+        cancels: {
+            filter: {
+                bool: {
+                    filter: ({
+                        term: {
+                            operation_type: number;
+                            'operation_history.op_object.fee_paying_account.keyword'?: undefined;
+                        };
+                    } | {
+                        term: {
+                            'operation_history.op_object.fee_paying_account.keyword': any;
+                            operation_type?: undefined;
+                        };
+                    })[];
+                };
+            };
+            aggs: {
+                by_day: {
+                    date_histogram: {
+                        field: string;
+                        fixed_interval: string;
+                        min_doc_count: number;
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * Fetch raw limit_order_create documents for grid spacing analysis.
+ * Returns the price-relevant fields plus timestamps.
+ *
+ * @param {string}  accountId
+ * @param {number}  lookbackHours
+ * @param {string}  [sellAssetId]   - optional: filter to one sell-side asset
+ * @param {number}  [maxResults]
+ * @returns {Object} Elasticsearch query object
+ */
+declare function buildOrderPriceQuery(accountId: any, lookbackHours: any, sellAssetId?: any, maxResults?: number): {
+    size: number;
+    _source: string[];
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.seller.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.seller.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    sort: {
+        'block_data.block_time': {
+            order: string;
+        };
+    }[];
+};
+/**
+ * Fetch raw fill_order documents for fill-price analysis.
+ *
+ * @param {string}  accountId
+ * @param {number}  lookbackHours
+ * @param {string}  [paysAssetId]
+ * @param {number}  [maxResults]
+ * @returns {Object} Elasticsearch query object
+ */
+declare function buildFillPriceQuery(accountId: any, lookbackHours: any, paysAssetId?: any, maxResults?: number): {
+    size: number;
+    _source: string[];
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.account_id.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.account_id.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    sort: {
+        'block_data.block_time': {
+            order: string;
+        };
+    }[];
+};
+/**
+ * Discover which asset pairs an account trades by aggregating the sell asset IDs.
+ * Returns top asset IDs by order count.
+ */
+declare function buildAssetDiscoveryQuery(accountId: any, lookbackHours: any): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                    'operation_history.op_object.seller.keyword'?: undefined;
+                };
+                range?: undefined;
+            } | {
+                term: {
+                    'operation_history.op_object.seller.keyword': any;
+                    operation_type?: undefined;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        sell_assets: {
+            terms: {
+                field: string;
+                size: number;
+            };
+        };
+        recv_assets: {
+            terms: {
+                field: string;
+                size: number;
+            };
+        };
+    };
+};
+declare function fetchOrderCreate(accountId: any, lookbackHours: any, config?: {}, sellAssetId?: any, intervalSeconds?: number): Promise<any>;
+declare function fetchFillOrder(accountId: any, lookbackHours: any, config?: {}, paysAssetId?: any, intervalSeconds?: number): Promise<any>;
+declare function fetchOrderCancel(accountId: any, lookbackHours: any, config?: {}, intervalSeconds?: number): Promise<any>;
+declare function fetchOrderPrices(accountId: any, lookbackHours: any, config?: {}, sellAssetId?: any, maxResults?: number): Promise<any>;
+declare function fetchFillPrices(accountId: any, lookbackHours: any, config?: {}, paysAssetId?: any, maxResults?: number): Promise<any>;
+declare function fetchDailyActivity(accountId: any, lookbackHours: any, config?: {}): Promise<any>;
+declare function fetchAssetDiscovery(accountId: any, lookbackHours: any, config?: {}): Promise<any>;
+/**
+ * Top N accounts by limit_order_create count (seller field).
+ * Use this to discover the most active order-placing accounts.
+ */
+declare function buildTopSellerAccountsQuery(lookbackHours: any, topN?: number, minCreates?: number): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_account: {
+            terms: {
+                field: string;
+                size: number;
+                min_doc_count: number;
+                order: {
+                    _count: string;
+                };
+            };
+        };
+    };
+};
+/**
+ * Top N accounts by limit_order_cancel count (fee_paying_account field).
+ */
+declare function buildTopCancellerAccountsQuery(lookbackHours: any, topN?: number, minCancels?: number): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_account: {
+            terms: {
+                field: string;
+                size: number;
+                min_doc_count: number;
+                order: {
+                    _count: string;
+                };
+            };
+        };
+    };
+};
+/**
+ * Top N accounts by fill_order count (account_id field).
+ */
+declare function buildTopFilledAccountsQuery(lookbackHours: any, topN?: number, minFills?: number): {
+    size: number;
+    query: {
+        bool: {
+            filter: ({
+                term: {
+                    operation_type: number;
+                };
+                range?: undefined;
+            } | {
+                range: {
+                    'block_data.block_time': {
+                        gte: string;
+                        lte: string;
+                    };
+                };
+                term?: undefined;
+            })[];
+        };
+    };
+    aggs: {
+        by_account: {
+            terms: {
+                field: string;
+                size: number;
+                min_doc_count: number;
+                order: {
+                    _count: string;
+                };
+            };
+        };
+    };
+};
+declare const _default: {
+    OP_LIMIT_ORDER_CREATE: number;
+    OP_LIMIT_ORDER_CANCEL: number;
+    OP_FILL_ORDER: number;
+    DEFAULT_CONFIG: any;
+    kibanaSearch: any;
+    buildOrderCreateQuery: typeof buildOrderCreateQuery;
+    buildFillOrderQuery: typeof buildFillOrderQuery;
+    buildOrderCancelQuery: typeof buildOrderCancelQuery;
+    buildDailyActivityQuery: typeof buildDailyActivityQuery;
+    buildAssetDiscoveryQuery: typeof buildAssetDiscoveryQuery;
+    buildOrderPriceQuery: typeof buildOrderPriceQuery;
+    buildFillPriceQuery: typeof buildFillPriceQuery;
+    fetchOrderCreate: typeof fetchOrderCreate;
+    fetchFillOrder: typeof fetchFillOrder;
+    fetchOrderCancel: typeof fetchOrderCancel;
+    fetchOrderPrices: typeof fetchOrderPrices;
+    fetchFillPrices: typeof fetchFillPrices;
+    fetchDailyActivity: typeof fetchDailyActivity;
+    fetchAssetDiscovery: typeof fetchAssetDiscovery;
+    buildTopSellerAccountsQuery: typeof buildTopSellerAccountsQuery;
+    buildTopCancellerAccountsQuery: typeof buildTopCancellerAccountsQuery;
+    buildTopFilledAccountsQuery: typeof buildTopFilledAccountsQuery;
+};
+export = _default;
+//# sourceMappingURL=kibana_bot_queries.d.ts.map

package/dist/analysis/bot_usage/kibana_bot_queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kibana_bot_queries.d.ts","sourceRoot":"","sources":["../../../analysis/bot_usage/kibana_bot_queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAoBH;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,eAAe,SAAO,EAAE,WAAW,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBlG;AAED;;;GAGG;AACH,iBAAS,mBAAmB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,eAAe,SAAO,EAAE,WAAW,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBhG;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,eAAe,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB9E;AAED;;;;GAIG;AACH,iBAAS,uBAAuB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DxD;AAID;;;;;;;;;GASG;AACH,iBAAS,oBAAoB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,WAAW,MAAO,EAAE,UAAU,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB5F;AAED;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,WAAW,MAAO,EAAE,UAAU,SAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB1F;AAED;;;GAGG;AACH,iBAAS,wBAAwB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BzD;AAID,iBAAe,gBAAgB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,EAAE,WAAW,MAAO,EAAE,eAAe,SAAO,gBAGhH;AAED,iBAAe,cAAc,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,EAAE,WAAW,MAAO,EAAE,eAAe,SAAO,gBAG9G;AAED,iBAAe,gBAAgB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,EAAE,eAAe,SAAO,gBAG5F;AAED,iBAAe,gBAAgB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,EAAE,WAAW,MAAO,EAAE,UAAU,SAAO,gBAG3G;AAED,iBAAe,eAAe,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,EAAE,WAAW,MAAO,EAAE,UAAU,SAAM,gBAGzG;AAED,iBAAe,kBAAkB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,gBAGtE;AAED,iBAAe,mBAAmB,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,MAAM,KAAK,gBAGvE;AAID;;;GAGG;AACH,iBAAS,2BAA2B,CAAC,aAAa,KAAA,EAAE,IAAI,SAAM,EAAE,UAAU,SAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB9E;AAED;;GAEG;AACH,iBAAS,8BAA8B,CAAC,aAAa,KAAA,EAAE,IAAI,SAAM,EAAE,UAAU,SAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBhF;AAED;;GAEG;AACH,iBAAS,2BAA2B,CAAC,aAAa,KAAA,EAAE,IAAI,SAAM,EAAE,QAAQ,SAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB3E;;;;;;;;;;;;;;;;;;;;;;;;;AAID,kBAkCE"}