Skip to main content
Glama
Wicked API - Agent First API Services

Wicked API - Agent First API Services

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

Trading Data API

22 (unprefixed: price, ohlcv, fvg, momentum_score, sentiment, macro_calendar, …)

API key or x402, 5 free

Protocol Health Oracle

6 (protocol_health_*)

API key or x402, scoreboard free

Token Risk Oracle

1 (token_risk)

100% free, no key

Broker Sync API

6 (broker_sync_*)

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 402 payment challenge (price, network, payTo) as the tool result.

  • Autonomous pay-per-call — set WICKEDAPI_PAYER_PRIVATE_KEY to 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_KEY for 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's llms.txt

  • wickedapi://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, optional symbol) — token risk check + market sentiment + optional momentum read, before buying.

  • vet_dependency (slug, optional token_address, chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.

  • morning_briefing (optional symbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.

Environment variables

Var

Required

Notes

WICKEDAPI_API_KEY

no

Free, rate-limited access across all four services (same key works everywhere).

WICKEDAPI_PAYER_PRIVATE_KEY

no

Base-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed.

WICKEDAPI_BASE_URL

no

Override the Trading Data API base (default https://api.wickedapi.com).

WICKEDAPI_PROTOCOL_HEALTH_URL

no

Override the Protocol Health Oracle base (default https://protocol-health-oracle.wickedapi.com).

WICKEDAPI_TOKEN_RISK_URL

no

Override the Token Risk Oracle base (default https://token-risk-oracle.wickedapi.com).

WICKEDAPI_BROKER_SYNC_URL

no

Override the Broker Sync API base (default https://broker-sync-api.wickedapi.com).

WICKEDAPI_SHOWCASE_URL

no

Override the platform directory base used by resources (default https://wickedapi.com).

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

What 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 tools
atrB

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

    B3.4/5.0

    Scored across 22 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Financial 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.
      31
      22 npm
      9
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Real-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.
      15
      37 PyPI
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      56 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to access real-time financial data including crypto, equities, on-chain, prediction markets, and macro via a single API key.
      MIT