Wicked API - Agent First API Services
You can use this MCP server to query WickedAPI's live trading data, DeFi protocol health, token safety, and brokerage sync services without signup, via tools, resources, and prompts.
Trading data: 22 tools for prices, OHLCV, orderbook, funding/OI, long/short ratios, basis, Hyperliquid, volatility, sentiment, DeFi TVL, ATR, rates, market clock/overview, gas, FVGs, liquidity levels, macro/earnings calendars, momentum scores, and Kalshi probabilities/markets.
DeFi protocol health: 6
protocol_health_*tools to assess protocol risk.Token risk: 1 free
token_risktool (no key required).Brokerage sync: 6
broker_sync_*tools to sync brokerage data.Resources: Read platform directory,
llms.txt, and live endpoint catalogs for each service.Prompts: Run chained workflows:
rug_check,vet_dependency,morning_briefing.Auth options: Zero config (free tier or x402 payment challenge), API key, or autonomous pay-per-call with a Base wallet private key.
WickedAPI MCP Server
MCP server for the whole WickedAPI platform — trading data, DeFi protocol health, token safety, and brokerage sync, in one server.
35 tools across 4 live services, generated automatically from each service's own live openapi.json — the tool list always matches what's actually deployed:
Service | Tools | Auth |
22 (unprefixed: | API key or x402, 5 free | |
6 ( | API key or x402, scoreboard free | |
1 ( | 100% free, no key | |
6 ( | API key or x402 |
Plus 6 resources (the platform directory, llms.txt, and each service's live endpoint catalog) and 3 prompts (rug_check, vet_dependency, morning_briefing) that chain tools together the way the cookbook does.
No signup required
Every tool hits a real endpoint gated by x402 (HTTP-native pay-per-call, USDC on Base) with an API-key fallback — and the Token Risk Oracle tool is free no matter what:
Zero config — calls without credentials still work; paid endpoints return the real
402payment challenge (price, network,payTo) as the tool result.Autonomous pay-per-call — set
WICKEDAPI_PAYER_PRIVATE_KEYto a funded Base-mainnet wallet's private key, and every call auto-pays ~$0.001 in USDC and returns real data. No account, no subscription.Partner API key — set
WICKEDAPI_API_KEYfor free, rate-limited access across all four services (same key works everywhere).
Related MCP server: cerebrus-pulse-mcp
Install
{
"mcpServers": {
"wickedapi": {
"command": "npx",
"args": ["-y", "wickedapi-mcp"],
"env": {
"WICKEDAPI_API_KEY": "your-key-here"
}
}
}
}Or for autonomous pay-per-call instead of a key:
{
"mcpServers": {
"wickedapi": {
"command": "npx",
"args": ["-y", "wickedapi-mcp"],
"env": {
"WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
}
}
}
}Nothing configured? The Token Risk Oracle tool and the 5 free Trading Data API endpoints (sentiment, macro_calendar, market_overview, gas, kalshi_probability) still work with zero setup.
Resources
Read without calling a tool — useful for a client that surfaces resources in its UI:
wickedapi://platform/services— the full service directory (JSON)wickedapi://platform/llms— the platform'sllms.txtwickedapi://trading/status,wickedapi://protocol_health/status,wickedapi://token_risk/status,wickedapi://broker_sync/status— each service's live endpoint catalog
Prompts
One-click workflows that chain real tool calls (Claude Desktop and other prompt-aware clients surface these directly):
rug_check(address,chain, optionalsymbol) — token risk check + market sentiment + optional momentum read, before buying.vet_dependency(slug, optionaltoken_address,chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.morning_briefing(optionalsymbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.
Environment variables
Var | Required | Notes |
| no | Free, rate-limited access across all four services (same key works everywhere). |
| no | Base-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed. |
| no | Override the Trading Data API base (default |
| no | Override the Protocol Health Oracle base (default |
| no | Override the Token Risk Oracle base (default |
| no | Override the Broker Sync API base (default |
| no | Override the platform directory base used by resources (default |
If neither WICKEDAPI_API_KEY nor WICKEDAPI_PAYER_PRIVATE_KEY is set, paid calls still succeed at the protocol level — you'll get the real 402 challenge back as the tool result instead of data. If one service's spec fails to load (network hiccup, that service is down), its tools are simply skipped for the session — the rest still register normally.
Local development
npm install
npm run build
node dist/index.jsWhat this is not
This server doesn't reimplement any data logic — it's a thin, auto-generated bridge from MCP tool calls to the live WickedAPI HTTP endpoints across all four services. All the actual market data, indicators, scoring, and risk signals live in the APIs themselves.
Available Tools
22 toolsatrB
Average True Range (Wilder's) + volatility-regime classification (low/normal/high/extreme by historical percentile) — Average True Range (Wilder's) + volatility-regime classification (low/normal/high/extreme by historical percentile). Crypto or stocks.
Example: /v1/atr?symbol=BTC&timeframe=1h&period=14
Inputs: symbol (required), class, period, timeframe.
basisB
Spot-vs-perp basis (premium %) with funding-implied annualized carry — Spot-vs-perp basis (premium %) with funding-implied annualized carry. Spot from Coinbase; perp marks from Binance + Bybit.
Example: /v1/basis?symbol=BTC
Inputs: symbol (required).
defi_tvlC
DefiLlama data: TVL by chain, stablecoin circulating supply, or yield pools. — DefiLlama data: TVL by chain, stablecoin circulating supply, or yield pools.
Example: /v1/defi-tvl?view=chains
Inputs: view, chain, limit, project.
earnings_calendarA
US equity earnings announcement calendar: report date, before/after-market timing, analyst EPS estimate + count, market cap, and prior-year actual EPS — US equity earnings announcement calendar: report date, before/after-market timing, analyst EPS estimate + count, market cap, and prior-year actual EPS. Sourced live from Nasdaq's public calendar.
Example: /v1/earnings-calendar?date=2026-07-14&days=3
Inputs: date, days, symbol.
funding_oiA
Aggregated perpetual-futures funding rate & open interest from Binance + Bybit, with 7-day average funding, 24h OI change, and a long/short bias signal. — Aggregated perpetual-futures funding rate & open interest from Binance + Bybit, with 7-day average funding, 24h OI change, and a long/short bias signal.
Example: /v1/funding-oi?symbol=BTC
Inputs: symbol (required).
fvgB
Fair Value Gap zones (standard ICT/LuxAlgo) with CE (50%), gap size, age, fill status, distance from price — Fair Value Gap zones (standard ICT/LuxAlgo) with CE (50%), gap size, age, fill status, distance from price. Standard timeframes match TradingView candles. Crypto or stocks.
Example: /v1/fvg?symbol=BTC&timeframe=1h
Inputs: symbol (required), class, lookback, timeframe, +2 more.
gasA
Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan. — Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan.
Example: /v1/gas
Inputs: no named parameters.
hyperliquidC
Hyperliquid perpetual context: funding (hourly), open interest, mark/oracle/mid price, premium, 24h volume — Hyperliquid perpetual context: funding (hourly), open interest, mark/oracle/mid price, premium, 24h volume. Not geo-blocked.
Example: /v1/hyperliquid?symbol=BTC
Inputs: symbol (required).
kalshi_marketC
Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker. — Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker.
Example: /v1/kalshi-market?ticker=KXBTCD-26JUN1315-T64099.99
Inputs: ticker (required), depth, trades.
kalshi_probabilityA
Kalshi prediction-market probabilities — Kalshi prediction-market probabilities. Query by category (returns the most active open markets) or a specific market ticker.
Example: /v1/kalshi-probability?category=crypto
Inputs: category (required), limit, ticker.
liquidity_levelsC
ICT liquidity levels: buy-side liquidity (above swing highs) & sell-side (below swing lows), sweep/taken status, relative-equal pools, and nearest untaken targets — ICT liquidity levels: buy-side liquidity (above swing highs) & sell-side (below swing lows), sweep/taken status, relative-equal pools, and nearest untaken targets. Crypto or stocks.
Example: /v1/liquidity-levels?symbol=TQQQ&timeframe=1h
Inputs: symbol (required), lookback, timeframe, swing_length, +2 more.
long_short_ratioC
Binance long/short ratios: global account, top-trader account, top-trader position, and taker buy/sell — Binance long/short ratios: global account, top-trader account, top-trader position, and taker buy/sell. Companion to funding-oi.
Example: /v1/long-short-ratio?symbol=BTC&period=1h
Inputs: symbol (required), period.
macro_calendarA
Upcoming US macro events (FOMC rate decisions, CPI, jobs report) with verified Fed/BLS dates, days-until, and Kalshi rate-decision odds (cut/hold/hike) for FOMC meetings. — Upcoming US macro events (FOMC rate decisions, CPI, jobs report) with verified Fed/BLS dates, days-until, and Kalshi rate-decision odds (cut/hold/hike) for FOMC meetings.
Example: /v1/macro-calendar
Inputs: days, type.
market_clockB
US equities market clock (is_open, next_open/close) + upcoming sessions, via Alpaca — US equities market clock (is_open, next_open/close) + upcoming sessions, via Alpaca. Crypto endpoints are 24/7 and unaffected.
Example: /v1/market-clock
Inputs: days.
market_overviewC
CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap. — CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap.
Example: /v1/market-overview
Inputs: view, limit.
momentum_scoreC
Multi-asset momentum verdict (bias, confidence, thesis, entry/invalidation/targets, signal readings) from the oracle.py pipeline, run on a separate Python service — Multi-asset momentum verdict (bias, confidence, thesis, entry/invalidation/targets, signal readings) from the oracle.py pipeline, run on a separate Python service. Scoped to 10 assets.
Example: /v1/momentum-score?symbol=BTC&timeframe=1h
Inputs: symbol (required), timeframe.
ohlcvB
OHLCV candles (oldest-first) for crypto or stocks — OHLCV candles (oldest-first) for crypto or stocks. Routes to Alpaca SIP / Alpaca-crypto / Coinbase.
Example: /v1/ohlcv?symbol=NVDA&timeframe=1h&limit=100
Inputs: symbol (required), class, limit, timeframe.
orderbookB
Top-of-book depth + spread (bps) from Binance, Bybit, or Hyperliquid. — Top-of-book depth + spread (bps) from Binance, Bybit, or Hyperliquid.
Example: /v1/orderbook?symbol=BTC&exchange=binance&depth=10
Inputs: symbol (required), depth, exchange.
priceA
Current spot price for crypto (Coinbase) or US equities/ETFs (Alpaca SIP), via the shared routing layer. — Current spot price for crypto (Coinbase) or US equities/ETFs (Alpaca SIP), via the shared routing layer.
Example: /v1/price?symbol=BTC
Inputs: class (required), symbol (required).
ratesC
US Treasury yield curve (1M–30Y) + recession-indicator spreads (10y-2y, 10y-3m), from FRED. — US Treasury yield curve (1M–30Y) + recession-indicator spreads (10y-2y, 10y-3m), from FRED.
Example: /v1/rates
Inputs: series.
sentimentA
Crypto Fear & Greed Index (alternative.me), current reading + optional history. — Crypto Fear & Greed Index (alternative.me), current reading + optional history.
Example: /v1/sentiment?limit=7
Inputs: limit.
volatilityA
Deribit volatility: DVOL implied-vol index (30d forward) + latest realized volatility, for BTC or ETH. — Deribit volatility: DVOL implied-vol index (30d forward) + latest realized volatility, for BTC or ETH.
Example: /v1/volatility?currency=BTC
Inputs: currency.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Each tool targets a distinct financial data type or source (e.g., ATR, FVG, basis, earnings calendar, Kalshi probability vs. market depth). No two tools serve the same purpose, and descriptions clearly delineate their outputs.
All tool names use lowercase snake_case with a consistent pattern of single nouns or verb_noun phrases (e.g., 'price', 'earnings_calendar', 'long_short_ratio'). No mixed naming conventions.
22 tools is slightly above the ideal range, but the wide scope of financial data (crypto, equities, macro, derivatives) justifies the count. Each tool adds distinct value without excessive redundancy.
The set covers a broad range of financial data (technical, fundamental, macro, sentiment, prediction markets) but lacks fundamental stock data (e.g., financials, dividends), forex, or commodities, leaving notable gaps for a comprehensive financial API.
Maintenance
Related MCP Connectors
Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).
Real-time data feeds for AI agents with USDC micropayments on Base for premium tools.
Live data for AI agents: crypto, Hyperliquid, stocks, news, macro, predictions. Free key or x402.
Aligned market data for AI agents: crypto, stocks, FX and macro on one clock. Local or hosted.
Related MCP Servers
- AlicenseAqualityDmaintenanceFinancial intelligence for AI agents. 31 tools across 8 data sources — regime, derivatives, stablecoin flows, momentum, volatility, macro, DeFi, weather patterns, political cycles, seasonality. The context layer between your agent and a bad trade.3122 npm9MIT
- AlicenseAqualityCmaintenanceReal-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.1537 PyPI1MIT
- FlicenseNot gradedqualityDmaintenance56 pay-per-call MCP endpoints for AI agents. Market signals, macro economics, crypto/DeFi, geopolitical intelligence, SEC filings, GitHub velocity, sanctions screening. USDC on Base Mainnet via x402.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access real-time financial data including crypto, equities, on-chain, prediction markets, and macro via a single API key.MIT