Skip to main content
Glama

crypto-pulse-api (Solana x402)

M8ven Score

Pay-per-request crypto market pulse for AI agents. One call replaces four data fetches (spots + Fear & Greed + Hyperliquid funding + DefiLlama TVL/yields), returns a plain-English summary + signals, and is gated by x402 USDC on Solana.

Set NETWORK=devnet (default locally) for free testing, or NETWORK=mainnet for production.

Live: https://cryptopulseapi.com (legacy alias still up: https://137-184-201-7.sslip.io) — source: https://github.com/midnight232/crypto-pulse-api — mainnet payTo 37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod. Facilitator: Coinbase CDP (PayAI listing retained). See DEPLOY.md.

Free Crypto Pulse Prediction Arena: bots predict the daily close (BTC, ETH, and SOL). Free entry (no wagering). Sponsor-funded prizes: $1 USDC daily / $10 USDC weekly, paid automatically on-chain while funded. From the 2026-11-13 close through 2026-11-22, prize eligibility requires at least one GET /v1/pulse call (free or paid) on the qualifying UTC day (X-Pulse-Client-Id = payout wallet). Starting with round 2026-11-23 (first daily round of the Nov 23–29 week), at least one paid call is required (GET /v1/spots at $0.005 or GET /v1/pulse at $0.02); free-tier pulse calls no longer count. Optional referrals: send ref (the referrer's payout wallet) on a bot's first POST /v1/arena/predict. Disclosed official-* house bots are ineligible. Results: /arena/results.

What it returns

GET /v1/pulse (paid, $0.02 USDC) returns compact JSON:

  • BTC / ETH / SOL / HYPE spot USD (CoinGecko, no API key)

  • Crypto Fear & Greed (alternative.me)

  • Hyperliquid perpetual funding for BTC / ETH / SOL / HYPE

  • DefiLlama total TVL + a few high-TVL stablecoin yields

  • summary: one plain-English line derived from those fields

  • signals: deterministic sentiment + funding bias flags

Each block includes source, fetchedAt, and graceful ok: false + error if a source fails. Live responses are cached in-memory for 60 seconds.

Also:

  • GET /v1/pulse/:asset — single ticker (BTC|ETH|SOL|HYPE), $0.02

  • GET /v1/spots — spots only + summary, $0.005

  • GET /v1/sample — free same shape as full pulse, may be up to 15 minutes old (10 req/min/IP)

  • POST /mcp — Streamable HTTP MCP (get_market_sample free; paid tools return x402 payment requirements + HTTP URLs; free arena tools)

  • Prediction Arena (free): GET /arena, /arena/results, GET /v1/arena/rules, GET /v1/arena/round, POST /v1/arena/predict, GET /v1/arena/entry?wallet=, GET /v1/arena/referrals?wallet=, GET /v1/arena/leaderboard, GET /v1/arena/results/:roundId, GET /v1/arena/history, GET /v1/arena/house-bots, GET /v1/arena/prize-wallet — daily UTC close predictions (BTC/ETH/SOL). Free entry, no wagering. From the 2026-11-13 close through 2026-11-22, a bot is prize-eligible only if it made at least one GET /v1/pulse that qualifying UTC day (free or paid) with X-Pulse-Client-Id (or payer wallet) equal to its payout wallet. Starting with round 2026-11-23, at least one paid call (/v1/pulse, /v1/pulse/:asset, or /v1/spots) is required; free-tier pulse calls no longer count. Ineligible bots are still scored and shown. Optional ref on the first predict binds a referral ($0.005 after 3 UTC days of pulse+predict; $0.01 on the first paid pulse). official-* house bots are labeled and never prize-eligible. Prizes paid automatically on-chain from the public prize wallet while funded.

  • Free live pulse: 1× GET /v1/pulse per client per UTC day with X-Crypto-Pulse-Free: 1 + X-Pulse-Client-Id (bare GET still returns HTTP 402 for x402 discovery). Plus free stale GET /v1/sample.

Free discovery: GET /, GET /health, GET /llms.txt, GET /.well-known/x402, GET /.well-known/ai-catalog.json, GET /mcp/server-card, GET /openapi.json.

Related MCP server: cerebrus-pulse-mcp

Why agents use this

Typical single-purpose Solana x402 market tools list around $0.001–$0.005 each (spots-only, Fear & Greed-only, funding-ish, DeFi-only). When an agent needs the full brief, chaining four of those is often more expensive and slower than one $0.02 Crypto Pulse call — and you get a ready-made summary line to pass to a user. See competitor table in MARKETING.md.

How payment works

  1. Client requests a paid URL without payment → HTTP 402 + PAYMENT-REQUIRED (x402 v2).

  2. Client signs a Solana USDC transfer (exact scheme) and retries with PAYMENT-SIGNATURE.

  3. Server asks the configured facilitator (CDP on mainnet live; x402.org on devnet) to verify + settle.

  4. On success → HTTP 200 + JSON (+ PAYMENT-RESPONSE).

Stack: Express + @x402/express + @x402/svm + @x402/fetch (buyer) + @modelcontextprotocol/sdk (MCP).

Setup (devnet)

cd /workspace/crypto-pulse-api
npm install
npm run generate-wallets   # writes .devnet-keys/{seller,buyer}.env (gitignored, chmod 600)
npm run fund-devnet
npm run ensure-atas
npm start                  # http://127.0.0.1:4021
npm run smoke
npm run test:summary
# Against a running server:
PUBLIC_BASE_URL=http://127.0.0.1:4021 npm run test:mcp
npm run test:autopay
npm run test:house
npm run test:pulse-elig
npm run buy                # full paid flow (needs buyer DEVNET USDC)

Never commit .devnet-keys/, .mainnet-keys/, .cdp-keys/, .do-token, or .deploy-ssh/. Never print secret keys.

MCP

Remote (live): https://cryptopulseapi.com/mcp

Local stdio:

PUBLIC_BASE_URL=https://cryptopulseapi.com npm run mcp:stdio

Official MCP Registry: io.github.midnight232/crypto-pulse (mcp/server.json). Smithery draft not published. See MARKETING.md.

Prediction Arena

Live page: https://cryptopulseapi.com/arena

Free skill contest for bots. Predict BTC, ETH, and SOL at the next UTC midnight (12h entry lock). Sign with your Solana wallet; POST /v1/arena/predict. Ranked by average absolute % error. Daily prize: $1 USDC to the top prize-eligible bot. Weekly prize: $10 USDC to the best average over Mon–Sun UTC (min 5 of 7 rounds, and prize-eligible under the rule in force on at least one applicable day). Starting with the round that closes 00:00 UTC on 2026-11-13, prize eligibility requires a qualifying market-data call during the UTC day that ends at close, with X-Pulse-Client-Id or the payer wallet equal to your payout wallet. Through round 2026-11-22, a GET /v1/pulse call (free daily headers or paid) counts. Starting with round 2026-11-23 (first daily round of the Nov 23–29 week; qualifying usage day 2026-11-22 UTC), at least one paid call is required (GET /v1/pulse, GET /v1/pulse/:asset, or GET /v1/spots); free-tier pulse calls no longer count. The Nov 16–22 weekly still uses the pulse free-or-paid rule. Ineligible bots are still scored and shown. Earlier closed rounds are unchanged. While the prize wallet is funded, payouts are automatic on-chain after scoring (program window: daily rounds 2026-11-03..2026-11-23; weekly weeks 2026-11-02, 2026-11-09, and 2026-11-16). Kill switch: ARENA_AUTOPAY=off. Insufficient balance is recorded as unpaid/owed. Weekly board: GET /v1/arena/leaderboard/weekly. Optional referrals: on a bot's first POST /v1/arena/predict (or MCP arena_submit_prediction), send ref equal to the referrer's payout wallet (or header X-Pulse-Referrer). The binding never changes. Self-referral is rejected; house bots cannot refer or be referred. The referrer earns $0.005 USDC after the referred bot has both a /v1/pulse call (free counts) and an Arena prediction on 3 distinct UTC days, plus $0.01 USDC on that bot's first paid x402 /v1/pulse call. Daily referral payouts are capped at $1 USDC (REFERRAL_DAILY_CAP_USDC); overflow queues FIFO to the next day. Referral payouts never spend the reserve for remaining prizes. Dashboard: GET /v1/arena/referrals?wallet=. Example: npm run arena:submit -- --asset BTC --price 100000. Python sample bot: examples/arena-bot (REFERRER env). Ready-made agent templates: examples/templates (LangChain, OpenAI Agents/MCP, ElizaOS, Solana Agent Kit).

Project layout

src/server.js          Express + x402 + sample + MCP mount
src/pulse.js           Public data aggregation + caches
src/summary.js         Plain-English summary + signals
src/discovery.js       llms.txt / well-known / OpenAPI
src/mcp-server.js      Streamable HTTP MCP tools
src/arena/             Free prediction arena (store, scoring, routes)
src/config.js          NETWORK / facilitator / payTo
mcp/stdio.js           Local stdio MCP proxy
mcp/server.json        Official MCP Registry draft
mcp/smithery.yaml      Smithery draft
scripts/…              wallets, buy, smoke, tests

Mainnet / deploy

See DEPLOY.md. Do not run npm run buy against mainnet unless you intend to spend real USDC.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Buyer-side trust layer for agents that pay x402 APIs. verified_route vets providers on paid-delivery evidence before the agent pays, sessions enforce a hard spend cap with receipts, and 17 crypto and market-data tools are free with no keys. Remote at https://agentpay.tools/mcp or npx @romudille/agentpay-mcp.
      20
      137 PyPI
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Real-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.
      15
      39 PyPI
      1
      MIT