@gdietsch/solana-agent-kit-plugin-trading-signals
v0.1.0
Published
Solana Agent Kit v2 plugin: Solana/Base token risk verdict ($0.01), GO/CAUTION/STOP pre-trade pack ($0.015) and whale flow ($0.02), paid per call over x402 in USDC from the agent's own Solana wallet.
Maintainers
Readme
@gdietsch/solana-agent-kit-plugin-trading-signals
A Solana Agent Kit v2 plugin that gives your agent pre-trade due diligence on Solana (and Base) tokens from the Trading Signals Toolkit. Each call is paid per request over x402 in USDC from the agent's own Solana wallet: no API key, no account, no subscription.
| Action | Method | Price | What it returns |
| --- | --- | --- | --- |
| TOKEN_RISK_VERDICT | tokenRiskVerdict | 0.01 USDC | safe / caution / avoid with an A-F grade and reasons: mint and freeze authority, honeypot or sell test, LP lock, top-holder concentration, sniper and bundled wallets |
| TOKEN_PRE_TRADE_PACK | tokenPreTradePack | 0.015 USDC | One GO / CAUTION / STOP decision: token verdict + OFAC sanctions screen of the token's authorities and an optional counterparty wallet + that wallet's USDC pay-readiness |
| TOKEN_WHALE_FLOW | tokenWhaleFlow | 0.02 USDC | Whale buys vs sells over 1-24h, net flow and % of liquidity, accumulation / distribution signal, largest trades, top wallets |
Installation
npm install solana-agent-kit @gdietsch/solana-agent-kit-plugin-trading-signalsIntegration
import { SolanaAgentKit, KeypairWallet, createLangchainTools } from "solana-agent-kit";
import TradingSignalsPlugin from "@gdietsch/solana-agent-kit-plugin-trading-signals";
const agent = new SolanaAgentKit(wallet, process.env.RPC_URL!, {}).use(TradingSignalsPlugin);
// As LLM tools (LangChain, Vercel AI SDK, OpenAI Agents, MCP adapter): the three actions are registered automatically.
const tools = createLangchainTools(agent, agent.actions);
// Or call directly:
const verdict = await agent.methods.tokenRiskVerdict(agent, "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263");
const pack = await agent.methods.tokenPreTradePack(agent, "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", { wallet: "<counterparty>", amount: 5 });
const whales = await agent.methods.tokenWhaleFlow(agent, "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", { hours: 6 });Each method resolves to { ok, data, via, payment } (payment.transaction / payment.explorer link the USDC settlement on Solscan). Each action returns { status, summary, paidWith, payment, response }.
Payment and limits
- The agent's wallet needs a little USDC on Solana mainnet. The x402 facilitator pays the network fee, so no SOL is spent on payments.
- Works with any Solana Agent Kit wallet that can sign a transaction (
KeypairWallet, Privy, Turnkey, Crossmint, browser wallets). The plugin asks for version-0 transactions so web3.js v1 wallets can sign them, and uses the agent's RPC endpoint. - Payments are restricted to USDC on Solana mainnet and capped: 0.05 USDC per call and 1.00 USDC per UTC day by default.
- Optional: a free API key (100 calls / month, from https://signals.incomefather.com/pricing) skips the wallet payment; when its quota runs out, the plugin falls back to x402.
import { createTradingSignalsPlugin } from "@gdietsch/solana-agent-kit-plugin-trading-signals";
agent.use(createTradingSignalsPlugin({ maxUsdPerCall: 0.02, maxUsdPerDay: 0.5 /*, apiKey: "..." */ }));Settings can also come from the agent config or environment: TRADING_SIGNALS_MAX_USD_PER_CALL, TRADING_SIGNALS_MAX_USD_PER_DAY, TRADING_SIGNALS_API_KEY, TRADING_SIGNALS_BASE_URL, TRADING_SIGNALS_TIMEOUT_MS.
Notes
Results are heuristic risk signals and market data, not financial or legal advice. API reference: https://signals.incomefather.com/openapi.json
MIT License
