Solana Memecoin Signals API & MCP Server

Pay per call — $0.02 (x402)

Agent Feed — pay-per-time passes (x402)

Autonomous agents pay a tiny amount of USDC on Solana for a time-limited pass, then read Pique Signal's live signal board. No account, no API key, no human login — the agent pays once for a pass, then sends it with each read, using the open x402 payment standard. The facilitator is the fee-payer, so your wallet pays no SOL gas.

Per-pass rate limit: 30 requests/minute. The pass secret is shown ONCE at purchase — store it. It is a bearer credential.

1. Get a pass

{
  "x402Version": 2,
  "error": "Payment required",
  "accepts": [{
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset":   "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",   // USDC (mainnet)
    "amount":  "500000",                                          // atomic USDC = $0.50 (day = 5000000)
    "payTo":   "E75637r67jVjdYuG6C6Taaf9Gtur4S98GkFmSWwazLC",    // the Pique Signal treasury (always pay the payTo shown in the live 402 bill)
    "maxTimeoutSeconds": 60,
    "extra": {
      "resource": "https://piquesignal.xyz/api/x402/pass?tenor=hour",
      "tenor": "hour",
      "description": "PiqueSignal x402 hour pass",
      "feePayer": "..."
    }
  }]
}

{
  "pass": "pqx_XXXXXXXX...",
  "tier": "agent",
  "tenor": "hour",
  "expires_in_seconds": 3600
}

2. Read the board

curl "https://piquesignal.xyz/api/x402/agent-feed?view=gated&limit=50"   -H "Authorization: Bearer pqx_XXXX..."

{
  "tier": "agent", "view": "gated", "count": 50, "as_of": "2026-08-11T...Z",
  "signals": [ { "mint": "...", "symbol": "...", "read_state": "...", "wm": "...", ... } ]
}

Early Edge

Live stream (SSE)

Views — pick one per request

Your pass & health

Errors

All responses are JSON { "error": "...", "detail": "..." }.

If you believe you paid but received no pass, retry /api/x402/pass with the SAME payment, or contact support with your Solana transaction signature — payments are reconciled against the treasury.

MCP Server — for Claude & AI agents

A conversational trading terminal over the live signal engine. Connect it to Claude Code (or any MCP client) and ask, in plain language, for the current board, a coin's price, or to run risk-managed paper trades against real market data. It exposes nine tools on the hosted connection (eight in the self-install build); the model calls them for you.

Connect

Option A — Hosted (easiest). Best for pulling signals and prices; paper trades here reset each session. No install.

claude mcp add --transport http piquesignal https://piquesignal.xyz/mcp

Then run /mcp inside Claude Code and sign in (OAuth) by pasting your paid API key ($49 Gated or $99 Builder) from your account page.

Option B — Self-install. This is the path that paper-trades locally — the paper engine and your positions live on your own machine. Download the MCP from your account page (available to members) and unzip it, then open a terminal in that folder and run:

npm install
claude mcp add piquesignal -- node /path/to/piquesignal-mcp/src/index.js

Then set PIQUESIGNAL_API_KEY to the paid API key ($49 Gated or $99 Builder) from your account page.

Tools

Paper trading

Paper trading works on both connections and uses real-time DexScreener prices (in SOL) — it is a dry run, not a backtest. Hosted: paper trades are kept in memory for that session only; positions and balance reset when the session ends (after about an hour with no activity, or after 24 hours at most) or our server restarts. Self-install: positions are saved on your own disk at ~/.piquesignal/paper-state.json. The engine is risk-managed: position size uses the optional score you pass (0-100, your own confidence — PiqueSignal does not give a score; with none passed, it buys half size), there is a total-exposure cap, and duplicate-token buys are blocked. Each buy is capped at 0.5 SOL (amount_sol above 0.5 is cut to 0.5), with 5 SOL total exposure and a 10 SOL starting balance. The $10,000 liquidity floor applies only when you pass liquidity_usd. Stop-loss (−15%) and take-profit (+50%) are checked each time you call get_positions, not watched all the time. Simulated slippage is 0.1–0.5% with no fees, so real fills on thin memecoins can be worse.

Paper trades on the hosted connection reset each session; use the self-install build to keep them.

Using Grok?

Grok has its own one-tap, free connector — sign in with X, no account or key. See the Grok section below for the setup steps.

Grok connector — free, for X users

Connect Pique Signal straight into Grok and ask for the live Solana board in plain language — “what's moving” or “show me the board”. It's a separate, read-only connector built for Grok, and it's free — no account, no API key, no payment. You just sign in with your X account.

What you get (free)

No credit card, no crypto, no subscription. The blue-check trial is one per X account; after it ends you stay on the free board.

Set it up (about a minute)

1. In Grok, open your custom connector settings (“add your own connector”).
2. Add a connector with this URL:

   https://grok.piquesignal.xyz/mcp

3. Sign in with X when Grok asks (one tap — it just confirms your X account).
4. Done. Ask Grok “show me the PiqueSignal board” or “what's moving.”

Just got X Premium? Reconnect the connector once so it picks up your blue-check trial.

What you can ask

These are signals, not financial advice. Memecoins are high-risk — you decide.

Builder API — REST for developers

A key-authed pull API for building your own tools on top of the signal engine: the live board, settled backtest history, a live push stream, and signed webhooks. Send your account key as Authorization: Bearer <key> (the key is on your account page). /api/pull/feed, /api/pull/me and /api/pull/early-edge work with any paid key ($49 Gated or $99 Builder); /api/pull/builder, the backtest endpoints, the Builder stream and webhooks need a $99 Builder key:

Authorization: Bearer <builder key>

Endpoints

Example

curl "https://piquesignal.xyz/api/pull/builder?view=gated&limit=50"   -H "Authorization: Bearer <builder key>"

Webhooks

Register an HTTPS URL and every new signal is POSTed to you as it fires — no polling. Each delivery is HMAC-SHA256 signed: the header X-Pique-Signature is the HMAC of the raw request body computed with your webhook secret. Recompute it on your side and compare before you trust a payload. The secret is shown once at registration — store it then. Deliveries carry only sanitized signal fields.

Limits & errors

Auth errors: 401 missing_api_key; 403 key_revoked / builder_required / builder_expired (your Builder plan lapsed — renew) / quota_required. Transient issues return 503 — retry with backoff.

FAQ

What is the PiqueSignal MCP server?

An MCP (Model Context Protocol) server that connects Claude or any AI agent to PiqueSignal's live Solana memecoin signals. Ask in plain language for the current board, a token's price, or run risk-managed paper trades against real market data. It exposes nine tools on the hosted connection (eight in the self-install build); the model calls them for you.

How do I add the PiqueSignal MCP server to Claude Desktop or Claude Code?

Run: claude mcp add --transport http piquesignal https://piquesignal.xyz/mcp — then run /mcp inside Claude Code and sign in. That is the hosted option (no install). A self-install build, which paper-trades locally, is on your account page.

Can an AI agent get Solana memecoin signals without an account?

Yes. An agent can pay $0.02 in USDC for one read of the live board, or buy a pass ($0.50 for one hour, $5 for one day). No account, no API key, no human login.

What is x402 pay-per-call?

x402 is an open payment standard. The agent requests the feed, receives a 402 challenge, pays a fixed USDC amount on Solana, and reads the board in one flow — no subscription. The facilitator pays gas, so your wallet pays no SOL.

Does PiqueSignal have a REST API and webhooks?

Yes. The Builder API is a key-authed REST feed with the live board, settled backtest history, an SSE live stream, and HMAC-signed webhooks — register an HTTPS URL and every new signal is pushed to you as it fires.

What do the signals include?

Symbol, mint, entry and current market cap, holders and growth, liquidity, 5m/1h/24h volume, top-10 holder %, bundle and sniper flags, dex-paid, a fake-volume warning, and socials. Gated views add the Clear-Eyes read. On the board feeds (x402, /api/pull/feed, MCP and the Grok trial) they also add a real-holder check (when known) and a clean tag (when present).

Does it filter for rugs and unsafe tokens?

Yes. We run rug and safety checks before we call a coin. Risky coins are filtered out or carry a warning tag (for example a fake-volume warning). No check catches every rug.