The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Xsignal listing page.
Pay-per-call data ingredients for AI agents on Base, via x402 (USDC). The flagship is the one thing no other x402
signal does: get_intent abstains — it returns "no verdict" (and says so) when it isn't confident enough, instead
of always answering and always charging. 3 free calls per wallet to try, then from $0.01. Verify-only: never
signs or moves funds.
| Tool / route | Price | What you get |
|---|---|---|
get_preflight · GET /preflight?addr=0x… | $0.05 | The composed Base preflight: fuses on-chain safety (SAFE/WATCH/AVOID + rug flags, via MainStreet) with momentum into one verdict — GO / CAUTION / AVOID. Safety gates momentum, so it never green-lights a token that can rug. |
get_intent · GET /intent?addr=0x…&min_confidence=0.7 | $0.01 | An outcome-priced momentum verdict (gaining/fading) only if confidence clears your bar, else a calibrated abstain. Paid answers carry a keyless tamper-evidence receipt. |
get_token_brief · GET /brief?addr=0x… | $0.05 | A meal: fuses market intel + cited social signal into a "what is happening with $TOKEN now" brief. |
get_signal · GET /signal?q=<topic> | $0.01 | A scored (virality + freshness) and cited real-time X/social signal. |
get_token_intel · GET /token?addr=0x… | $0.01 | Base token market data (liquidity/volume/price/age/flow + flags). Best as an input to the brief. |
POST /mcp | — | MCP (streamable-http): tools/list discovers the 5 tools; a tools/call returns an x402 payment pointer. |
GET /health · /.well-known/mcp.json · /.well-known/agent-card.json · /skill.md | free | health + agent discovery + the installable skill (no data). |
Add ?wallet=0xYourAddress to any route for 3 free full results, so you can evaluate quality before paying. After 3,
that wallet pays via x402.
Then run the example — a watchlist alerter that surfaces only the tokens confidently moving (and stays quiet on the rest):
The first post-probe request returns HTTP 402 with an accepts array (price in USDC, network base, payTo). Pay
with x402-fetch/x402-axios and a funded Base wallet, resubmit with the X-PAYMENT header, get the result. /intent
is pay-first: you pay, then get a verdict or an honest abstain.
We never sign or move funds. x402 means we receive USDC to payTo; payment is verify-only via a facilitator.
Signals are scored from public X posts + public DEX data — verify before acting; not financial advice. Confidence is a
mechanical heuristic, not a calibrated probability or a prediction.
| Var | Purpose |
|---|---|
XSIGNAL_PAYTO | address that receives USDC (public; no key). Default = the operator address. |
XSIGNAL_PRICE_USD / XSIGNAL_BRIEF_PRICE_USD / XSIGNAL_INTENT_PRICE_USD | per-call prices (default 0.01 / 0.05 / 0.01) |
XSIGNAL_PROBE_FREE | free probe calls per wallet (default 3) |
X402_NETWORK / FACILITATOR_URL | base (mainnet CDP, needs CDP_API_KEY_ID/CDP_API_KEY_SECRET) or base-sepolia (keyless x402.org) |
X_BEARER_TOKEN or XAI_API_KEY | live X/Grok source for get_signal (token intel + intent are keyless via DexScreener). No key → a labelled DEMO seed. |
Zero runtime deps for the core (plain Node >=18); @coinbase/x402 is used only for CDP-facilitator auth on mainnet.