piquesignal-solana-agent-plugin

Pique Signal plugin for Solana Agent Kit — live scored memecoin signals, safety profiles, and AI reports for autonomous agents on Solana.

Gives any SAK-powered agent access to live memecoin signals, on-chain safety data, AI reports, and performance metrics from Pique Signal.

Installation

npm install piquesignal-solana-agent-plugin solana-agent-kit

Setup

Set your API key as an environment variable:

export PIQUESIGNAL_API_KEY=YOUR_API_KEY

Get a key:

• Telegram: Send /apikey to @piquesignalbot. 72-hour free trial, no card required.
• Agent subscribe: Autonomous agents can subscribe and get a key with no login via POST /api/subscribe. Send SOL or USDC, poll for confirmation, receive your key. See API docs.
• x402 pay-per-call: No subscription needed. Pay per request with USDC on Solana via the x402 protocol.

Usage

With Solana Agent Kit

import { SolanaAgentKit, KeypairWallet } from "solana-agent-kit";
import PiqueSignalPlugin from "piquesignal-solana-agent-plugin";

const wallet = new KeypairWallet(keypair, RPC_URL);
const agent = new SolanaAgentKit(wallet, RPC_URL, {})
  .use(PiqueSignalPlugin);

// Access via methods
const signals = await agent.methods.getSignals({ limit: 10, min_score: 70 });
const safety = await agent.methods.getTokenSafety("mint_address_here");
const report = await agent.methods.getSignalReport("mint_address_here");
const stats = await agent.methods.getTrackRecord(30);
const health = await agent.methods.getHealth();

With AI Frameworks

import { createVercelAITools } from "solana-agent-kit";

const tools = createVercelAITools(agent, agent.actions);
// All 5 Pique Signal actions are now available as AI tools

Works with createLangchainTools and createOpenAITools the same way.

Actions

| Action | Description | |--------|-------------| | PIQUESIGNAL_GET_SIGNALS | Get live scored Solana memecoin signals with safety data, market metrics, and conviction scoring | | PIQUESIGNAL_GET_TOKEN_SAFETY | Check safety profile for a token: mint/freeze authority, LP lock, holder concentration, sniper exposure | | PIQUESIGNAL_GET_SIGNAL_REPORT | Get AI-generated analysis report for a specific token | | PIQUESIGNAL_GET_TRACK_RECORD | Get aggregate performance metrics including hit rates and multiplier statistics | | PIQUESIGNAL_GET_HEALTH | Check Pique Signal engine status |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PIQUESIGNAL_API_KEY | Yes | Your Pique Signal API key | | PIQUESIGNAL_API_URL | No | Custom API base URL (defaults to https://piquesignal.xyz) |

Testing

PIQUESIGNAL_API_KEY=YOUR_API_KEY npm test

Links

• piquesignal.xyz
• piquesignal.xyz/api-docs
• github.com/piquesignal/piquesignal-mcp

License

MIT