{"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 access.\n2. **x402 pay-per-call** — no signup: call any endpoint with no key, receive a `402` with a USDC price (currently $0.001/request on base), pay via an x402 client, and get `200` + data. Settled on-chain via the Coinbase CDP facilitator.","contact":{"url":"https://api-production-54bd.up.railway.app"},"termsOfService":"https://api-production-54bd.up.railway.app/"},"servers":[{"url":"https://api-production-54bd.up.railway.app","description":"Production"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Free, rate-limited access."}},"schemas":{"Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","description":"Endpoint-specific payload."},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time"}},"additionalProperties":true}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"source":{"type":"string"}}},"X402Challenge":{"type":"object","description":"x402 payment challenge — sign a USDC transferWithAuthorization and retry with an X-PAYMENT header.","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","description":"USDC atomic units (6 decimals)."},"resource":{"type":"string"},"description":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string","description":"USDC token contract address."},"maxTimeoutSeconds":{"type":"integer"}}}}}}},"responses":{"Unauthorized":{"description":"Missing or invalid x-api-key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"No valid x-api-key — pay per call via x402 (USDC on Base). See the `accepts` array for exact price/network/payTo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402Challenge"}}}},"RateLimited":{"description":"Rate limit exceeded (keyed access)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UpstreamError":{"description":"Upstream data error — never fabricated data, a real source failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"tags":[{"name":"Meta","description":"Health & service catalog"},{"name":"Price & Indicators","description":"Spot prices, OHLCV, ATR, Fair Value Gaps, ICT liquidity levels"},{"name":"Derivatives & Flow","description":"Funding/OI, long-short ratio, order books, basis, Hyperliquid"},{"name":"Markets & Macro","description":"Kalshi prediction markets, macro event calendar"},{"name":"DeFi & Macro Data","description":"TVL, market overview, gas, rates, volatility, sentiment, market clock"},{"name":"AI Signals","description":"Momentum-score verdict"}],"paths":{"/health":{"get":{"operationId":"get_health","summary":"Liveness check","description":"Liveness check. Returns 200 with uptime.","tags":["Meta"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[]}},"/v1/status":{"get":{"operationId":"get_v1_status","summary":"Service catalog — lists all available endpoints.","description":"Service catalog — lists all available endpoints.","tags":["Meta"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[]}},"/v1/kalshi-probability":{"get":{"operationId":"get_v1_kalshi_probability","summary":"Kalshi prediction-market probabilities","description":"Kalshi prediction-market probabilities. Query by category (returns the most active open markets) or a specific market ticker.\n\n**Example:** `/v1/kalshi-probability?category=crypto`","tags":["Markets & Macro"],"parameters":[{"name":"category","in":"query","required":true,"description":"Optional. One of: crypto, macro, fed-rate, financials, politics, sports, world, companies, climate, science, health, entertainment, elections. Either category or ticker is required.","schema":{"type":"string"}},{"name":"ticker","in":"query","required":false,"description":"Optional. A specific Kalshi market ticker (e.g. KXBTCD-...).","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Optional. Max markets to return for a category query (default 25, max 100).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/kalshi-market":{"get":{"operationId":"get_v1_kalshi_market","summary":"Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker.","description":"Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker.\n\n**Example:** `/v1/kalshi-market?ticker=KXBTCD-26JUN1315-T64099.99`","tags":["Markets & Macro"],"parameters":[{"name":"ticker","in":"query","required":true,"description":"Required. A Kalshi market ticker (e.g. KXBTCD-26JUN1315-T64099.99).","schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"description":"Optional. Orderbook depth per side (default 10, max 100).","schema":{"type":"number"}},{"name":"trades","in":"query","required":false,"description":"Optional. Recent trades to return (default 20, max 100).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/funding-oi":{"get":{"operationId":"get_v1_funding_oi","summary":"Aggregated perpetual-futures funding rate & open interest from Binance + Bybit, with 7-day average funding, 24h OI change, and a long/short bias signal.","description":"Aggregated perpetual-futures funding rate & open interest from Binance + Bybit, with 7-day average funding, 24h OI change, and a long/short bias signal.\n\n**Example:** `/v1/funding-oi?symbol=BTC`","tags":["Derivatives & Flow"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. Base crypto symbol (e.g. BTC, ETH, SOL). Mapped to the <SYMBOL>USDT perpetual ticker on Binance/Bybit.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/long-short-ratio":{"get":{"operationId":"get_v1_long_short_ratio","summary":"Binance long/short ratios: global account, top-trader account, top-trader position, and taker buy/sell","description":"Binance long/short ratios: global account, top-trader account, top-trader position, and taker buy/sell. Companion to funding-oi.\n\n**Example:** `/v1/long-short-ratio?symbol=BTC&period=1h`","tags":["Derivatives & Flow"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. Base crypto symbol (e.g. BTC). Mapped to <SYMBOL>USDT.","schema":{"type":"string"}},{"name":"period","in":"query","required":false,"description":"Optional. One of 5m,15m,30m,1h,2h,4h,6h,12h,1d (default 5m).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/orderbook":{"get":{"operationId":"get_v1_orderbook","summary":"Top-of-book depth + spread (bps) from Binance, Bybit, or Hyperliquid.","description":"Top-of-book depth + spread (bps) from Binance, Bybit, or Hyperliquid.\n\n**Example:** `/v1/orderbook?symbol=BTC&exchange=binance&depth=10`","tags":["Derivatives & Flow"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. Base crypto symbol (e.g. BTC).","schema":{"type":"string"}},{"name":"exchange","in":"query","required":false,"description":"Optional. binance (default), bybit, or hyperliquid.","schema":{"type":"string","enum":["binance","bybit","hyperliquid"]}},{"name":"depth","in":"query","required":false,"description":"Optional. Levels per side (default 10, max 50).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/basis":{"get":{"operationId":"get_v1_basis","summary":"Spot-vs-perp basis (premium %) with funding-implied annualized carry","description":"Spot-vs-perp basis (premium %) with funding-implied annualized carry. Spot from Coinbase; perp marks from Binance + Bybit.\n\n**Example:** `/v1/basis?symbol=BTC`","tags":["Derivatives & Flow"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. Base crypto symbol (e.g. BTC).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/hyperliquid":{"get":{"operationId":"get_v1_hyperliquid","summary":"Hyperliquid perpetual context: funding (hourly), open interest, mark/oracle/mid price, premium, 24h volume","description":"Hyperliquid perpetual context: funding (hourly), open interest, mark/oracle/mid price, premium, 24h volume. Not geo-blocked.\n\n**Example:** `/v1/hyperliquid?symbol=BTC`","tags":["Derivatives & Flow"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. Hyperliquid coin name (e.g. BTC, ETH, SOL).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/volatility":{"get":{"operationId":"get_v1_volatility","summary":"Deribit volatility: DVOL implied-vol index (30d forward) + latest realized volatility, for BTC or ETH.","description":"Deribit volatility: DVOL implied-vol index (30d forward) + latest realized volatility, for BTC or ETH.\n\n**Example:** `/v1/volatility?currency=BTC`","tags":["DeFi & Macro Data"],"parameters":[{"name":"currency","in":"query","required":false,"description":"Optional. BTC (default) or ETH.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/sentiment":{"get":{"operationId":"get_v1_sentiment","summary":"Crypto Fear & Greed Index (alternative.me), current reading + optional history.","description":"Crypto Fear & Greed Index (alternative.me), current reading + optional history.\n\n**Example:** `/v1/sentiment?limit=7`","tags":["DeFi & Macro Data"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional. Number of days of history (default 1, max 90).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/defi-tvl":{"get":{"operationId":"get_v1_defi_tvl","summary":"DefiLlama data: TVL by chain, stablecoin circulating supply, or yield pools.","description":"DefiLlama data: TVL by chain, stablecoin circulating supply, or yield pools.\n\n**Example:** `/v1/defi-tvl?view=chains`","tags":["DeFi & Macro Data"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional. chains (default), stablecoins, or yields.","schema":{"type":"string","enum":["chains","stablecoins","yields"]}},{"name":"chain","in":"query","required":false,"description":"Optional (yields view). Filter pools by chain, e.g. Ethereum.","schema":{"type":"string"}},{"name":"project","in":"query","required":false,"description":"Optional (yields view). Filter pools by project, e.g. aave-v3.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Optional. Rows to return (default 20, max 100).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/price":{"get":{"operationId":"get_v1_price","summary":"Current spot price for crypto (Coinbase) or US equities/ETFs (Alpaca SIP), via the shared routing layer.","description":"Current spot price for crypto (Coinbase) or US equities/ETFs (Alpaca SIP), via the shared routing layer.\n\n**Example:** `/v1/price?symbol=BTC`","tags":["Price & Indicators"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. e.g. BTC, ETH, SUI, NVDA, SPY.","schema":{"type":"string"}},{"name":"class","in":"query","required":true,"description":"Optional. stock|crypto — required for symbols outside the curated list.","schema":{"type":"string","enum":["stock","crypto"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/ohlcv":{"get":{"operationId":"get_v1_ohlcv","summary":"OHLCV candles (oldest-first) for crypto or stocks","description":"OHLCV candles (oldest-first) for crypto or stocks. Routes to Alpaca SIP / Alpaca-crypto / Coinbase.\n\n**Example:** `/v1/ohlcv?symbol=NVDA&timeframe=1h&limit=100`","tags":["Price & Indicators"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. e.g. BTC, NVDA, SPY.","schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"description":"Optional. 1m,5m,15m,30m,1h,2h,4h,6h,12h,1D,1W (default 1h).","schema":{"type":"string","enum":["1m","5m","15m","30m","1h","2h","4h","6h","12h","1D","1W"]}},{"name":"class","in":"query","required":false,"description":"Optional. stock|crypto for non-curated symbols.","schema":{"type":"string","enum":["stock","crypto"]}},{"name":"limit","in":"query","required":false,"description":"Optional. Candles to return (default 100, max 300).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/atr":{"get":{"operationId":"get_v1_atr","summary":"Average True Range (Wilder's) + volatility-regime classification (low/normal/high/extreme by historical percentile)","description":"Average True Range (Wilder's) + volatility-regime classification (low/normal/high/extreme by historical percentile). Crypto or stocks.\n\n**Example:** `/v1/atr?symbol=BTC&timeframe=1h&period=14`","tags":["Price & Indicators"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. e.g. BTC, NVDA, SPY (or any with &class=).","schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"description":"Optional. 1m,5m,15m,30m,1h,2h,4h,6h,12h,1D,1W (default 1h).","schema":{"type":"string","enum":["1m","5m","15m","30m","1h","2h","4h","6h","12h","1D","1W"]}},{"name":"period","in":"query","required":false,"description":"Optional. ATR period (default 14).","schema":{"type":"number"}},{"name":"class","in":"query","required":false,"description":"Optional. stock|crypto for non-curated symbols.","schema":{"type":"string","enum":["stock","crypto"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/rates":{"get":{"operationId":"get_v1_rates","summary":"US Treasury yield curve (1M–30Y) + recession-indicator spreads (10y-2y, 10y-3m), from FRED.","description":"US Treasury yield curve (1M–30Y) + recession-indicator spreads (10y-2y, 10y-3m), from FRED.\n\n**Example:** `/v1/rates`","tags":["DeFi & Macro Data"],"parameters":[{"name":"series","in":"query","required":false,"description":"Optional. A specific FRED series id (e.g. DGS10) for a single value.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/market-clock":{"get":{"operationId":"get_v1_market_clock","summary":"US equities market clock (is_open, next_open/close) + upcoming sessions, via Alpaca","description":"US equities market clock (is_open, next_open/close) + upcoming sessions, via Alpaca. Crypto endpoints are 24/7 and unaffected.\n\n**Example:** `/v1/market-clock`","tags":["DeFi & Macro Data"],"parameters":[{"name":"days","in":"query","required":false,"description":"Optional. Upcoming session days to include (default 3, max 30; 0 to omit).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/market-overview":{"get":{"operationId":"get_v1_market_overview","summary":"CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap.","description":"CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap.\n\n**Example:** `/v1/market-overview`","tags":["DeFi & Macro Data"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional. global (default) or coins.","schema":{"type":"string","enum":["global","coins"]}},{"name":"limit","in":"query","required":false,"description":"Optional (coins view). Number of coins (default 20, max 100).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/gas":{"get":{"operationId":"get_v1_gas","summary":"Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan.","description":"Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan.\n\n**Example:** `/v1/gas`","tags":["DeFi & Macro Data"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/fvg":{"get":{"operationId":"get_v1_fvg","summary":"Fair Value Gap zones (standard ICT/LuxAlgo) with CE (50%), gap size, age, fill status, distance from price","description":"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.\n\n**Example:** `/v1/fvg?symbol=BTC&timeframe=1h`","tags":["Price & Indicators"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. e.g. BTC, NVDA, SPY (or any with &class=).","schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"description":"Optional. 1m,5m,15m,30m,1h,2h,4h,6h,12h,1D,1W (default 1h). Matches TradingView candles.","schema":{"type":"string","enum":["1m","5m","15m","30m","1h","2h","4h","6h","12h","1D","1W"]}},{"name":"class","in":"query","required":false,"description":"Optional. stock|crypto for non-curated symbols.","schema":{"type":"string","enum":["stock","crypto"]}},{"name":"include_filled","in":"query","required":false,"description":"Optional. true to include filled FVGs (default false = active only).","schema":{"type":"boolean"}},{"name":"min_gap_pct","in":"query","required":false,"description":"Optional. Filter out gaps smaller than this % of price (default 0 = all).","schema":{"type":"number"}},{"name":"lookback","in":"query","required":false,"description":"Optional. Timeframe candles to analyze (default 120, max 500).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/liquidity-levels":{"get":{"operationId":"get_v1_liquidity_levels","summary":"ICT liquidity levels: buy-side liquidity (above swing highs) & sell-side (below swing lows), sweep/taken status, relative-equal pools, and nearest untaken targets","description":"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.\n\n**Example:** `/v1/liquidity-levels?symbol=TQQQ&timeframe=1h`","tags":["Price & Indicators"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. e.g. BTC, NVDA, TQQQ (or any with &class=).","schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"description":"Optional. 1m..1W (default 1h).","schema":{"type":"string","enum":["1m","5m","15m","30m","1h","2h","4h","6h","12h","1D","1W"]}},{"name":"swing_length","in":"query","required":false,"description":"Optional. Pivot strength — bars each side of a swing (default 5). Tune to match your chart indicator.","schema":{"type":"number"}},{"name":"equal_threshold_pct","in":"query","required":false,"description":"Optional. Group swings within this % as relative-equal pools (default 0.1).","schema":{"type":"number"}},{"name":"include_swept","in":"query","required":false,"description":"Optional. true to include already-taken levels (default false = resting only).","schema":{"type":"boolean"}},{"name":"lookback","in":"query","required":false,"description":"Optional. Candles to analyze (default 300, max 500).","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/macro-calendar":{"get":{"operationId":"get_v1_macro_calendar","summary":"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.","description":"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.\n\n**Example:** `/v1/macro-calendar`","tags":["Markets & Macro"],"parameters":[{"name":"days","in":"query","required":false,"description":"Optional. Only events within the next N days.","schema":{"type":"number"}},{"name":"type","in":"query","required":false,"description":"Optional. Filter to FOMC, CPI, or NFP.","schema":{"type":"string","enum":["FOMC","CPI","NFP"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}},"/v1/momentum-score":{"get":{"operationId":"get_v1_momentum_score","summary":"Multi-asset momentum verdict (bias, confidence, thesis, entry/invalidation/targets, signal readings) from the oracle.py pipeline, run on a separate Python service","description":"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.\n\n**Example:** `/v1/momentum-score?symbol=BTC&timeframe=1h`","tags":["AI Signals"],"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required. One of: BTC, ETH, SOL, SUI, NVDA, IBIT, COIN, QQQ, TQQQ, DIA.","schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"description":"Optional. 15m, 1h, 4h, 1D, 1W (default 1h).","schema":{"type":"string","enum":["15m","1h","4h","1D","1W"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"}},"security":[{"ApiKeyAuth":[]},{}],"x-402":{"scheme":"exact","network":"base","price":"$0.001","maxAmountRequired":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x63EbccD826b874CE988e6498eAabB6Bd47AfC8A4"}}}}}