⚡ xsignal

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.

The tools (flagship first)

| 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). |

Try it free (3 calls per wallet)

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.

curl "https://xsignal-production.up.railway.app/intent?addr=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&min_confidence=0.5&wallet=0xYourAddr"

Then run the example — a watchlist alerter that surfaces only the tokens confidently moving (and stays quiet on the rest):

WALLET=0xYourAddr node examples/watchlist-alerter.js

Pay with x402 (beyond the free probe)

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.

Safety

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.

Config (env)

| 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. |

Run

npm start      # :4520
npm test       # full self-test suite (signal · tokenintel · brief · intent · x402 · sources · server)

Zero runtime deps for the core (plain Node >=18); @coinbase/x402 is used only for CDP-facilitator auth on mainnet.