dexbot 1.4.17 → 1.4.19

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

@@ -0,0 +1,531 @@
+/**
+ * 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
+ */
+import { kibanaSearch } from '../../market_adapter/core/kibana_client.js';
+declare const OP_LIMIT_ORDER_CREATE = 1;
+declare const OP_LIMIT_ORDER_CANCEL = 2;
+declare const OP_FILL_ORDER = 4;
+declare const DEFAULT_CONFIG: {
+    timeout: number;
+    kibanaUrl: "https://kibana.bitshares.dev";
+    apiKey: null;
+};
+/**
+ * Time-bucketed count of limit_order_create ops for an account.
+ * Optionally filtered to orders selling a specific asset.
+ */
+declare function buildOrderCreateQuery(accountId: string, lookbackHours: number, intervalSeconds?: number, sellAssetId?: string | null): {
+    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': string;
+                    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: string;
+                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: string, lookbackHours: number, intervalSeconds?: number, paysAssetId?: string | null): {
+    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': string;
+                    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: string;
+                min_doc_count: number;
+            };
+        };
+        total: {
+            value_count: {
+                field: string;
+            };
+        };
+    };
+};
+/**
+ * Time-bucketed count of limit_order_cancel ops for an account.
+ */
+declare function buildOrderCancelQuery(accountId: string, lookbackHours: number, 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': string;
+                    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: string;
+                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: string, lookbackHours: number): {
+    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': string;
+                            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': string;
+                            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': string;
+                            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: string, lookbackHours: number, sellAssetId?: string | null, 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': string;
+                    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: string, lookbackHours: number, paysAssetId?: string | null, 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': string;
+                    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: string, lookbackHours: number): {
+    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': string;
+                    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: string, lookbackHours: number, config?: any, sellAssetId?: string | null, intervalSeconds?: number): Promise<unknown>;
+declare function fetchFillOrder(accountId: string, lookbackHours: number, config?: any, paysAssetId?: string | null, intervalSeconds?: number): Promise<unknown>;
+declare function fetchOrderCancel(accountId: string, lookbackHours: number, config?: any, intervalSeconds?: number): Promise<unknown>;
+declare function fetchOrderPrices(accountId: string, lookbackHours: number, config?: any, sellAssetId?: string | null, maxResults?: number): Promise<unknown>;
+declare function fetchFillPrices(accountId: string, lookbackHours: number, config?: any, paysAssetId?: string | null, maxResults?: number): Promise<unknown>;
+declare function fetchDailyActivity(accountId: string, lookbackHours: number, config?: any): Promise<unknown>;
+declare function fetchAssetDiscovery(accountId: string, lookbackHours: number, config?: any): Promise<unknown>;
+/**
+ * Top N accounts by limit_order_create count (seller field).
+ * Use this to discover the most active order-placing accounts.
+ */
+declare function buildTopSellerAccountsQuery(lookbackHours: number, 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: number, 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: number, 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;
+                };
+            };
+        };
+    };
+};
+export { OP_LIMIT_ORDER_CREATE, OP_LIMIT_ORDER_CANCEL, OP_FILL_ORDER, DEFAULT_CONFIG, kibanaSearch, buildOrderCreateQuery, buildFillOrderQuery, buildOrderCancelQuery, buildDailyActivityQuery, buildAssetDiscoveryQuery, buildOrderPriceQuery, buildFillPriceQuery, fetchOrderCreate, fetchFillOrder, fetchOrderCancel, fetchOrderPrices, fetchFillPrices, fetchDailyActivity, fetchAssetDiscovery, buildTopSellerAccountsQuery, buildTopCancellerAccountsQuery, buildTopFilledAccountsQuery };
+//# 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":"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"}