llms.txt Content
# Trading Data API (WickedAPI)
> Agent-ready trading & market-data API. Real-time crypto/stock prices & OHLCV, indicators (ATR, Fair Value Gaps, ICT liquidity levels), perp funding/OI, order books, Kalshi prediction markets, DeFi TVL, volatility, a verified macro calendar, and an AI momentum score. No fabricated data ever — a source failure returns a real 502/503, never a guessed value.
## Auth — two ways, both work on every /v1 endpoint
1. `x-api-key: YOUR_KEY` header — free, rate-limited. Request a key from the operator.
2. x402 pay-per-call — call with no key at all, receive an HTTP 402 with a USDC price (currently $0.001/request on base), pay via an x402 client, get 200 + data. Settled on-chain via the Coinbase CDP facilitator, auto-listed on the x402 Bazaar.
## Free, no-signup endpoints (no key, no payment, ever)
- [GET /v1/kalshi-probability](https://api.wickedapi.com/v1/kalshi-probability): Kalshi prediction-market probabilities
- [GET /v1/sentiment](https://api.wickedapi.com/v1/sentiment): Crypto Fear & Greed Index (alternative.me), current reading + optional history
- [GET /v1/market-overview](https://api.wickedapi.com/v1/market-overview): CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap
- [GET /v1/gas](https://api.wickedapi.com/v1/gas): Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan
- [GET /v1/macro-calendar](https://api.wickedapi.com/v1/macro-calendar): 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
## Paid endpoints (x-api-key or x402)
- [GET /v1/kalshi-market](https://api.wickedapi.com/v1/kalshi-market): Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker
- [GET /v1/funding-oi](https://api.wickedapi.com/v1/funding-oi): Aggregated perpetual-futures funding rate & open interest from Bi
OpenAPI Spec (preview)
{"openapi":"3.0.3","info":{"title":"Trading Data API","version":"1.0.0-mvp","description":"Agent-ready trading & market-data API. 23 endpoints across crypto/stock prices & OHLCV, indicators (ATR, Fair Value Gaps, ICT liquidity levels), perp funding/OI, order books, Kalshi prediction markets, DeFi TVL, volatility, a verified macro calendar, and an AI momentum score.\n\n**Access — two ways, both work on every /v1 endpoint:**\n1. **API key** — send an `x-api-key` header for free, rate-limited a