parkyucheol-del/alphapipeline

AlphaPipeline

Pay-per-call ($0.005–$0.03 USDC) market/on-chain data API for AI agents and trading bots — no signup, no API key, no OAuth. Authenticate and pay in a single request via the x402 protocol (HTTP 402) on Base, or call it as a remote MCP server from Claude Desktop, Cursor, or any MCP client.

Smithery x402 Bazaar Glama

---

Why AlphaPipeline

AlphaPipeline is a machine-first data API. Every endpoint is metered per call using x402: a request without a payment header gets back a standard HTTP 402 response describing exactly how to pay (asset, amount, network, recipient). No account creation, no dashboard, no API key issuance — sign, retry the request with the payment attached, and you get the data back in the same request/response cycle.

It is also exposed as a remote MCP server (POST /mcp) so agent frameworks (Claude Desktop, Cursor, LangChain, CrewAI, and anything else that speaks MCP) can discover and call it with zero custom integration code.

• Discovery is always free. initialize and tools/list never require payment — browse the full tool catalog before you decide to pay.
• One tool is a permanent free onboarding endpoint (unlocks.dump_risk, see below) so an agent can verify connectivity, latency, and response schema before it starts paying for the rest.
• Settlement is Coinbase CDP (Developer Platform) Facilitator on Base mainnet (eip155:8453), asset USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913).

The endpoints have not been reviewed by Coinbase — please ensure you trust them prior to sending funds.

---

Quickstart — Remote MCP

Add this to your MCP client's config (Claude Desktop claude_desktop_config.json, Cursor .cursor/mcp.json, or equivalent):

{
  "mcpServers": {
    "alphapipeline": {
      "url": "https://alphapipeline-eu.onrender.com/mcp"
    }
  }
}

tools/list works immediately with no payment. tools/call on a priced tool requires an x402-aware client that can sign and retry a payment (a wallet-holding bot/agent client — most stock chat UIs cannot pay automatically). See examples/ for a working Python client using the official x402 SDK.

Quickstart — Plain REST / x402

curl -s https://alphapipeline-eu.onrender.com/v1/market/kimchi-alert?symbol=BTC
# -> HTTP 402, payment terms in the `payment-required` response header (base64 JSON)
# sign a payment, retry with the PAYMENT-SIGNATURE header attached -> 200 + data

Note for client authors: this server speaks x402 v2 — the 402 response body is an empty {}; the actual payment terms (accepts array, price, asset, pay-to address) are base64-JSON in the payment-required response header, not the body. A client written against the older body-shaped convention will get an empty object with no error, not a loud failure. Decode the header instead.

Note on unlocks.dump_risk: it is intentionally free (no x402 payment required) as an onboarding tool. If a third-party discovery catalog (e.g. x402 Bazaar) still shows a stale non-zero price for it from before this change, treat this server's own / response and MCP tools/list output as the source of truth — they always reflect the live price.

Note on tool names: MCP tool names use a domain.tool_name dot-notation (e.g. market.kimchi_alert) so the tool list forms a navigable tree by domain. The REST paths under /v1/<domain>/... are unaffected by this and remain stable.

Full protocol reference: /llms.txt · x402 docs

---

Tools / Endpoints

Tool (MCP)	REST endpoint	Price	What it does
market.kimchi_alert	GET /v1/market/kimchi-alert	$0.01	Real-time Korea (Upbit) vs global crypto price premium — the "kimchi premium" — with reverse-premium and 1h-surge alerts.
tools.ai_markdown	GET /v1/tools/ai-markdown	$0.005	Converts any webpage URL into clean, ad-free Markdown optimized for LLM context windows.
security.token_risk	GET /v1/security/token-risk	$0.02	GoPlus/Honeypot.is-backed contract security check — honeypot flag, buy/sell tax, mintability, ownership renouncement.
security.contract_health_audit	GET /v1/security/contract-health-audit	$0.02	LP (liquidity pool) lock/burn audit reusing the same GoPlus data as token-risk — flags whether liquidity is locked, burned, or freely held by a single wallet.
security.token_diagnostic	GET /v1/security/token-diagnostic	$0.03	Bundles token_risk + contract_health_audit into one call (same GoPlus data, no new upstream calls). No composite score or letter grade — just both tools' fields plus a deduped risk_flags union. Cheaper than calling both separately.
derivatives.funding_rate	GET /v1/derivatives/funding-rate	$0.01	Bybit (primary) / Binance (fallback) perpetual futures funding rate.
derivatives.funding_apr_matrix	GET /v1/derivatives/funding-apr-matrix	$0.01	Annualizes the current funding rate into an APR and computes carry-trade breakeven days against an assumed round-trip trading cost.
dex.liquidity_slippage	GET /v1/dex/liquidity-slippage	$0.02	GeckoTerminal-backed DEX pool liquidity and estimated trade slippage, plus fixed $1k/$5k/$10k slippage_tiers for at-a-glance depth checks.
arb.spread_matrix	GET /v1/arb/spread-matrix	$0.02	CEX (Coinbase spot) vs DEX (GeckoTerminal) spread calculator with gas-adjusted profitability flag.
derivatives.whale_position_audit	GET /v1/derivatives/whale-position-audit	$0.02	Audits a Hyperliquid wallet address you supply: open positions, leverage, liquidation price, and PnL. Does not discover or rank wallets - Hyperliquid's public API has no leaderboard endpoint.
calendar.macro_dday	GET /v1/calendar/macro-dday	$0.01	Countdown to the nearest major US macro event (FOMC, CPI, NFP) from a static, pre-loaded calendar — no external API call, never fails on an upstream outage.
unlocks.dump_risk	GET /v1/unlocks/dump-risk	Free	On-chain (Sablier) proxy for token unlock/vesting dump risk. Kept free by default as an onboarding tool so agents can verify the service before paying for the rest.
prediction.neg_risk_arbitrage	GET /v1/prediction/neg-risk-arbitrage	$0.03	Detects basket arbitrage in a Polymarket neg-risk (mutually-exclusive, multi-outcome) event — a full YES basket always settles to $1, so a basket price away from $1 (after costs) is a near risk-free edge. Also returns the actual liquidity-bottleneck size executable right now, not just a top-of-book price. Polymarket only.
prediction.exit_capacity_audit	GET /v1/prediction/exit-capacity-audit	$0.02	Walks a Polymarket outcome's live order book to check whether a given position size can actually be filled right now, at what average price and price impact. Resolves by token_id or an exact market_slug.

Every response is timestamped in both UTC and KST, and every priced endpoint's payment prompt reads "Paid in USDC on Base." so a human looking at the 402 screen in a browser isn't left guessing which chain's USDC to send.

---

Disclaimer

AlphaPipeline provides quantitative market data and analytics for informational and research purposes only. It does not execute trades, place orders, hold custody of user funds, or provide brokerage/betting/gambling services of any kind — it is a read-only data layer. Users are solely responsible for ensuring their use of this data complies with the laws and regulations applicable in their own jurisdiction.

---

Links

• Live service: https://alphapipeline-eu.onrender.com
• Agent-readable spec: https://alphapipeline-eu.onrender.com/llms.txt
• OpenAPI docs: https://alphapipeline-eu.onrender.com/docs
• x402 Bazaar listing: https://www.x402bazaar.org/
• Glama listing (verified, TDQS A / 4.4): https://glama.ai/mcp/connectors/com.onrender.alphapipeline/alpha-pipeline-agent-mcp
• x402 protocol: https://docs.x402.org

License

See LICENSE.