@keich2realg/plugin-sentinel402

ElizaOS plugin that gives any agent Smart Money Concepts market reads — market structure (BOS/CHoCH), fair value gaps, liquidity pools & sweeps, ICT sessions/kill zones — by calling the Sentinel402 x402 API. Pay-per-call in USDC on Base (gasless, via x402). No subscription, no API key.

Install

npm install @keich2realg/plugin-sentinel402

Configure

The agent pays per call from its own wallet. Set these in your character secrets / env:

| Setting | Required | Description | |---|---|---| | SENTINEL402_WALLET_KEY | ✅ | Private key of the agent wallet that pays per call. Must hold USDC on Base. Keep secret. | | SENTINEL402_URL | – | Service base URL (default https://sentinel402.onrender.com). | | SENTINEL402_RPC_URL | – | Base RPC (default https://mainnet.base.org). |

import { sentinel402Plugin } from "@keich2realg/plugin-sentinel402";

export const character = {
  name: "TraderAgent",
  plugins: [sentinel402Plugin],
  settings: {
    secrets: { SENTINEL402_WALLET_KEY: process.env.SENTINEL402_WALLET_KEY },
  },
};

Use

The agent exposes the GET_SMC_SIGNAL action. It triggers on requests like:

• "What's the SMC structure on BTCUSDT 15m?"
• "Check liquidity and FVGs for ETH on the 1h"
• "solana 4h order flow"

Returns a concise summary plus the full structured snapshot in result.data.snapshot.

Direct use (no agent)

import { fetchSmcSignal } from "@keich2realg/plugin-sentinel402";

const r = await fetchSmcSignal(
  "https://sentinel402.onrender.com",
  process.env.WALLET_KEY!,
  { symbol: "BTCUSDT", timeframe: "15m" },
);
console.log(r.snapshot.structure.bias, r.snapshot.fvg.length);

Notes

• Payment is handled transparently by x402: the first call gets a 402, the plugin signs an EIP-3009 USDC authorization, and retries. The facilitator submits the transfer — the agent pays no gas.
• Not financial advice. SMC structure is an analytical input, not a signal to trade.

MIT