@seekdaseek/plugin-agentfeed 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -18,6 +18,8 @@ declare class AgentFeedService extends Service {
     private payerAddress;
     /** path -> { usd, checkedAt } of last approved quote */
     private approvedQuotes;
+    /** requirements that survived the spend policy on the most recent payment */
+    private lastSurvivingReqs;
     /** lifetime spend counter for this process (informational) */
     private totalSpentUsd;
     constructor(runtime: IAgentRuntime);

package/dist/index.js

@@ -6,7 +6,7 @@ import { ExactSvmScheme } from "@x402/svm/exact/client";
 import { wrapFetchWithPaymentFromConfig, decodePaymentResponseHeader } from "@x402/fetch";
 import bs58 from "bs58";
 var DEFAULT_BASE_URL = "https://x402.ochinimus.app";
-var DEFAULT_MAX_SPEND_USD = 0.02;
+var DEFAULT_MAX_SPEND_USD = 0.05;
 var QUOTE_TTL_MS = 10 * 60 * 1e3;
 var USDC_DECIMALS = 6;
 var AgentFeedService = class _AgentFeedService extends Service {
@@ -23,6 +23,8 @@ var AgentFeedService = class _AgentFeedService extends Service {
   payerAddress = "";
   /** path -> { usd, checkedAt } of last approved quote */
   approvedQuotes = /* @__PURE__ */ new Map();
+  /** requirements that survived the spend policy on the most recent payment */
+  lastSurvivingReqs = [];
   /** lifetime spend counter for this process (informational) */
   totalSpentUsd = 0;
   static async start(runtime) {
@@ -51,10 +53,14 @@ var AgentFeedService = class _AgentFeedService extends Service {
     this.payerAddress = keypair.address;
     const signer = toClientSvmSigner(keypair);
     const capBaseUnits = Math.round(this.maxSpendUsd * 10 ** USDC_DECIMALS);
-    const maxSpendPolicy = (_v, reqs) => reqs.filter((r) => {
-      const raw = Number(r?.maxAmountRequired ?? r?.amount ?? r?.maxAmount);
-      return Number.isFinite(raw) && raw > 0 && raw <= capBaseUnits;
-    });
+    const maxSpendPolicy = (_v, reqs) => {
+      const surviving = reqs.filter((r) => {
+        const raw = Number(r?.maxAmountRequired ?? r?.amount ?? r?.maxAmount);
+        return Number.isFinite(raw) && raw > 0 && raw <= capBaseUnits;
+      });
+      this.lastSurvivingReqs = surviving;
+      return surviving;
+    };
     this.payFetch = wrapFetchWithPaymentFromConfig(fetch, {
       schemes: [{ network: "solana:*", client: new ExactSvmScheme(signer) }],
       policies: [maxSpendPolicy]
@@ -132,8 +138,19 @@ var AgentFeedService = class _AgentFeedService extends Service {
       if (!res.ok) {
         return { ok: false, status: res.status, data, error: `AgentFeed HTTP ${res.status}` };
       }
-      if (settlement) this.totalSpentUsd += quotedUsd;
-      return { ok: true, status: res.status, data, paidUsd: settlement ? quotedUsd : 0, settlement };
+      let paidUsd = 0;
+      if (settlement) {
+        const s = settlement;
+        let raw = Number(s?.amount ?? s?.paidAmount);
+        if (!Number.isFinite(raw) || raw <= 0) {
+          const net = String(s?.network ?? "");
+          const req = this.lastSurvivingReqs.find((r) => String(r?.network ?? "") === net) ?? this.lastSurvivingReqs[0];
+          raw = Number(req?.maxAmountRequired ?? req?.amount ?? req?.maxAmount);
+        }
+        paidUsd = Number.isFinite(raw) && raw > 0 ? raw / 10 ** USDC_DECIMALS : quotedUsd;
+        this.totalSpentUsd += paidUsd;
+      }
+      return { ok: true, status: res.status, data, paidUsd, settlement };
     } catch (e) {
       return { ok: false, status: 0, data: null, error: e?.message || String(e) };
     }
@@ -157,6 +174,43 @@ function parseKey(raw) {
 
 // src/endpoints.ts
 var ENDPOINTS = [
+  {
+    path: "/api/cascade-scan",
+    usd: 0.05,
+    action: "AGENTFEED_GET_CASCADE_SCAN",
+    similes: ["CASCADE_SCAN", "FULL_CASCADE_SCAN", "SCAN_ALL_LIQUIDATIONS", "WHAT_IS_CASCADING"],
+    description: "Scan for liquidation cascades across the FULL universe of ~600 USDT perps on Bybit, OKX and Binance simultaneously ($0.05) \u2014 not just the majors. Returns each active cascade: symbol, side liquidated, USD total, print count, duration, severity (minor/major/extreme). Bybit is the only complete unthrottled liquidation tape in crypto and no exchange publishes history of it, so this coverage is not available anywhere else. Use when the agent needs to know what is blowing up across the whole market, including alts it is not already watching.",
+    triggers: [
+      "is anything cascading right now",
+      "scan the whole market for liquidation cascades",
+      "what alts are getting liquidated hard",
+      "any cascades outside the majors"
+    ]
+  },
+  {
+    path: "/api/liquidation-leaders",
+    usd: 0.02,
+    action: "AGENTFEED_GET_LIQUIDATION_LEADERS",
+    similes: ["LIQUIDATION_LEADERS", "WHATS_GETTING_REKT", "TOP_LIQUIDATIONS"],
+    description: "Rank the top symbols by liquidation USD right now across ~600 USDT perps on Bybit, OKX and Binance ($0.02). Per symbol: total liquidated, long vs short split, biggest single print, venue count, dominant side. The fastest read on where leverage is being flushed.",
+    triggers: [
+      "what is getting rekt right now",
+      "which coins have the most liquidations today",
+      "where is leverage being flushed"
+    ]
+  },
+  {
+    path: "/api/cascade",
+    usd: 0.01,
+    action: "AGENTFEED_GET_CASCADE_ALERT",
+    similes: ["CASCADE_ALERT", "IS_THERE_A_CASCADE"],
+    description: "Liquidation cascade detector for the 5 majors \u2014 SOL, BTC, ETH, XRP, DOGE \u2014 across Bybit, OKX and Binance ($0.01). Returns cascades active NOW: clustered same-side liquidations with symbol, side, USD total, prints, duration, severity. Empty array = no cascade in the window. For all ~600 perps use AGENTFEED_GET_CASCADE_SCAN instead.",
+    triggers: [
+      "is SOL cascading",
+      "is there a liquidation cascade on BTC right now",
+      "check for a cascade before I enter"
+    ]
+  },
   {
     path: "/api/trade-context",
     usd: 0.01,
@@ -175,7 +229,7 @@ var ENDPOINTS = [
     usd: 3e-3,
     action: "AGENTFEED_GET_LIQUIDATIONS",
     similes: ["GET_RECENT_LIQUIDATIONS", "RECENT_LIQUIDATIONS", "LIQUIDATION_FEED"],
-    description: "Fetch recent SOL/BTC perp liquidation prints ($0.003): side, size, price, exchange, timestamp. Use for questions about recent liquidations, cascades, or big liquidation prints.",
+    description: "Fetch recent perp liquidation prints ($0.003) across ~600 USDT perps on Bybit (complete unthrottled tape), OKX and Binance: side, size, price, exchange, timestamp. Filterable by symbol \u2014 any USDT perp, not just majors. Use for questions about recent liquidations or big prints.",
     triggers: [
       "any big liquidations in the last hour",
       "show me recent SOL liquidations",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seekdaseek/plugin-agentfeed",
-  "version": "0.1.1",
-  "description": "elizaOS plugin for AgentFeed — paid crypto market data (liquidations, positioning, funding, token risk) over x402 micropayments on Solana. $0.001–$0.01 per call in USDC, no API keys, no subscriptions.",
+  "version": "0.2.0",
+  "description": "elizaOS plugin for AgentFeed — paid crypto liquidation data over x402 micropayments on Solana. Full-universe cascade detection across ~600 USDT perps on Bybit, OKX and Binance, plus positioning, funding, prices and token risk. $0.001–$0.05 per call in USDC, no API keys, no subscriptions.",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -65,7 +65,7 @@
       },
       "AGENTFEED_MAX_SPEND_PER_CALL": {
         "type": "string",
-        "description": "Safety cap in USD per single API call. Any 402 quote above this is refused. Default: 0.02"
+        "description": "Safety cap in USD per single API call. Any 402 quote above this is refused. Default: 0.05 (the price of the most expensive tool, get_cascade_scan). Lower it to restrict spend; raise it only if AgentFeed adds a pricier tool."
       }
     }
   }