{"openapi":"3.1.0","info":{"title":"Market Intelligence API","description":"Pay-per-call market intelligence for AI agents, built on observed data. On-chain order flow from executed DEX trades on Base, Ethereum, Arbitrum, Optimism, Polygon, Robinhood Chain and Solana (buy/sell pressure, momentum, anomalies vs each asset's own baseline, large trades, smart-money wallets, candles and daily datasets); token risk checks and swap quotes; Hyperliquid perps funding, open interest and crowding; SEC EDGAR (XBRL fundamentals, Form 4, Form 144, 13D/13G, dividends, fails-to-deliver, 8-K) and European ESEF fundamentals; European short interest (AMF); ECB, Eurostat, US Treasury and Federal Reserve data; CFTC positioning, EIA oil inventories and the official macro calendar; GDELT and SEC news; and deterministic analytics primitives on numbers you supply. Every answer is timestamped and names its source. Decisions (/api/v1/decision*) are a rule-based aggregation of these data with a free, live track record (/api/v1/decision/track-record). The chain query parameter of the token routes names the chain the token lives on; it is never the payment network, which every paid route lists in x-payment-info.networks as CAIP-2 ids.","contact":{"name":"Market Intelligence API","email":"hisazzul@gmail.com","url":"https://api.marketintelligenceapi.com"},"version":"1.3.0","x-guidance":"Every paid route answers HTTP 402 with x402 payment requirements (USDC on Base, Polygon, Arbitrum, World Chain or Solana; EURC on Base or World Chain); pay and repeat the request. You are charged only on HTTP 2xx: an unknown symbol is a free 404. Start with GET /api/v1/intelligence/{symbol} (live on-chain order flow of one asset), GET /api/v1/intelligence/summary (what is moving), GET /api/v1/intelligence/token-risk/{address} (before buying a token) or GET /api/v1/report/{symbol} (filings, flow and news of one stock). Free: /coverage (which symbols and sources exist), /api/v1/datasets, /status (data freshness), /api/v1/decision/track-record (measured hit rates). A signal of INSUFFICIENT_DATA means too few trades in the window. Full guide: /llms.txt.","x-operator":{"name":"Market Intelligence API","type":"independent operator","jurisdiction":"BG","country":"Bulgaria","website":"https://api.marketintelligenceapi.com"},"summary":"Market data for AI agents, paid per call with x402: token safety, on-chain order flow, SEC filings, macro, perps and news.","license":{"name":"Proprietary: pay-per-call terms","url":"https://api.marketintelligenceapi.com/transparency"}},"servers":[{"url":"https://api.marketintelligenceapi.com"}],"x-discovery":{"ownershipProofs":["0x48d5A78d480B4C32dE319C2aEF69e682Dc304615"]},"components":{"securitySchemes":{"siwx":{"type":"apiKey","in":"header","name":"SIGN-IN-WITH-X","x-agentcash-auth-kind":"siwx","description":"Optional: a wallet that bought prepaid credits signs the sign-in-with-x challenge of the 402 (CAIP-122) and the call is taken from its credit. Without it, pay the call with x402."}},"schemas":{"MarketIntelligenceDocument":{"type":"object","description":"Derived real-time market intelligence document built from trade activity and rolling baselines.","properties":{"id":{"type":"string","description":"Stable MongoDB document identifier."},"symbol":{"type":"string","description":"Normalized crypto or US equity symbol, e.g. BTCUSD or AAPL."},"window":{"type":"string","description":"Analysis window.","enum":["1m","5m","15m"]},"price":{"type":"number","description":"Latest observed trade price."},"volume":{"type":"number","description":"Total traded volume in the analysis window."},"buyVolume":{"type":"number","description":"Volume classified as buy-side trade flow."},"sellVolume":{"type":"number","description":"Volume classified as sell-side trade flow."},"buyPressure":{"type":"number","description":"Buy pressure percentage, from 0 to 100."},"buySellRatio":{"type":["number","null"],"description":"Ratio of buy volume to sell volume; null when nothing was sold in the window."},"buySellImbalance":{"type":"number","description":"Buy-side minus sell-side imbalance as a percentage of total volume."},"priceChangePercent":{"type":"number","description":"Price change percentage over the analysis window."},"volumeAcceleration":{"type":"number","description":"Current volume relative to the previous comparable window."},"tradeAcceleration":{"type":"number","description":"Current trade count relative to the previous comparable window."},"momentumScore":{"type":"number","description":"Derived momentum score."},"activityScore":{"type":"number","description":"Derived relative trading activity score."},"anomalyScore":{"type":"number","description":"Derived anomaly score based on baseline deviations and activity/volume multiples."},"confidenceScore":{"type":"number","description":"Confidence score derived from trade count and historical baseline samples."},"averageTradeSize":{"type":"number","description":"Average traded volume per trade."},"tradeRatePerMinute":{"type":"number","description":"Trade count per minute."},"volumeRatePerMinute":{"type":"number","description":"Volume traded per minute."},"priceChangePerMinute":{"type":"number","description":"Price change percentage per minute."},"tradeCount":{"type":"integer","description":"Number of trades in the analysis window."},"largeTradeCount":{"type":"integer","description":"Number of detected large trades."},"largeBuyVolume":{"type":"number","description":"Volume attributed to large buy-side trades."},"largeSellVolume":{"type":"number","description":"Volume attributed to large sell-side trades."},"maxTradeSize":{"type":"number","description":"Largest individual trade size."},"maxTradeNotional":{"type":"number","description":"Largest individual trade notional value."},"dominantSide":{"type":"string","description":"Dominant trade-flow side.","enum":["BUY","SELL","BALANCED"]},"signal":{"type":"string","description":"Derived market signal. INSUFFICIENT_DATA when the window has fewer than 10 trades (see dataSufficiency): the raw counts are still returned, but they are too few to read a direction."},"signalStrength":{"type":"string","description":"Signal strength; NONE with INSUFFICIENT_DATA.","enum":["NONE","LOW","MEDIUM","HIGH"]},"timestamp":{"type":"string","description":"Timestamp of the intelligence observation.","format":"date-time"},"previousSignal":{"type":"string","description":"Previous signal when available."},"signalChangedAt":{"type":"string","description":"Timestamp when the current signal began.","format":"date-time"},"signalAgeSeconds":{"type":"integer","description":"Age of the current signal in seconds."},"activityMultiple":{"type":"number","description":"Trading activity multiple relative to baseline."},"volumeMultiple":{"type":"number","description":"Volume multiple relative to baseline."},"activityZScore":{"type":"number","description":"Trading activity deviation from baseline in standard deviations."},"volumeZScore":{"type":"number","description":"Volume deviation from baseline in standard deviations."},"baselineSamples":{"type":"integer","description":"Number of historical baseline samples."},"baselineReady":{"type":"boolean","description":"Whether the historical baseline has reached the minimum sample threshold."},"marketPercentile":{"type":"number","description":"Percentile rank of activity among covered symbols."},"relativeMomentumPercentile":{"type":"number","description":"Percentile rank of momentum among covered symbols."},"relativeBuyPressurePercentile":{"type":"number","description":"Percentile rank of buy pressure among covered symbols."},"eventType":{"type":"string","description":"Derived market event type."},"lifecycleState":{"type":"string","description":"Signal lifecycle state.","enum":["NEW_SIGNAL","PERSISTING"]},"observations":{"type":"object","description":"Machine-readable observed market measurements.","additionalProperties":true},"interpretation":{"type":"object","description":"Machine-readable interpretation of momentum, activity, buying and relative strength.","additionalProperties":true},"evidence":{"type":"array","description":"Human-readable evidence supporting the derived signal.","items":{"type":"string"}},"sideDataAvailable":{"type":"boolean","description":"Whether the buy and sell sides of the trades are known; false means buyPressure is a neutral 50 placeholder and the side-based signals are not available."}}},"CompactMarketIntelligence":{"type":"object","description":"Compact market intelligence representation used inside summary, comparison and regime responses.","properties":{"symbol":{"type":"string","description":"Normalized crypto or US equity symbol, e.g. BTCUSD or AAPL."},"window":{"type":"string","description":"Analysis window.","enum":["1m","5m","15m"]},"price":{"type":"number","description":"Latest observed trade price."},"volume":{"type":"number","description":"Total traded volume in the analysis window."},"buyPressure":{"type":"number","description":"Buy pressure percentage, from 0 to 100."},"buySellImbalance":{"type":"number","description":"Buy-side minus sell-side imbalance as a percentage of total volume."},"priceChangePercent":{"type":"number","description":"Price change percentage over the analysis window."},"volumeAcceleration":{"type":"number","description":"Current volume relative to the previous comparable window."},"tradeAcceleration":{"type":"number","description":"Current trade count relative to the previous comparable window."},"momentumScore":{"type":"number","description":"Derived momentum score."},"activityScore":{"type":"number","description":"Derived relative trading activity score."},"anomalyScore":{"type":"number","description":"Derived anomaly score based on baseline deviations and activity/volume multiples."},"confidenceScore":{"type":"number","description":"Confidence score derived from trade count and historical baseline samples."},"tradeCount":{"type":"integer","description":"Number of trades in the analysis window."},"largeTradeCount":{"type":"integer","description":"Number of detected large trades."},"largeBuyVolume":{"type":"number","description":"Volume attributed to large buy-side trades."},"largeSellVolume":{"type":"number","description":"Volume attributed to large sell-side trades."},"maxTradeSize":{"type":"number","description":"Largest individual trade size."},"maxTradeNotional":{"type":"number","description":"Largest individual trade notional value."},"dominantSide":{"type":"string","description":"Dominant trade-flow side.","enum":["BUY","SELL","BALANCED"]},"signal":{"type":"string","description":"Derived market signal. INSUFFICIENT_DATA when the window has fewer than 10 trades (see dataSufficiency): the raw counts are still returned, but they are too few to read a direction."},"signalStrength":{"type":"string","description":"Signal strength; NONE with INSUFFICIENT_DATA.","enum":["NONE","LOW","MEDIUM","HIGH"]},"previousSignal":{"type":"string","description":"Previous signal when available."},"signalChangedAt":{"type":"string","description":"Timestamp when the current signal began.","format":"date-time"},"signalAgeSeconds":{"type":"integer","description":"Age of the current signal in seconds."},"activityMultiple":{"type":"number","description":"Trading activity multiple relative to baseline."},"volumeMultiple":{"type":"number","description":"Volume multiple relative to baseline."},"activityZScore":{"type":"number","description":"Trading activity deviation from baseline in standard deviations."},"volumeZScore":{"type":"number","description":"Volume deviation from baseline in standard deviations."},"baselineSamples":{"type":"integer","description":"Number of historical baseline samples."},"baselineReady":{"type":"boolean","description":"Whether the historical baseline has reached the minimum sample threshold."},"marketPercentile":{"type":"number","description":"Percentile rank of activity among covered symbols."},"relativeMomentumPercentile":{"type":"number","description":"Percentile rank of momentum among covered symbols."},"relativeBuyPressurePercentile":{"type":"number","description":"Percentile rank of buy pressure among covered symbols."},"eventType":{"type":"string","description":"Derived market event type."},"lifecycleState":{"type":"string","description":"Signal lifecycle state.","enum":["NEW_SIGNAL","PERSISTING"]},"observations":{"type":"object","description":"Machine-readable observed market measurements.","additionalProperties":true},"interpretation":{"type":"object","description":"Machine-readable interpretation of momentum, activity, buying and relative strength.","additionalProperties":true},"evidence":{"type":"array","description":"Human-readable evidence supporting the derived signal.","items":{"type":"string"}},"sideDataAvailable":{"type":"boolean","description":"Whether the buy and sell sides of the trades are known; false means buyPressure is a neutral 50 placeholder and the side-based signals are not available."},"timestamp":{"type":"string","format":"date-time","description":"End of the window the figures describe (UTC)."}}},"DataFreshness":{"type":"object","properties":{"freshestMs":{"type":"integer","description":"Age in milliseconds of the freshest covered symbol."},"oldestMs":{"type":"integer","description":"Age in milliseconds of the oldest covered symbol."}}},"MarketSummary":{"type":"object","description":"Aggregated market summary generated from the current intelligence documents.","properties":{"window":{"type":"string","description":"Normalized analysis window.","enum":["1m","5m","15m"]},"symbolsCovered":{"type":"integer","description":"Number of symbols covered."},"bullishSymbols":{"type":"integer","description":"Number of symbols with bullish signals."},"bearishSymbols":{"type":"integer","description":"Number of symbols with bearish signals."},"neutralSymbols":{"type":"integer","description":"Number of symbols that are neither bullish nor bearish."},"bullishBreadthPercent":{"type":"number","description":"Percentage of symbols with bullish signals."},"bearishBreadthPercent":{"type":"number","description":"Percentage of symbols with bearish signals."},"averageBuyPressure":{"type":"number","description":"Average buy pressure across covered symbols."},"averagePriceChangePercent":{"type":"number","description":"Average price change percentage across covered symbols."},"unusualActivitySymbols":{"type":"integer","description":"Number of symbols with anomaly score at least 70."},"regime":{"type":"string","description":"Current aggregated market regime."},"topMomentum":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"topActivity":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"topBuying":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"topSelling":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"dataFreshness":{"$ref":"#/components/schemas/DataFreshness"},"staleSymbols":{"type":"integer","description":"Number of symbols considered stale."},"source":{"type":"string","description":"Trade data source identifier."},"timestamp":{"type":"string","description":"Response generation timestamp.","format":"date-time"}}},"MarketRegime":{"type":"object","properties":{"window":{"type":"string","description":"Normalized analysis window.","enum":["1m","5m","15m"]},"regime":{"type":"string","description":"Aggregated regime: BULLISH, BEARISH, MIXED, or NO_DATA."},"symbolsCovered":{"type":"integer","description":"Number of symbols covered."},"bullishBreadthPercent":{"type":"number","description":"Percentage of symbols satisfying the bullish context."},"bearishBreadthPercent":{"type":"number","description":"Percentage of symbols satisfying the bearish context."},"averageBuyPressure":{"type":"number","description":"Average buy pressure."},"averagePriceChangePercent":{"type":"number","description":"Average price change percentage."},"averageMomentumScore":{"type":"number","description":"Average momentum score."},"highConfidenceSignals":{"type":"integer","description":"Count of signals with confidence score at least 75."},"unusualActivity":{"type":"integer","description":"Count of symbols with anomaly score at least 70."},"topLeaders":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"topActivityConcentration":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"timestamp":{"type":"string","description":"Response generation timestamp.","format":"date-time"}}},"BacktestEventStats":{"type":"object","properties":{"occurrences":{"type":"integer","description":"Number of signal occurrences."},"averageConfidence":{"type":"number","description":"Average signal confidence."},"winRate5m":{"type":"number","description":"Win rate at the 5-minute horizon."},"winRate15m":{"type":"number","description":"Win rate at the 15-minute horizon."},"winRate60m":{"type":"number","description":"Win rate at the 60-minute horizon."},"averageReturn5mPercent":{"type":"number","description":"Average forward return at 5 minutes."},"averageReturn15mPercent":{"type":"number","description":"Average forward return at 15 minutes."},"averageReturn60mPercent":{"type":"number","description":"Average forward return at 60 minutes."},"medianReturn15mPercent":{"type":"number","description":"Median forward return at 15 minutes."},"averageMfe15mPercent":{"type":"number","description":"Average maximum favorable excursion over 15 minutes."},"averageMae15mPercent":{"type":"number","description":"Average maximum adverse excursion over 15 minutes."},"direction":{"type":"string","description":"Event direction."}}},"BacktestReturnStats":{"type":"object","properties":{"samples":{"type":"integer","description":"Number of return observations."},"averagePercent":{"type":"number","description":"Average forward return percentage."},"medianPercent":{"type":"number","description":"Median forward return percentage."},"positiveRate":{"type":"number","description":"Percentage of positive returns."}}},"BacktestResults":{"type":"object","properties":{"start":{"type":"string","description":"Backtest start timestamp.","format":"date-time"},"end":{"type":"string","description":"Backtest end timestamp.","format":"date-time"},"window":{"type":"string","description":"Analysis window.","enum":["1m","5m","15m"]},"symbolsAnalyzed":{"type":"integer","description":"Number of symbols analyzed."},"signalsEvaluated":{"type":"integer","description":"Number of qualifying signals evaluated."},"minConfidence":{"type":"integer","description":"Minimum confidence threshold."},"minBaselineSamples":{"type":"integer","description":"Minimum historical baseline samples."},"methodology":{"type":"string","description":"Walk-forward methodology description."},"dataResolution":{"type":"string","description":"Resolution of the historical source data."},"effectiveWindow":{"type":"string","description":"Effective aggregation window in seconds."},"signals":{"type":"object","description":"Statistics grouped by signal event type.","additionalProperties":{"$ref":"#/components/schemas/BacktestEventStats"}},"confidenceCalibration":{"type":"object","description":"Signal statistics grouped into confidence buckets.","additionalProperties":{"$ref":"#/components/schemas/BacktestEventStats"}},"allSignalsForwardReturns":{"type":"object","properties":{"1m":{"$ref":"#/components/schemas/BacktestReturnStats"},"5m":{"$ref":"#/components/schemas/BacktestReturnStats"},"15m":{"$ref":"#/components/schemas/BacktestReturnStats"},"60m":{"$ref":"#/components/schemas/BacktestReturnStats"}}}}},"SecMetric":{"type":"object","description":"SEC EDGAR-derived financial metric. Exact fields depend on the available SEC XBRL fact.","additionalProperties":true},"LatestFiling":{"type":"object","properties":{"form":{"type":"string","description":"SEC filing form, such as 10-K, 10-Q or 8-K."},"filingDate":{"type":"string","description":"SEC filing date."},"accessionNumber":{"type":"string","description":"SEC accession number."},"primaryDocument":{"type":"string","description":"Primary filing document name."}},"additionalProperties":true},"SecFundamentalIntelligence":{"type":"object","properties":{"symbol":{"type":"string","description":"Normalized US equity ticker."},"cik":{"type":"string","description":"SEC Central Index Key."},"companyName":{"type":"string","description":"Company name from SEC submissions."},"source":{"type":"string","description":"Data source identifier."},"sourceUrl":{"type":"string","description":"SEC data source URL.","format":"uri"},"asOf":{"type":"string","description":"Time at which the response was generated.","format":"date-time"},"latestFiling":{"$ref":"#/components/schemas/LatestFiling"},"financials":{"type":"object","description":"Latest available SEC/XBRL financial metrics.","additionalProperties":{"$ref":"#/components/schemas/SecMetric"}},"derivedIntelligence":{"type":"object","properties":{"revenueGrowthYoYPercent":{"type":"number","description":"Year-over-year revenue growth percentage."},"earningsGrowthYoYPercent":{"type":"number","description":"Year-over-year net income growth percentage."},"operatingMarginPercent":{"type":"number","description":"Operating margin percentage."},"netMarginPercent":{"type":"number","description":"Net margin percentage."},"returnOnAssetsPercent":{"type":"number","description":"Return on assets percentage."},"debtToEquity":{"type":"number","description":"Debt-to-equity ratio."},"cashToDebt":{"type":"number","description":"Cash-to-debt ratio."},"fundamentalSignal":{"type":"string","description":"Deterministic fundamental signal."},"signalScore":{"type":"number","description":"Deterministic fundamental signal score."},"confidence":{"type":"number","description":"Fundamental signal confidence."},"interpretation":{"type":"string","description":"Human-readable interpretation of the fundamental signal."}},"additionalProperties":true},"methodology":{"type":"array","items":{"type":"string"}}}},"MarketNewsDocument":{"type":"object","description":"A publisher-attributed crypto or US stock news headline, or a corporate filing event. Full article content is not redistributed; items carry an attribution notice where the metadata provider requires one.","required":["source","category","title","url","publishedAt","sentiment","sentimentScore"],"properties":{"id":{"type":"string","description":"Stable deduplication identifier."},"source":{"type":"string","description":"Publisher hostname from the article URL."},"category":{"type":"string","enum":["crypto","stocks","filings","europe","policy"],"description":"News category; filings are material corporate events (Form 8-K)."},"title":{"type":"string","description":"Publisher headline."},"summary":{"type":"string","description":"Short summary if available, e.g. the reported filing items."},"provider":{"type":"string","description":"Collection channel of the item."},"attribution":{"type":"string","description":"Citation to display when redistributing the item, if required by its metadata provider."},"url":{"type":"string","format":"uri","description":"Canonical publisher article URL."},"publishedAt":{"type":"string","format":"date-time","description":"Publisher publication timestamp when supplied by the feed."},"fetchedAt":{"type":"string","format":"date-time","description":"Timestamp when this service ingested the feed item."},"symbols":{"type":"array","items":{"type":"string"},"description":"Ticker-like symbols extracted from the headline and summary."},"keywords":{"type":"array","items":{"type":"string"},"description":"Matched market-sentiment keywords."},"sentiment":{"type":"string","enum":["positive","negative","neutral"],"description":"Lightweight keyword-based headline sentiment; not investment advice."},"sentimentScore":{"type":"integer","description":"Signed lightweight headline-sentiment score."}}},"CompareResult":{"$ref":"#/components/schemas/CompactMarketIntelligence"},"ErrorResponse":{"type":"object","description":"Error response.","additionalProperties":true},"AnalyticsError":{"type":"object","properties":{"error":{"type":"string","enum":["INVALID_INPUT","EMPTY_DATASET","INVALID_WEIGHT","ZERO_TOTAL_WEIGHT","UNEQUAL_SERIES_LENGTH","ZERO_VARIANCE","INSUFFICIENT_OBSERVATIONS","VALUE_OUT_OF_RANGE","PAYLOAD_TOO_LARGE"]},"message":{"type":"string"},"charged":{"type":"boolean"}},"required":["error","message"]}}},"paths":{"/api/v1/news":{"get":{"operationId":"getCryptoStockMarketNews","summary":"Get latest crypto and US stock market headlines","description":"Recent publisher-attributed market news for crypto and US stocks. Search current market headlines by category, ticker, company or keyword. Results include source attribution, article URL, publication time, extracted symbols and lightweight headline sentiment.","tags":["Market News","Crypto News","Stock News"],"security":[{},{"siwx":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["crypto","stocks","filings","europe","policy"]},"description":"Optional market category: crypto, stocks, filings (SEC 8-K) or europe (European market headlines, AMF short-position changes, ESEF annual reports, ECB releases, Eurostat inflation and unemployment prints).","example":"crypto"},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Optional keyword, company name or ticker search.","example":"tariffs"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum news items to return.","example":20}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Market-news results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketNewsDocument"}},"example":[{"source":"sec.gov","provider":"sec-edgar","category":"filings","title":"NVDA 8-K: NVIDIA Corp - Item 2.02: Results of Operations and Financial Condition","url":"https://www.sec.gov/Archives/edgar/data/...","publishedAt":"2026-09-23T19:05:00Z","symbols":["NVDA"],"sentiment":"neutral","sentimentScore":0}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_market_news"}},"/api/v1/news/symbol":{"get":{"operationId":"getSymbolMarketNews","summary":"Get recent headlines and filings for one ticker","description":"Recent publisher-attributed market-news headlines for one crypto or US stock ticker. Use this endpoint for company news, stock news, crypto asset news, symbol-specific headlines and news sentiment.","tags":["Market News","Symbol News"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","example":"NVDA"},"description":"Ticker or crypto symbol, for example NVDA, BTC or ETH."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum news items to return.","example":20}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}},"responses":{"200":{"description":"Ticker-specific market-news results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketNewsDocument"}},"example":[{"source":"sec.gov","provider":"sec-edgar","category":"filings","title":"NVDA 8-K: NVIDIA Corp - Item 2.02: Results of Operations and Financial Condition","url":"https://www.sec.gov/Archives/edgar/data/...","publishedAt":"2026-09-23T19:05:00Z","symbols":["NVDA"],"sentiment":"neutral","sentimentScore":0}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_symbol_news"}},"/api/v1/news/policy":{"get":{"operationId":"getPolicyNews","summary":"Get US policy news with its market exposure","description":"US administration policy news: GDELT headlines on the President and tariffs, the Federal Reserve, sanctions, crypto and trade deals, and every new presidential document (executive orders, proclamations, memoranda) from the Federal Register (public domain). Each item has topics (tariffs, trade_deal, fed, sanctions, crypto, energy, defense, tech, healthcare, taxes, immigration, geopolitics), exposed sectors and covered symbols, plus a link to the publisher or official text. Keyword tags only: no political or market judgement.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string","enum":["tariffs","trade_deal","fed","sanctions","crypto","energy","defense","tech","healthcare","taxes","immigration","geopolitics"]},"description":"Optional topic filter","example":"tariffs"},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional exposed symbol, e.g. NVDA or BTCUSD","example":"ETHUSD"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":720,"default":24},"description":"Look-back period in hours","example":24},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum number of items","example":20},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Also return items without a market topic (ceremonial proclamations and the like)","example":false}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Policy items with topics, sectors and exposed symbols","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"sectors":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"exposedSymbols":{"type":"array","items":{"type":"string"}},"topics":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"topicCounts":{"type":"object","properties":{"tariffs":{"type":"integer"},"fed":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"items":[{"kind":"official_document","sectors":["semiconductors"],"title":"Executive Order: Adjusting Imports of Semiconductors","exposedSymbols":["NVDA","AMD"],"topics":["tariffs","tech"]}],"topicCounts":{"tariffs":7,"fed":3}}}}},"400":{"description":"Unknown topic or invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No policy news for the filter (not charged)"}},"x-mcp-tool":"get_policy_news"}},"/api/v1/intelligence":{"get":{"summary":"List all covered assets ranked by trade-flow signal","description":"Real-time market signals, trade flow and signal strength for crypto and US stocks. Use this endpoint for market signals, market intelligence, trade flow, buying pressure, selling pressure, signal strength, momentum, trading activity, acceleration, anomalies, and complete market snapshots.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Maximum number of results to return","example":20}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Market intelligence response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getMarketIntelligence","x-mcp-tool":"get_market_intelligence"}},"/api/v1/intelligence/{symbol}":{"get":{"summary":"Get the live trade-flow signal for one asset","description":"Real-time market intelligence for a specific crypto or US stock symbol. Analyze price movement, momentum, buying pressure, selling pressure, trade flow, trading activity, signal strength, and unusual market activity. Also returns on-chain liquidity (cost of a $1k/$10k/$50k market order, liquidity score), sources[] and as_of.","security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any covered symbol, not only the example: crypto pairs (ETHUSD) and tokenized US stocks (NVDA); free list at /coverage. Unknown: 404, not charged.","example":"ETHUSD"},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Symbol intelligence response","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"number"},"priceChangePercent":{"type":"number"},"volume":{"type":"number"},"tradeCount":{"type":"integer"},"buyPressure":{"type":"number"},"buySellImbalance":{"type":"number"},"sideDataAvailable":{"type":"boolean"},"momentumScore":{"type":"number"},"activityScore":{"type":"number"},"anomalyScore":{"type":"number"},"confidenceScore":{"type":"number"},"activityMultiple":{"type":"number"},"volumeMultiple":{"type":"number"},"dominantSide":{"type":"string"},"signal":{"type":"string"},"signalStrength":{"type":"string"},"eventType":{"type":"string"},"largeTradeCount":{"type":"integer"},"evidence":{"type":"array","items":{"type":"string"}},"timestamp":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}}}},"402":{"description":"Payment Required"},"404":{"description":"No recent data for this symbol (not charged). The body lists the covered symbols.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getSymbolMarketIntelligence","x-mcp-tool":"get_symbol_intelligence"}},"/api/v1/intelligence/summary":{"get":{"summary":"Summarize market breadth, regime and top movers","description":"Aggregated real-time market summary for crypto and US stocks. Get market breadth, regime, average buying pressure, price change, top momentum, top activity, top buying, top selling, market events, and data freshness.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Market summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketSummary"},"example":{"window":"5m","symbolsCovered":24,"bullishSymbols":9,"bearishSymbols":5,"neutralSymbols":10,"bullishBreadthPercent":37.5,"averageBuyPressure":53.8,"regime":"MIXED","topMomentum":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}],"unusualActivitySymbols":2,"timestamp":"2026-09-23T19:30:00Z"}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getMarketSummary","x-mcp-tool":"get_market_summary"}},"/api/v1/intelligence/top-momentum":{"get":{"summary":"List assets with the strongest short-term momentum","description":"Real-time short-term momentum rankings for crypto and US stocks. Find momentum leaders, strongest price momentum, fastest-moving assets, accelerating symbols, and high-momentum signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Momentum rankings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getCryptoStockMomentumRankings","x-mcp-tool":"get_top_momentum"}},"/api/v1/intelligence/top-activity":{"get":{"summary":"List assets with unusually high trading activity","description":"Real-time trading activity rankings for crypto and US stocks. Find the most actively traded assets, highest trade counts, trading volume, activity multiples, and significant trading activity.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Activity rankings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getMostActiveCryptoStocks","x-mcp-tool":"get_top_activity"}},"/api/v1/intelligence/unusual":{"get":{"summary":"Detect statistical anomalies in trading activity","description":"Detect unusual and abnormal trading activity across crypto and US stocks. Find volume spikes, activity anomalies, unusual price movement, abnormal buying or selling pressure, trade anomalies, and statistically unusual market behavior.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10},{"name":"minAnomaly","in":"query","required":false,"schema":{"type":"number","default":70},"description":"Minimum anomaly score (0-100)","example":70},{"name":"minTrades","in":"query","required":false,"schema":{"type":"integer","default":3},"description":"Minimum number of trades in the window","example":3}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Unusual activity results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getUnusualTradingActivity","x-mcp-tool":"find_unusual_activity"}},"/api/v1/intelligence/events":{"get":{"summary":"List detected accumulation and breakout events","description":"Real-time market events for crypto and US stocks. Find significant price moves, momentum changes, unusual activity, buying or selling events, trade-flow changes, and emerging market signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Market events","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"SOLUSD","price":148.37,"priceChangePercent":1.84,"volume":5320.0,"tradeCount":1187,"buyPressure":66.2,"buySellImbalance":32.4,"sideDataAvailable":true,"momentumScore":78.5,"activityScore":83.1,"anomalyScore":72.4,"confidenceScore":88.6,"activityMultiple":2.6,"volumeMultiple":3.4,"dominantSide":"BUY","signal":"POTENTIAL_BREAKOUT","signalStrength":"HIGH","eventType":"POTENTIAL_BREAKOUT","largeTradeCount":9,"evidence":["Buy pressure is 66.2%","Volume is 3.4x baseline","Trades are 2.6x baseline","Price up 1.84% in 5m"],"timestamp":"2026-10-16T13:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getMarketEvents","x-mcp-tool":"find_market_events"}},"/api/v1/intelligence/buying":{"get":{"summary":"List assets under aggressive on-chain buying","description":"Real-time buy-side trade flow rankings for crypto and US stocks. Find assets with the strongest buying pressure, aggressive buying, buyer dominance, positive buy-side imbalance, and bullish buying signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10},{"name":"minBuyPressure","in":"query","required":false,"schema":{"type":"number","default":60},"description":"Minimum buy pressure in percent of aggressor volume (0-100)","example":60}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Buying pressure rankings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getStrongestBuyingPressure","x-mcp-tool":"find_strong_buying"}},"/api/v1/intelligence/selling":{"get":{"summary":"List assets under aggressive on-chain selling","description":"Real-time sell-side trade flow rankings for crypto and US stocks. Find assets with the strongest selling pressure, aggressive selling, seller dominance, negative buy-side imbalance, and bearish selling signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return","example":10},{"name":"maxBuyPressure","in":"query","required":false,"schema":{"type":"number","default":40},"description":"Maximum buy pressure in percent of aggressor volume (0-100)","example":40}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Selling pressure rankings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceDocument"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getStrongestSellingPressure","x-mcp-tool":"find_strong_selling"}},"/api/v1/intelligence/compare":{"get":{"summary":"Compare trade-flow signals of several assets","description":"Compare selected crypto and US stocks using momentum, price movement, buying pressure, selling pressure, trade flow, trading activity, anomalies, and signal strength.","security":[{},{"siwx":[]}],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string","example":"BTCUSD,ETHUSD,SOLUSD"},"description":"Comma-separated asset symbols, e.g. ETHUSD,BTCUSD,NVDA"},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Symbol comparison","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompactMarketIntelligence"}},"example":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}]}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"compareCryptoStocks","x-mcp-tool":"compare_symbols"}},"/api/v1/intelligence/regime":{"get":{"summary":"Classify the market regime as bullish or bearish","description":"Current market regime across crypto and US stocks. Identify bullish, bearish, or mixed market conditions using market breadth, momentum, buying pressure, selling pressure, trading activity, trade flow, and market signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Market regime","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketRegime"},"example":{"window":"5m","regime":"BULLISH","symbolsCovered":24,"bullishBreadthPercent":62.5,"bearishBreadthPercent":12.5,"averageBuyPressure":57.1,"averageMomentumScore":58.4,"topLeaders":[{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"}],"timestamp":"2026-09-23T19:30:00Z"}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"getMarketRegime","x-mcp-tool":"get_market_regime"}},"/api/v1/intelligence/backtest":{"get":{"summary":"Analyze signal performance in a walk-forward backtest","description":"Backtest and validate market intelligence signals using historical crypto and US stock data. Evaluate signal performance, forward returns, win rate, confidence, signal strength, maximum favorable excursion, maximum adverse excursion, and baseline performance.","security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"description":"Analysis window.","schema":{"type":"string","default":"5m","enum":["1m","5m","15m"]},"example":"5m"},{"name":"minConfidence","in":"query","required":false,"description":"Minimum signal confidence from 0 to 100.","schema":{"type":"integer","default":60,"minimum":0,"maximum":100},"example":60},{"name":"minBaselineSamples","in":"query","required":false,"description":"Minimum historical baseline samples; service enforces a minimum of 2.","schema":{"type":"integer","default":10,"minimum":2},"example":10},{"name":"start","in":"query","required":false,"description":"ISO-8601 backtest start timestamp. Defaults to 24 hours before end.","schema":{"type":"string","format":"date-time"}},{"name":"end","in":"query","required":false,"description":"ISO-8601 backtest end timestamp. Defaults to now.","schema":{"type":"string","format":"date-time"}},{"name":"symbols","in":"query","required":false,"description":"Comma-separated crypto or US equity symbols. Empty means all available symbols.","schema":{"type":"string"},"example":"ETHUSD,BTCUSD,NVDA"},{"name":"persist","in":"query","required":false,"description":"Whether to persist the backtest result.","schema":{"type":"boolean","default":false},"example":false}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"responses":{"200":{"description":"Backtest results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestResults"},"example":{"window":"5m","symbolsAnalyzed":24,"signalsEvaluated":318,"signals":{"POTENTIAL_BREAKOUT":{"occurrences":41,"averageReturn15mPercent":0.21,"winRate15m":58.5}},"methodology":"walk-forward; baseline uses only preceding buckets; returns are measured after signal detection"}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["Market Intelligence"],"operationId":"backtestMarketSignals","x-mcp-tool":"backtest_signals"}},"/mcp":{"post":{"summary":"Fetch market intelligence tools over MCP JSON-RPC","description":"MCP market intelligence tools for AI agents. Access aggregated market intelligence, symbol intelligence, momentum, activity, buying pressure, selling pressure, trade flow, signal strength, unusual activity, market regime, market events, SEC stock fundamentals, and signal backtesting through MCP JSON-RPC. initialize and tools/list are free; each tools/call is priced like the matching HTTP route ($0.003-$0.05), shown in the 402 response.","security":[{},{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"dynamic","currency":"USD","min":"0.003","max":"0.05"}},"responses":{"200":{"description":"MCP JSON-RPC response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"result":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"id":{"type":"integer"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"jsonrpc":"2.0","result":{"tools":[{"name":"get_market_summary"}]},"id":1}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"tags":["MCP"],"operationId":"getMarketIntelligenceMcpTools"}},"/api/v1/fundamentals/{symbol}":{"get":{"operationId":"getSecFundamentalsFinancialStatements","summary":"Get SEC financial statements for a US company","description":"SEC fundamentals, stock fundamentals and financial statements for US equities. Get company financials from SEC EDGAR including income statement, balance sheet, cash flow, revenue, net income, EPS, assets, liabilities, equity, revenue growth, earnings growth, profit margins, return on assets, debt-to-equity, cash-to-debt, SEC filings, 10-K, 10-Q, XBRL data and deterministic fundamental signals.","security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example, or a crypto pair (BTCUSD, ETHUSD) for its crypto fundamentals: perp price, volume, open interest, funding and CME positioning. Unknown: 404, not charged.","example":"AAPL"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"SEC EDGAR-derived fundamental intelligence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecFundamentalIntelligence"},"example":{"symbol":"AAPL","companyName":"Apple Inc.","asOf":"2026-09-23","latestFiling":{"reportDate":"2026-06-28","filingDate":"2026-08-01","form":"10-Q"},"financials":{"revenue":{"concept":"RevenueFromContractWithCustomerExcludingAssessedTax","value":94036000000,"periodEnd":"2026-06-28","unit":"USD","form":"10-Q"}},"derivedIntelligence":{"confidence":0.82,"signalScore":61,"fundamentalSignal":"STABLE"}}}}},"400":{"description":"Invalid or unknown US equity ticker"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"tags":["SEC Fundamentals","Stock Fundamentals","Financial Statements"],"x-mcp-tool":"get_fundamental_intelligence"}},"/api/v1/intelligence/pre-trade":{"get":{"operationId":"preTradeCheck","summary":"Check whether now is a good moment to buy or sell","description":"Use right before placing a trade: \"I want to buy (or sell) SYMBOL - is now a good moment?\". Returns a verdict (FAVORABLE, CAUTION, UNFAVORABLE) with a 0-100 score and the checks behind it: order flow, momentum, volatility, adverse market events, market regime, and news or material SEC filings from the last 24h. Works for crypto (ETHUSD, BTCUSD, ...) and tokenized US equities (NVDA, TSLA, SPY, ...), 24/7. Includes on-chain slippage of a $1k/$10k/$50k order and a liquidity score.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","example":"ETHUSD"},"description":"Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA."},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"],"default":"buy"},"description":"Intended trade direction.","example":"buy"},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Verdict, score, checks and market snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"side":{"type":"string"},"verdict":{"type":"string","enum":["FAVORABLE","CAUTION","UNFAVORABLE"]},"score":{"type":"number"},"checks":{"type":"array","items":{"type":"object"}},"snapshot":{"type":"object"},"timestamp":{"type":"string","format":"date-time"},"liquidity":{"type":"object","description":"On-chain liquidity: cost of a market order as one swap in the best pool, fee included (Uniswap v3/v4 pool math from swap events). Sizes whose price move would exceed 1% are null with a reason.","properties":{"method":{"type":"string"},"as_of":{"type":["string","null"],"format":"date-time"},"liquidity_score":{"type":["integer","null"],"minimum":0,"maximum":100,"description":"100*exp(-bps/50) of the average $10k buy/sell cost"},"slippage_bps":{"type":["object","null"],"properties":{"buy":{"type":"object","additionalProperties":{"type":["number","null"]}},"sell":{"type":"object","additionalProperties":{"type":["number","null"]}}},"description":"Keys are USD sizes: 1000, 10000, 50000"},"estimates":{"type":"array","items":{"type":"object"}},"pools":{"type":"array","items":{"type":"object"}}}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"as_of":{"type":["string","null"],"format":"date-time"}}}},"as_of":{"type":["string","null"],"format":"date-time"},"window":{"type":"string","enum":["1m","5m","15m","1h","4h","24h"],"description":"Signal window the verdict is based on."},"reasons":{"type":"array","items":{"type":"string"},"description":"Plain-language reasons behind the verdict."},"disclaimer":{"type":"string","description":"Not investment advice: a data-based check, not a recommendation."}}},"example":{"symbol":"ETHUSD","side":"BUY","window":"5m","verdict":"CAUTION","score":80,"reasons":["Unusual activity (anomaly 74/100): expect wider moves","Market regime is BEARISH"],"checks":[{"check":"order_flow","detail":"Buy pressure is 61.3% of aggressor volume","status":"PASS"}],"snapshot":{"price":2668.42,"signal":"BUYING_ACTIVITY","buyPressure":61.3,"momentumScore":64.2},"disclaimer":"Informational market signal derived from observed trade flow; not investment advice."}}}},"400":{"description":"Invalid symbol or side (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No recent data for this symbol (not charged). The body lists the covered symbols.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"pre_trade_check"}},"/api/v1/intelligence/equities":{"get":{"operationId":"getTokenizedEquities","summary":"Get 24/7 trade flow of tokenized US stocks","description":"Use to read US stock sentiment around the clock, including nights and weekends when exchanges are closed. Returns 24/7 trade flow of tokenized US equities and ETFs (NVDA, AAPL, TSLA, SPY, ...) traded on public blockchains, labelled with the current US market session, with breadth, average buy pressure and per-asset signals. Prices are on-chain trade prices, not official exchange quotes.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"maximum":100},"description":"Maximum number of results to return","example":20}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Session, breadth and per-asset flow","content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"usMarketSession":{"type":"string"},"usMarketOpen":{"type":"boolean"},"interpretation":{"type":"string"},"symbolsCovered":{"type":"integer"},"averageBuyPressure":{"type":"number"},"advancers":{"type":"integer"},"decliners":{"type":"integer"},"assets":{"type":"array","items":{"type":"object","properties":{"signal":{"type":"string"},"price":{"type":"number"},"priceChangePercent":{"type":"number"},"symbol":{"type":"string"},"buyPressure":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"window":"5m","usMarketSession":"OVERNIGHT","usMarketOpen":false,"interpretation":"US exchanges are closed: tokenized equity flow reflects overnight sentiment ahead of the next regular session.","symbolsCovered":19,"averageBuyPressure":56.2,"advancers":11,"decliners":6,"assets":[{"signal":"BUYING_ACTIVITY","price":225.43,"priceChangePercent":0.35,"symbol":"NVDA","buyPressure":63.1}]}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_tokenized_equities"}},"/api/v1/intelligence/token/{address}":{"get":{"operationId":"analyzeToken","summary":"Analyze last-hour DEX trade flow of any ERC-20 token","description":"Send any token contract address (Base by default; chain=ethereum, arbitrum, optimism or polygon), get its live DEX trade flow for the last hour: swaps, buy and sell volume in USD, buy pressure, price change, largest trade, trader concentration and a verdict (ACCUMULATION, DISTRIBUTION, BALANCED, ILLIQUID_OR_INACTIVE, NO_POOL). Read live from the chain; repeat requests within 45 s share one read (see timestamp). Ethereum reads the last ~12 minutes (the public RPC serves only recent logs); window.approxMinutes says which span was read.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"Any ERC-20 contract address (0x...) on the chain given by ?chain (base, ethereum, arbitrum, optimism or polygon).","example":"0x940181a94a35a4569e4529a3cdfb74e38fd98631"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"],"default":"base"},"description":"Chain the token lives on: base, ethereum, arbitrum, optimism or polygon. Not the payment network: payment networks are in x-payment-info.networks.","example":"base"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Token info, flow, price, pools and verdict","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"token":{"type":"string"},"tokenInfo":{"type":"object","properties":{"decimals":{"type":"integer"},"symbol":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"window":{"type":"object","properties":{"approxMinutes":{"type":"integer"}},"additionalProperties":true},"flow":{"type":"object","properties":{"uniqueRecipients":{"type":"integer"},"trades":{"type":"integer"},"largestTradeUsd":{"type":"number"},"top5RecipientSharePercent":{"type":"number"},"sellVolumeUsd":{"type":"number"},"buyPressure":{"type":"number"},"buyVolumeUsd":{"type":"number"}},"additionalProperties":true},"price":{"type":"object","properties":{"changePercent":{"type":"number"},"lastUsd":{"type":"number"},"firstUsd":{"type":"number"}},"additionalProperties":true},"verdict":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chain":"base","token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","tokenInfo":{"decimals":18,"symbol":"AERO","name":"Aerodrome"},"window":{"approxMinutes":60},"flow":{"uniqueRecipients":97,"trades":214,"largestTradeUsd":24500.0,"top5RecipientSharePercent":38.4,"sellVolumeUsd":121007.2,"buyPressure":60.1,"buyVolumeUsd":182340.5},"price":{"changePercent":2.27,"lastUsd":0.8612,"firstUsd":0.8421},"verdict":"ACCUMULATION","reasons":["Buyers took 60% of swap volume and price rose 2.27%"]}}}},"400":{"description":"Not a token address or unsupported chain (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"analyze_token"}},"/api/v1/intelligence/candles/{symbol}":{"get":{"operationId":"getCandles","summary":"Get OHLCV candles with buy and sell volume split","description":"Send a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...), get OHLCV candles (1m, 5m, 15m or 1h) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count per candle, from on-chain trade flow. A free 15-minute delayed sample is at /api/v1/preview.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","example":"ETHUSD"},"description":"Any covered symbol, not only the example: crypto pairs (ETHUSD) and tokenized US stocks (NVDA); free list at /coverage. Unknown: 404, not charged.","example":"ETHUSD"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m","1h"],"default":"1m"},"description":"Candle interval, e.g. 1m, 5m, 15m or 1h","example":"1m"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":60,"maximum":500},"description":"Maximum number of results to return","example":60}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Candles","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"interval":{"type":"string"},"count":{"type":"integer"},"candles":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string","format":"date-time"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"volumeUsd":{"type":"number"},"buyVolume":{"type":"number"},"sellVolume":{"type":"number"},"buyPressure":{"type":["number","null"]},"vwap":{"type":["number","null"]},"trades":{"type":"integer"}}}}}},"example":{"symbol":"NVDA","count":1,"candles":[{"time":"2026-09-23T19:30:00Z","open":225.1,"high":225.9,"low":224.8,"close":225.6,"volume":41.2,"volumeUsd":9287.4,"buyVolume":27.9,"sellVolume":13.3,"buyPressure":67.72,"trades":18}],"interval":"5m"}}}},"400":{"description":"Invalid symbol or interval (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No recent data for this symbol (not charged). The body lists the covered symbols.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_candles"}},"/api/v1/preview":{"get":{"operationId":"getFreePreview","summary":"Get 15-minute delayed sample candles for ETH or BTC","description":"Free, 15-minute delayed, truncated sample of the paid candle data (last 6 closed 5m candles: close, volumeUsd, buyPressure) for a few symbols, so an agent can check data quality before paying. Links to the matching paid endpoints are included.","tags":["Free"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","enum":["ETHUSD","BTCUSD","TSLA"],"default":"ETHUSD"},"description":"Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA, XAUUSD","example":"ETHUSD"}],"responses":{"200":{"description":"Delayed sample","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Symbol not in the preview set"}},"security":[],"x-mcp-tool":"get_market_preview"}},"/status":{"get":{"operationId":"getStatus","summary":"Report data freshness per chain and data source","description":"Free freshness report: per-chain ingestion state (last successful poll, last ingested block, last trade, error counts), time of the latest trade, and per-source fetch state for news and filings. Use it to verify the data is live before paying.","tags":["Free"],"responses":{"200":{"description":"Freshness report","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"security":[],"x-mcp-tool":"get_service_status"}},"/transparency":{"get":{"operationId":"getTransparency","summary":"Get the operator, data sources and billing policy","description":"Who runs the service, where the data comes from, current prices per route, and the billing policy (settled only after a successful 2xx answer).","tags":["Free"],"responses":{"200":{"description":"Disclosure","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"security":[],"x-mcp-tool":"get_transparency"}},"/.well-known/x402-resources":{"get":{"operationId":"getX402Resources","summary":"List every paid resource in x402 manifest form","description":"Paid resources in the x402scan manifest form. Also served at /x402-resources.","tags":["Free"],"responses":{"200":{"description":"Resource list","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"security":[]}},"/.well-known/security.txt":{"get":{"operationId":"getSecurityTxt","summary":"Get the RFC 9116 security contact file","tags":["Free"],"responses":{"200":{"description":"security.txt","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"security":[]}},"/api/v1/intelligence/query":{"get":{"operationId":"queryHistoricalIntelligence","summary":"Get several signals for several assets over time","description":"Use when an agent needs several signals for several symbols over a historical time range in one paid call. Returns momentum, activity, buying, selling, anomaly and regime per symbol for any from/to range; the data resolution (1m, 5m, 15m or 1h) is chosen automatically.","tags":["Market Intelligence"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string","example":"BTCUSD,ETHUSD"},"description":"Comma-separated symbols, up to 20."},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"ISO-8601 UTC start.","example":"2026-09-29T00:00:00Z"},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"ISO-8601 UTC end, after from.","example":"2026-09-29T06:00:00Z"},{"name":"signals","in":"query","required":false,"schema":{"type":"string","example":"momentum,activity,buying,selling,anomaly,regime"},"description":"Subset of signals; all when omitted."}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"responses":{"200":{"description":"Window, resolution, source and one result per symbol","content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":true},"data":{"type":"array","items":{"type":"object","properties":{"momentum":{"type":"object","properties":{"score":{"type":"number"},"signal":{"type":"string"},"priceChangePercent":{"type":"number"}},"additionalProperties":true},"symbol":{"type":"string"},"buying":{"type":"object","properties":{"buyPressure":{"type":"number"},"sideDataAvailable":{"type":"boolean"},"dominantSide":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}},"resolution":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"window":{"to":"2026-09-23T13:00:00Z","from":"2026-09-23T12:00:00Z"},"data":[{"momentum":{"score":57.3,"signal":"NEUTRAL","priceChangePercent":0.31},"symbol":"BTCUSD","buying":{"buyPressure":54.2,"sideDataAvailable":true,"dominantSide":"BALANCED"}}],"resolution":"1m"}}}},"400":{"description":"Invalid symbols or time range (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"query_signal_history"}},"/api/v1/intelligence/token-risk/{address}":{"get":{"operationId":"checkTokenRisk","summary":"Check a token for honeypot, admin and holder risks","description":"Use before buying any token: ERC-20 on Base (default), Ethereum, Arbitrum, Optimism or Polygon, or any SPL/Token-2022 mint on Solana (chain=solana; a base58 address is detected automatically). Simulates a sell by a real recent buyer and a buy from the main pool with eth_call (honeypot check), reads the owner and EIP-1967 proxy, scans the bytecode for mint, blacklist, pause, fee, limit and trading-switch functions, measures liquidity in Uniswap v2/v3 and Aerodrome pools, the share of burned LP tokens and the buy tax observed in recent buys, adds the last hour of trade flow, and returns a verdict (LOW_RISK, CAUTION, HIGH_RISK) with a 0-100 safety score and every check (PASS, WARN, FAIL, UNKNOWN, INFO). Automated checks, not an audit. Cached 120 s. On Solana: mint and freeze authority, Token-2022 extensions (transfer fee, permanent delegate, transfer hook, default-frozen accounts, pause), metadata name and symbol, and the share of the 10 largest wallets with pools and vaults (program-derived owners) counted apart; sell simulation and pool liquidity are not checked there (listed in notChecked). Uniswap v4 pools created while the new-token watcher runs (Base, Ethereum) are included: in-range depth from StateView, simulations through the PoolManager and the hook's swap powers.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$"},"description":"Any ERC-20 contract address (0x...) on the chain given by ?chain, or a Solana token mint (base58) with chain=solana.","example":"0x940181a94a35a4569e4529a3cdfb74e38fd98631"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","solana"],"default":"base"},"description":"Chain the token lives on: base, ethereum, arbitrum, optimism, polygon or solana. Not the payment network: payment networks are in x-payment-info.networks.","example":"base"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Verdict, safety score, checks, contract, liquidity, simulation and trade flow","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"token":{"type":"string"},"tokenInfo":{"type":"object","properties":{"decimals":{"type":"integer"},"symbol":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"verdict":{"type":"string"},"safetyScore":{"type":"integer"},"reasons":{"type":"array","items":{"type":"string"}},"checks":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string"},"detail":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true}},"contract":{"type":"object","properties":{"upgradeable":{"type":"boolean"},"adminFunctions":{"type":"array","items":{"type":"string"}},"proxy":{"type":"boolean"}},"additionalProperties":true},"liquidity":{"type":"object","properties":{"lpBurnedPercent":{"type":"number"},"totalUsd":{"type":"number"}},"additionalProperties":true},"simulation":{"type":"object","properties":{"buy":{"type":"string"},"observedBuyTaxPercent":{"type":"number"},"sell":{"type":"string"}},"additionalProperties":true},"tradeFlow":{"type":"object","properties":{"verdict":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chain":"base","token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","tokenInfo":{"decimals":18,"symbol":"AERO","name":"Aerodrome"},"verdict":"LOW_RISK","safetyScore":90,"reasons":["Code contains a function by which new supply can be minted; no owner() found"],"checks":[{"check":"sell_simulation","detail":"A recent buyer's transfer of half their balance into the pool (a sale) succeeds","status":"PASS"},{"check":"liquidity","detail":"$41817539 of liquidity across 12 pools","status":"PASS"}],"contract":{"upgradeable":false,"adminFunctions":["MINT"],"proxy":false},"liquidity":{"lpBurnedPercent":0.0,"totalUsd":4.181753885E7},"simulation":{"buy":"OK","observedBuyTaxPercent":0.0,"sell":"OK"},"tradeFlow":{"verdict":"BALANCED"}}}}},"400":{"description":"Not a token address or unsupported chain (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"check_token_risk"}},"/api/v1/intelligence/token-verdict/{address}":{"get":{"operationId":"getTokenVerdict","summary":"Is this token safe to buy? Short verdict with honeypot check","description":"Use when the user asks \"is this token safe?\", \"is it a rug or a honeypot?\", \"check this CA\" or \"can I sell it?\". Use before buying a token for a short answer: the same on-chain checks as /api/v1/intelligence/token-risk (simulated sell and buy, owner and proxy, mint/blacklist/pause/fee functions, liquidity, observed buy tax; on Solana mint and freeze authority, Token-2022 traps and top-wallet share) reduced to a verdict (LOW_RISK, CAUTION, HIGH_RISK), a 0-100 safety score, one plain-language sentence (summary), canSell (YES, NO, UNKNOWN, NOT_CHECKED), buyTaxPercent, liquidityUsd, ownerControl (ACTIVE, RENOUNCED, NO_OWNER_FOUND), the three biggest risks and up to three passed checks. fullReport links the detailed report. Rule-based, no language model. Cached 120 s. Automated checks, not an audit. The answer includes share.pageUrl and share.imageUrl: a public page and a 1200x630 PNG card of this verdict to link when you show it. oneLiner is one short line to quote or post with the verdict.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$"},"description":"Any ERC-20 contract address (0x...) on the chain given by ?chain, or a Solana token mint (base58) with chain=solana.","example":"0x940181a94a35a4569e4529a3cdfb74e38fd98631"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","solana"],"default":"base"},"description":"Chain the token lives on: base, ethereum, arbitrum, optimism, polygon or solana. Not the payment network: payment networks are in x-payment-info.networks.","example":"base"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Verdict, safety score, summary sentence, sellability, tax, liquidity, owner control, top risks","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"verdict":{"type":"string"},"safetyScore":{"type":"integer"},"summary":{"type":"string"},"oneLiner":{"type":"string"},"canSell":{"type":"string"},"buyTaxPercent":{"type":"number"},"liquidityUsd":{"type":"number"},"ownerControl":{"type":"string"},"upgradeable":{"type":"boolean"},"adminFunctions":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"positives":{"type":"array","items":{"type":"string"}},"fullReport":{"type":"string"},"share":{"type":"object","properties":{"pageUrl":{"type":"string"},"imageUrl":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","chain":"base","symbol":"AERO","name":"Aerodrome","verdict":"LOW_RISK","safetyScore":90,"summary":"AERO on Base looks low-risk: a simulated sale succeeds, no buy tax was seen, $41.8M of liquidity backs it.","oneLiner":"Sells cleanly, no buy tax, $41.8M deep: the boring kind of token.","canSell":"YES","buyTaxPercent":0.0,"liquidityUsd":4.181753885E7,"ownerControl":"NO_OWNER_FOUND","upgradeable":false,"adminFunctions":["MINT"],"risks":["Code contains a function by which new supply can be minted; no owner() found"],"positives":["A recent buyer's transfer of half their balance into the pool (a sale) succeeds"],"fullReport":"/api/v1/intelligence/token-risk/0x940181a94a35a4569e4529a3cdfb74e38fd98631?chain=base","share":{"pageUrl":"https://api.marketintelligenceapi.com/v/abc23defgh","imageUrl":"https://api.marketintelligenceapi.com/v/abc23defgh/card.png"}}}}},"400":{"description":"Not a token address or unsupported chain (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"get_token_verdict"}},"/api/v1/intelligence/token-traders/{address}":{"get":{"operationId":"getTokenTraders","summary":"Who bought and who sold a token: top wallets of the last hour","description":"Top buyers and sellers of any ERC-20 token in the last hour (Ethereum ~12 minutes, Polygon and Arbitrum ~30): its swaps against USDC and WETH on Uniswap v2/v3/v4, PancakeSwap v3, Aerodrome and Aerodrome Slipstream, the 150 largest transactions attributed to the address that signed them (a pool's swap recipient is often a router), netted per wallet. Each wallet: netUsd, boughtUsd, soldUsd, buys, sells, label from its record in the pools this API tracks (SMART_MONEY, PROFITABLE, UNPROFITABLE, INSUFFICIENT_HISTORY, UNTRACKED) and automated (more than 10 swaps in the window). summary: whaleVerdict (WHALES_ACCUMULATING, WHALES_DISTRIBUTING, WHALES_MIXED) with whalesNetUsd and verdictReason, volume with buy and sell volume, price and its change, transactions, attributedTransactions, attributedVolumePercent, averageUnattributedTxUsd (the small transactions left, mostly bots), attributedWallets, net buyers and sellers, top10BuyersSharePercent, smartMoneyNetUsd and the flow verdict of all swaps; venues: volume per DEX. A token without swaps in the window is a free 404; the 402 carries a free preview (swaps in the window, venues). Pairs against other tokens are not read.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"ERC-20 contract address (0x...) on the chain given by ?chain.","example":"0x940181a94a35a4569e4529a3cdfb74e38fd98631"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"],"default":"base"},"description":"Chain the token lives on. Not the payment network.","example":"base"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Wallets per side (buyers and sellers)."}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Top buyers and sellers with labels and a summary","content":{"application/json":{"schema":{"type":"object","properties":{"topSellers":{"type":"array"},"summary":{"type":"object","properties":{"whaleVerdict":{"type":"string"},"whalesNetUsd":{"type":"number"},"volumeUsd":{"type":"number"},"buyVolumeUsd":{"type":"number"},"sellVolumeUsd":{"type":"number"},"priceUsd":{"type":"number"},"priceChangePercent":{"type":"number"},"transactions":{"type":"integer"},"attributedTransactions":{"type":"integer"},"attributedVolumePercent":{"type":"number"},"averageUnattributedTxUsd":{"type":"number"},"attributedWallets":{"type":"integer"},"netBuyers":{"type":"integer"},"netSellers":{"type":"integer"},"top10BuyersSharePercent":{"type":"number"},"smartMoneyNetUsd":{"type":"number"},"flowVerdict":{"type":"string"},"verdictReason":{"type":"string"}},"additionalProperties":true},"topBuyers":{"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string"},"netUsd":{"type":"number"},"boughtUsd":{"type":"number"},"soldUsd":{"type":"number"},"buys":{"type":"integer"},"sells":{"type":"integer"},"label":{"type":"string"},"automated":{"type":"boolean"}},"additionalProperties":true}},"token":{"type":"string"},"chain":{"type":"string"},"venues":{"type":"object","properties":{"aerodrome_slipstream":{"type":"number"},"uniswap_v3":{"type":"number"},"pancakeswap_v3":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"topSellers":[],"summary":{"whaleVerdict":"WHALES_ACCUMULATING","whalesNetUsd":31870.4,"volumeUsd":412390.2,"buyVolumeUsd":231004.7,"sellVolumeUsd":181385.5,"priceUsd":0.812345,"priceChangePercent":2.4,"transactions":1204,"attributedTransactions":80,"attributedVolumePercent":58.2,"averageUnattributedTxUsd":153.8,"attributedWallets":61,"netBuyers":34,"netSellers":27,"top10BuyersSharePercent":41.3,"smartMoneyNetUsd":18420.5,"flowVerdict":"ACCUMULATION","verdictReason":"The 61 largest wallets (34 net buyers, 27 net sellers) bought a net $31870 of $240011 they traded; flowVerdict ACCUMULATION is the buy/sell split of all swaps."},"topBuyers":[{"wallet":"0x3f5c...9a1e","netUsd":18420.5,"boughtUsd":18420.5,"soldUsd":0.0,"buys":3,"sells":0,"label":"SMART_MONEY","automated":false}],"token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","chain":"base","venues":{"aerodrome_slipstream":268053.6,"uniswap_v3":103097.6,"pancakeswap_v3":41239.0}}}}},"400":{"description":"Not a token address or unsupported chain (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No swaps in the window (not charged)"}},"x-mcp-tool":"get_token_traders"}},"/api/v1/intelligence/token-price/{address}":{"get":{"operationId":"getTokenPrice","summary":"Token price by contract address, live from the chain","description":"USD price of any ERC-20 token on Base (default), Ethereum, Arbitrum, Optimism or Polygon, read from the chain: a simulated $100 USDC buy on the best route (Uniswap v2/v3/v4, Aerodrome, direct or through WETH) and the simulated sale of the tokens it returns, both with eth_call at the latest block. priceUsd is the geometric mean of buyPriceUsd and sellPriceUsd, so pool fees cancel; roundTripCostPercent is the loss of that $100 round trip (fees, spread, impact, any transfer tax) and works as a liquidity gauge; canSellBack is false when the sale finds no route. totalSupply and fullyDilutedValueUsd (supply x price) come from the token contract. Works for tokens too new for price APIs. A token no route can price is a free 404. Cached 15 s.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"ERC-20 contract address (0x...) on the chain given by ?chain.","example":"0x940181a94a35a4569e4529a3cdfb74e38fd98631"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"],"default":"base"},"description":"Chain the token lives on. Not the payment network.","example":"base"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Price, buy and sell price, round-trip cost, supply and FDV","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"priceUsd":{"type":"number"},"buyPriceUsd":{"type":"number"},"sellPriceUsd":{"type":"number"},"roundTripCostPercent":{"type":"number"},"canSellBack":{"type":"boolean"},"totalSupply":{"type":"number"},"fullyDilutedValueUsd":{"type":"integer"},"route":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chain":"base","token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","symbol":"AERO","decimals":18,"priceUsd":0.812345,"buyPriceUsd":0.813564,"sellPriceUsd":0.811128,"roundTripCostPercent":0.3,"canSellBack":true,"totalSupply":1.76E9,"fullyDilutedValueUsd":1429727200,"route":"aerodrome"}}}},"400":{"description":"Not a token address, USDC itself, or unsupported chain (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No on-chain route prices this token (not charged)"}},"x-mcp-tool":"get_token_price"}},"/api/v1/intelligence/premium":{"get":{"operationId":"getTokenizedStockPremium","summary":"Compare tokenized stock prices on EVM and Solana pools","description":"Latest premium in basis points of the same tokenized US stock between the main on-chain pools (Robinhood Chain and EVM DEX) and Solana xStocks pools (Raydium, Orca, Meteora): volume-weighted prices of the last 15-minute bin with trades on both venues within the hour, both 1-hour volumes and the US market session. Sorted by absolute premium. Neither venue is a licensed NYSE/NASDAQ price.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated tickers, e.g. NVDA,TSLA; all paired stocks when omitted.","example":"ETHUSD,BTCUSD,NVDA"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Premiums per symbol","content":{"application/json":{"schema":{"type":"object","properties":{"usMarketSession":{"type":"string"},"interval":{"type":"string"},"symbolsCompared":{"type":"integer"},"averageAbsPremiumBps":{"type":"number"},"premiums":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"time":{"type":"string"},"usMarketSession":{"type":"string"},"mainVwap":{"type":"number"},"solanaVwap":{"type":"number"},"premiumBps":{"type":"number"},"premiumPercent":{"type":"number"},"mainVolumeUsd1h":{"type":"number"},"solanaVolumeUsd1h":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"usMarketSession":"AFTER_HOURS","interval":"15m","symbolsCompared":9,"averageAbsPremiumBps":14.2,"premiums":[{"symbol":"NVDA","time":"2026-09-23T19:15:00Z","usMarketSession":"AFTER_HOURS","mainVwap":181.42,"solanaVwap":181.05,"premiumBps":20.4,"premiumPercent":0.2,"mainVolumeUsd1h":48210.5,"solanaVolumeUsd1h":22904.1}]}}}},"400":{"description":"Invalid symbols (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No symbol traded on both venues in the last hour (not charged). The body lists the covered symbols where relevant.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_tokenized_stock_premium"}},"/api/v1/intelligence/premium/{symbol}":{"get":{"operationId":"getTokenizedStockPremiumHistory","summary":"Get the price premium history of one tokenized stock","description":"Premium history of one tokenized US stock between Robinhood Chain/EVM pools and Solana xStocks pools: one point per 15m or 1h bin with trades on both venues, plus average, median, min, max and statistics per US market session (WEEKEND, OVERNIGHT, PRE_MARKET, REGULAR, AFTER_HOURS).","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any tokenized US stock traded on both EVM and Solana pools (NVDA, TSLA, SPY...); free list at /coverage. Unknown: 404, not charged.","example":"NVDA"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":720,"default":24},"description":"Look-back period in hours","example":24},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["15m","1h"],"default":"15m"},"description":"Candle interval, e.g. 1m, 5m, 15m or 1h","example":"15m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Statistics, per-session statistics and points","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"hours":{"type":"integer"},"interval":{"type":"string"},"statistics":{"type":"object","properties":{"currentBps":{"type":"number"},"maxBps":{"type":"number"},"minBps":{"type":"number"},"bins":{"type":"integer"},"medianBps":{"type":"number"},"averageBps":{"type":"number"}},"additionalProperties":true},"bySession":{"type":"object","properties":{"REGULAR":{"type":"object","properties":{"bins":{"type":"integer"},"averageBps":{"type":"number"}},"additionalProperties":true},"WEEKEND":{"type":"object","properties":{"bins":{"type":"integer"},"averageBps":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"usMarketSession":{"type":"string"},"mainVwap":{"type":"number"},"solanaVwap":{"type":"number"},"premiumBps":{"type":"number"},"premiumPercent":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"NVDA","hours":24,"interval":"15m","statistics":{"currentBps":20.4,"maxBps":44.0,"minBps":-31.2,"bins":88,"medianBps":4.8,"averageBps":6.1},"bySession":{"REGULAR":{"bins":20,"averageBps":1.9},"WEEKEND":{"bins":30,"averageBps":12.3}},"points":[{"time":"2026-09-23T19:15:00Z","usMarketSession":"AFTER_HOURS","mainVwap":181.42,"solanaVwap":181.05,"premiumBps":20.4,"premiumPercent":0.2}]}}}},"400":{"description":"Invalid symbol or interval (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No bin with trades on both venues (not charged). The body lists the covered symbols where relevant.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_tokenized_stock_premium"}},"/api/v1/datasets":{"get":{"operationId":"listDatasets","summary":"List the downloadable daily trade-flow datasets","description":"Which symbols, venues, dates and resolutions can be bought as datasets. Free.","tags":["Free"],"security":[],"responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"list_datasets"}},"/api/v1/datasets/{symbol}":{"get":{"operationId":"getDataset","summary":"Download one UTC day of trade-flow candles per venue","description":"One UTC day of candles for a symbol, separately per venue (onchain_dex: Uniswap and Aerodrome pools on Base, Ethereum, Arbitrum, Optimism, Polygon and Robinhood Chain; solana_dex: tokenized stocks on Solana): OHLCV, aggressor buy and sell volume, buy pressure, VWAP and trade count. 1-minute data is kept 7 days, then 5m (30 days), 15m (180 days) and 1h; a finer interval than stored returns the stored resolution. format=csv returns a CSV file.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any covered symbol; the live and quiet lists with buyable dates are free at /api/v1/datasets. Unknown: 404, not charged.","example":"ETHUSD"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"UTC day (YYYY-MM-DD); yesterday when omitted."},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m","1h"],"default":"1m"},"description":"Candle interval, e.g. 1m, 5m, 15m or 1h","example":"1m"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"Response format: json or csv","example":"json"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Dataset","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"date":{"type":"string"},"interval":{"type":"string"},"venues":{"type":"array","items":{"type":"string"}},"rows":{"type":"integer"},"candles":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"venue":{"type":"string"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"volumeUsd":{"type":"number"},"buyVolume":{"type":"number"},"sellVolume":{"type":"number"},"buyPressure":{"type":"number"},"vwap":{"type":"number"},"trades":{"type":"integer"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"ETHUSD","date":"2026-09-23","interval":"1m","venues":["onchain_dex"],"rows":1440,"candles":[{"time":"2026-09-23T00:00:00Z","venue":"onchain_dex","open":2668.1,"high":2669.4,"low":2667.8,"close":2669.0,"volume":12.4,"volumeUsd":33093.6,"buyVolume":7.9,"sellVolume":4.5,"buyPressure":63.71,"vwap":2668.8,"trades":41}]}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Invalid symbol, date, interval or format (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No trades for the symbol on that day (not charged). The body lists the covered symbols where relevant.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_dataset"}},"/api/v1/insiders/{symbol}":{"get":{"operationId":"getInsiderTrades","summary":"Get insider buying and selling from SEC Form 4","description":"Insider transactions of a US-listed company from SEC Form 4 filings of the last days (1-365, the latest 40 filings are analyzed): open-market purchases and sales with value in USD, sales under 10b5-1 plans, grants, option exercises and tax withholding, per-insider totals, the latest 50 transactions with filing links, and a signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING, NO_OPEN_MARKET_ACTIVITY).","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged.","example":"AAPL"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365,"default":90},"description":"Look-back period in days","example":90}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Signal, summary, insiders and transactions","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"companyName":{"type":"string"},"periodDays":{"type":"integer"},"filingsInPeriod":{"type":"integer"},"signal":{"type":"string"},"interpretation":{"type":"string"},"summary":{"type":"object","properties":{"netValueUsd":{"type":"number"},"openMarketSales":{"type":"object","properties":{"transactions":{"type":"integer"},"valueUsd":{"type":"number"},"insiders":{"type":"integer"}},"additionalProperties":true},"openMarketBuys":{"type":"object","properties":{"valueUsd":{"type":"number"},"transactions":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true},"transactions":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"type":{"type":"string"},"under10b5Plan":{"type":"boolean"},"valueUsd":{"type":"number"},"pricePerShare":{"type":"number"},"insider":{"type":"string"},"shares":{"type":"number"},"date":{"type":"string"},"code":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"TSLA","companyName":"Tesla, Inc.","periodDays":90,"filingsInPeriod":6,"signal":"NET_SELLING","interpretation":"2 insider(s) sold on the open market and none bought.","summary":{"netValueUsd":-3412880.5,"openMarketSales":{"transactions":4,"valueUsd":3412880.5,"insiders":2},"openMarketBuys":{"valueUsd":0.0,"transactions":0}},"transactions":[{"role":"Chief Financial Officer","type":"OPEN_MARKET_SALE","under10b5Plan":false,"valueUsd":938414.2,"pricePerShare":360.134,"insider":"Taneja Vaibhav","shares":2605.75,"date":"2026-09-08","code":"S"}]}}}},"400":{"description":"Unknown ticker (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No Form 4 filings in the period (not charged). The body lists the covered symbols where relevant.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_insider_trades"}},"/api/v1/insiders/batch":{"get":{"operationId":"getInsiderTradesBatch","summary":"Insider trades for up to 10 tickers","description":"SEC Form 4 insider trades for up to 10 US-listed companies in one call: per ticker the open-market purchases and sales, 10b5-1 plan share, per-insider totals, recent transactions and a signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING, NO_OPEN_MARKET_ACTIVITY). Tickers that fail are listed under errors; the call is charged when at least one ticker has data.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated US tickers, at most 10, e.g. AAPL,MSFT,NVDA","example":"AAPL,MSFT,NVDA"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365,"default":90},"description":"Look-back period in days","example":90}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.06"}},"responses":{"200":{"description":"results by ticker, errors by ticker","content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"}},"results":{"type":"object","properties":{"TSLA":{"type":"object","properties":{"signal":{"type":"string"}},"additionalProperties":true},"NVDA":{"type":"object","properties":{"signal":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbols":["TSLA","NVDA"],"results":{"TSLA":{"signal":"NET_SELLING"},"NVDA":{"signal":"PLANNED_SELLING"}}}}}},"400":{"description":"Invalid symbol or query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No ticker had data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_insider_trades_batch"}},"/api/v1/fundamentals/batch":{"get":{"operationId":"getFundamentalsBatch","summary":"Fundamentals for up to 10 tickers","description":"SEC EDGAR fundamentals for up to 10 US-listed companies in one call: per ticker revenue, net and operating income, EPS, assets, equity, cash and debt from the latest filings, derived growth, margins and returns, and a fundamental signal and score. Tickers that fail are listed under errors; the call is charged when at least one ticker has data.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated US tickers, at most 10, e.g. AAPL,MSFT,NVDA","example":"AAPL,MSFT,NVDA"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"results by ticker, errors by ticker","content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"}},"results":{"type":"object","properties":{"AAPL":{"type":"object","properties":{"companyName":{"type":"string"},"derivedIntelligence":{"type":"object","properties":{"revenueGrowthYoYPercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbols":["AAPL","MSFT"],"results":{"AAPL":{"companyName":"Apple Inc.","derivedIntelligence":{"revenueGrowthYoYPercent":16.4}}}}}}},"400":{"description":"Invalid symbol or query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No ticker had data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_fundamentals_batch"}},"/api/v1/earnings/{symbol}":{"get":{"operationId":"getEarnings","summary":"Earnings date and last quarters","description":"Earnings of a US-listed company from SEC EDGAR: past earnings releases (8-K Item 2.02), the next expected date projected from their spacing (the company confirms it), the last five quarters of revenue and diluted EPS with year-over-year growth, and vsTrend: whether the latest revenue growth is ACCELERATING, IN_LINE or DECELERATING against the company's previous quarters. No analyst estimates are used.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged.","example":"AAPL"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"schedule, quarters and vsTrend","content":{"application/json":{"schema":{"type":"object","properties":{"vsTrend":{"type":"object","properties":{"revenue":{"type":"string"},"latestGrowthPercent":{"type":"number"}},"additionalProperties":true},"symbol":{"type":"string"},"schedule":{"type":"object","properties":{"daysUntil":{"type":"integer"},"nextExpected":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"vsTrend":{"revenue":"ACCELERATING","latestGrowthPercent":16.4},"symbol":"AAPL","schedule":{"daysUntil":30,"nextExpected":"2026-10-30"}}}}},"400":{"description":"Invalid symbol or query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not a US-listed SEC filer (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_earnings"}},"/api/v1/explain/{symbol}":{"get":{"operationId":"explainMove","summary":"Why is a crypto asset or stock moving","description":"Why a crypto, tokenized-stock or US-stock symbol is moving: the price move over 15 minutes from the on-chain flow and its likely drivers from every source the API has (on-chain order flow, unusual activity, the most profitable wallets, perp crowding and open interest, news of the last 48 hours, SEC filings of the last two days, insider trades), each with a direction (bullish, bearish, neutral) and a weight 0-1, a net direction and a one-sentence summary naming the strongest drivers. Rule-based, no language model; sources without data are listed as unavailable. Any ERC-20 works too: its contract address (?chain=base by default) or the symbol of a token analysed here (ICNT, also written ICNTUSDT), explained from its last hour of swaps on Uniswap, PancakeSwap and Aerodrome and its news.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any crypto pair or US ticker covered by at least one source: on-chain (/coverage) or SEC filings. Unknown: 404, not charged.","example":"NVDA"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"move, summary, netDirection, drivers","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"summary":{"type":"string"},"drivers":{"type":"array","items":{"type":"object","properties":{"direction":{"type":"string"},"factor":{"type":"string"},"weight":{"type":"number"}},"additionalProperties":true}},"netDirection":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"NVDA","summary":"NVDA is up 1.8% over 15 minutes. Main drivers: news (bullish: ...); on-chain order flow (bullish: 71% buying)","drivers":[{"direction":"bullish","factor":"news","weight":0.64}],"netDirection":"bullish"}}}},"400":{"description":"Invalid symbol or query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No source has data for the symbol (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"explain_move"}},"/track-record":{"get":{"operationId":"getPublicTrackRecord","summary":"Summarize the live hit rate of the published signals","description":"Hit rate (price moved in the signal's direction) of the 5m signals after 5m, 15m, 1h and 24h over the last 7, 30 and 90 days, calibration by confidence bucket, and an interim walk-forward backtest since the start of on-chain data (labelled as a backtest, not a live record). Free.","tags":["Free"],"security":[],"responses":{"200":{"description":"Track record","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_signal_track_record_summary"}},"/api/v1/intelligence/track-record":{"get":{"operationId":"getTrackRecord","summary":"Get signal hit rate and calibration by window and asset","description":"Every published signal change is logged with its price, confidence and algorithm version; forward returns after 5m, 15m, 1h and 24h are filled as time passes. Returns hit rate and average return in the signal direction per horizon, per signal type and per confidence bucket, for any window, symbol and period, plus the latest signals with outcomes. Not charged (404) while nothing is logged for the query.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":120,"default":30},"description":"Look-back period in days","example":30},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional symbol, e.g. ETHUSD.","example":"ETHUSD"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Track record detail","content":{"application/json":{"schema":{"type":"object","properties":{"signalsLogged":{"type":"integer"},"directionalSignals":{"type":"integer"},"byHorizon":{"type":"object","properties":{"1h":{"type":"object","properties":{"averageReturnInSignalDirectionPercent":{"type":"number"},"evaluated":{"type":"integer"},"hitRatePercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"calibration1hByConfidence":{"type":"object","properties":{"80-100":{"type":"object","properties":{"evaluated":{"type":"integer"},"hitRatePercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"periodDays":{"type":"integer"},"window":{"type":"string"},"algoVersion":{"type":"string"},"recentSignals":{"type":"array","items":{"type":"object","properties":{"signal":{"type":"string"},"at":{"type":"string"},"price":{"type":"number"},"direction":{"type":"string"},"forwardReturnsPercent":{"type":"object","properties":{"5m":{"type":"number"},"1h":{"type":"number"}},"additionalProperties":true},"symbol":{"type":"string"},"confidence":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"signalsLogged":1840,"directionalSignals":1122,"byHorizon":{"1h":{"averageReturnInSignalDirectionPercent":0.041,"evaluated":1050,"hitRatePercent":54.2}},"calibration1hByConfidence":{"80-100":{"evaluated":210,"hitRatePercent":58.1}},"periodDays":30,"window":"5m","algoVersion":"flow-v2-2026-09-25","recentSignals":[{"signal":"BUYING_ACTIVITY","at":"2026-09-25T05:10:00Z","price":2679.2,"direction":"BULLISH","forwardReturnsPercent":{"5m":0.05,"1h":0.21},"symbol":"ETHUSD","confidence":88.4}]}}}},"400":{"description":"Invalid window (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No logged signals for the query yet (not charged)"}},"x-mcp-tool":"get_track_record"}},"/coverage":{"get":{"operationId":"getCoverage","summary":"List which data sources cover each symbol","description":"Which sources exist per symbol (spot DEX flow on-chain and on Solana, perpetual futures venues), so an agent knows what a paid call returns. Paid endpoints answer 404 (not charged) when a symbol has no data for them. Free.","tags":["Free"],"security":[],"responses":{"200":{"description":"Coverage","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_data_coverage"}},"/api/v1/intelligence/positioning/{symbol}":{"get":{"operationId":"getPositioning","summary":"Get perp long/short positioning next to spot flow","description":"For a tokenized stock, ETF or commodity (TSLA, NVDA, SPY, QQQ, AMZN, NFLX, HOOD, gold XAUUSD, silver XAGUSD, oil WTIUSD and BRENTUSD, NATGASUSD, ...): open interest long and short per perp venue (GMX v2 synthetic markets, gTrade on Arbitrum and Base) read on chain every 5 minutes, funding (GMX: annualized, positive = longs pay; gTrade: the larger side pays), 1h and 24h change of total open interest and a positioning flag (CROWDED_LONG / CROWDED_SHORT at a 65% long or short share, THIN below $50k), next to the latest spot DEX flow when the symbol trades spot. Symbols covered by perps only get a partial answer with a coverage note; 404 (not charged) when neither exists.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any Hyperliquid perp market (300+: crypto, US stocks, ETFs, commodities such as XAUUSD, WTIUSD). Unknown: 404, not charged.","example":"ETHUSD"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Perps and spot positioning","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"perps":{"type":"object","properties":{"openInterestLongUsd":{"type":"integer"},"openInterestShortUsd":{"type":"integer"},"longSharePercent":{"type":"number"},"positioning":{"type":"string"},"openInterestChange24hPercent":{"type":"number"},"venues":{"type":"array","items":{"type":"object","properties":{"fundingPaidBy":{"type":"string"},"openInterestShortUsd":{"type":"integer"},"openInterestLongUsd":{"type":"integer"},"venue":{"type":"string"},"fundingRateAnnualPercent":{"type":"number"},"market":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"spot":{},"coverage":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"XAUUSD","perps":{"openInterestLongUsd":397242,"openInterestShortUsd":330086,"longSharePercent":54.6,"positioning":"BALANCED","openInterestChange24hPercent":3.2,"venues":[{"fundingPaidBy":"LONGS","openInterestShortUsd":157838,"openInterestLongUsd":182798,"venue":"gmx_v2_arbitrum","fundingRateAnnualPercent":17.33,"market":"GOLD/USD"}]},"spot":null,"coverage":["perps:gmx_v2_arbitrum","perps:gtrade_arbitrum"]}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No spot or perp data for the symbol (not charged); see /coverage"}},"x-mcp-tool":"get_positioning"}},"/api/v1/intelligence/smart-money/{symbol}":{"get":{"operationId":"getSmartMoney","summary":"List the most profitable DEX wallets of an asset","description":"Wallets (public addresses only) trading a symbol in the DEX pools we ingest, ranked by realized plus unrealized PnL (average cost on what was bought while tracked, marked at the latest pool price), with win rate, average holding time, open position, and the net flow of the top-decile wallets vs all wallets over the last two UTC days. Wallet = recipient of organic swaps; arbitrage, MEV, two-sided bots and router-bound swaps are excluded; trades under $50 ignored. A reliable ranking needs 2-4 weeks of history. 404 (not charged) when no wallet trade is recorded for the symbol.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any covered symbol, not only the example: crypto pairs (ETHUSD) and tokenized US stocks (NVDA); free list at /coverage. Unknown: 404, not charged.","example":"ETHUSD"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Ranked wallets and flow","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"walletsTracked":{"type":"integer"},"walletsRanked":{"type":"integer"},"markPrice":{"type":"number"},"topWallets":{"type":"array","items":{"type":"object","properties":{"openPositionUsd":{"type":"number"},"realizedPnlUsd":{"type":"number"},"wallet":{"type":"string"},"averageHoldingMinutes":{"type":"integer"},"winRatePercent":{"type":"number"},"totalPnlUsd":{"type":"number"},"closedPositions":{"type":"integer"}},"additionalProperties":true}},"flowLast2DaysUsd":{"type":"object","properties":{"smartWallets":{"type":"integer"},"smartMoneyNetUsd":{"type":"number"},"smartMoneyBias":{"type":"string"},"allWalletsNetUsd":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"ETHUSD","walletsTracked":4210,"walletsRanked":612,"markPrice":2679.2,"topWallets":[{"openPositionUsd":42100.0,"realizedPnlUsd":15210.0,"wallet":"0x3f5c...9a1e","averageHoldingMinutes":312,"winRatePercent":71.4,"totalPnlUsd":18422.5,"closedPositions":14}],"flowLast2DaysUsd":{"smartWallets":61,"smartMoneyNetUsd":128400.0,"smartMoneyBias":"NET_BUYING","allWalletsNetUsd":-220150.0}}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No wallet trades recorded yet (not charged)"}},"x-mcp-tool":"get_smart_money"}},"/api/v1/rates/curve":{"get":{"operationId":"getYieldCurve","summary":"Get the Treasury yield curve, slopes, SOFR and euro STR","description":"US Treasury daily par yield curve (1M-30Y) and real TIPS curve with the change vs the previous business day, 2s10s, 3m10y, 5s30s and 3m2y slopes with inversion flags, 10y breakeven inflation, and overnight rates: SOFR and EFFR (New York Fed; the response carries the notice its Terms of Use require) and euro STR (ECB). Sources: home.treasury.gov (public domain), markets.newyorkfed.org, ECB Data Portal.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Curve and overnight rates","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"nominalYieldsPercent":{"type":"object","properties":{"2 Yr":{"type":"number"},"3 Mo":{"type":"number"},"30 Yr":{"type":"number"},"10 Yr":{"type":"number"}},"additionalProperties":true},"slopesBps":{"type":"object","properties":{"3m10y":{"type":"number"},"2s10s":{"type":"number"}},"additionalProperties":true},"inversions":{"type":"object","properties":{"3m10y":{"type":"boolean"},"2s10s":{"type":"boolean"}},"additionalProperties":true},"breakevenInflation10yPercent":{"type":"number"},"overnight":{"type":"object","properties":{"SOFR":{"type":"object","properties":{"effectiveDate":{"type":"string"},"ratePercent":{"type":"number"}},"additionalProperties":true},"ESTR":{"type":"object","properties":{"ratePercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"date":"2026-09-24","nominalYieldsPercent":{"2 Yr":4.87,"3 Mo":4.24,"30 Yr":5.47,"10 Yr":5.18},"slopesBps":{"3m10y":94.0,"2s10s":31.0},"inversions":{"3m10y":false,"2s10s":false},"breakevenInflation10yPercent":2.33,"overnight":{"SOFR":{"effectiveDate":"2026-09-23","ratePercent":3.87},"ESTR":{"ratePercent":2.44}}}}}},"402":{"description":"Payment Required"},"503":{"description":"Source temporarily unavailable (not charged)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_yield_curve"}},"/api/v1/rates/defi-spread":{"get":{"operationId":"getDefiRateSpread","summary":"Compare Aave USDC lending rates with the 3-month T-bill","description":"USDC supply and variable borrow APR on Aave v3 (Ethereum, Base, Arbitrum, Optimism, Polygon) read on chain, each against the 3-month Treasury bill, with the average spread and a signal (DEFI_PREMIUM, IN_LINE, TREASURY_PREMIUM at +-50 bp).","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Rates and spread","content":{"application/json":{"schema":{"type":"object","properties":{"treasury3mPercent":{"type":"number"},"averageUsdcSupplyAprPercent":{"type":"number"},"averageSpreadBps":{"type":"number"},"signal":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"supplyAprPercent":{"type":"number"},"spreadVs3mBillBps":{"type":"number"},"variableBorrowAprPercent":{"type":"number"},"chain":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"treasury3mPercent":4.24,"averageUsdcSupplyAprPercent":3.32,"averageSpreadBps":-92.0,"signal":"TREASURY_PREMIUM","markets":[{"protocol":"aave_v3","supplyAprPercent":3.97,"spreadVs3mBillBps":-27.0,"variableBorrowAprPercent":4.89,"chain":"base"}]}}}},"402":{"description":"Payment Required"},"503":{"description":"Source temporarily unavailable (not charged)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_defi_rate_spread"}},"/api/v1/rates/tokenized-treasuries":{"get":{"operationId":"getTokenizedTreasuries","summary":"Get supply and net issuance of tokenized treasuries","description":"totalSupply of BlackRock BUIDL, Ondo USDY and OUSG, Superstate USTB and Hashnote USYC on Ethereum, snapshotted hourly on chain, with 24h and 7d change and an aggregate gauge (RISK_OFF_INFLOW / NEUTRAL / RISK_ON_OUTFLOW at +-0.5% per day). Token units; NAV per token differs by fund. 404 (not charged) before the first snapshot.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Funds and gauge","content":{"application/json":{"schema":{"type":"object","properties":{"funds":{"type":"array","items":{"type":"object","properties":{"issuer":{"type":"string"},"change7dPercent":{"type":"number"},"change24hPercent":{"type":"number"},"symbol":{"type":"string"},"supplyTokens":{"type":"integer"}},"additionalProperties":true}},"aggregateChange24hPercent":{"type":"number"},"gauge":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"funds":[{"issuer":"BlackRock","change7dPercent":3.1,"change24hPercent":0.42,"symbol":"BUIDL","supplyTokens":208338526}],"aggregateChange24hPercent":0.21,"gauge":"NEUTRAL"}}}},"402":{"description":"Payment Required"},"404":{"description":"No snapshot yet (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_tokenized_treasuries"}},"/api/v1/rates/auctions":{"get":{"operationId":"getTreasuryAuctions","summary":"List upcoming and recent US Treasury auctions","description":"US Treasury auctions of the last days (1-60) and those announced: security, term, offering amount, high yield or discount rate, bid-to-cover, indirect and primary-dealer shares, and the previous auction of the same security for comparison. Source: fiscaldata.treasury.gov (public domain).","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":60,"default":14},"description":"Look-back period in days","example":14}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Auctions","content":{"application/json":{"schema":{"type":"object","properties":{"upcoming":{"type":"array","items":{"type":"object","properties":{"securityTerm":{"type":"string"},"securityType":{"type":"string"},"auctionDate":{"type":"string"}},"additionalProperties":true}},"recent":{"type":"array","items":{"type":"object","properties":{"indirectBiddersPercent":{"type":"number"},"securityTerm":{"type":"string"},"highYieldPercent":{"type":"number"},"securityType":{"type":"string"},"auctionDate":{"type":"string"},"bidToCover":{"type":"number"},"previous":{"type":"object","properties":{"bidToCover":{"type":"number"},"highYieldPercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"upcoming":[{"securityTerm":"52-Week","securityType":"Bill","auctionDate":"2026-09-29"}],"recent":[{"indirectBiddersPercent":60.98,"securityTerm":"10-Year","highYieldPercent":4.683,"securityType":"Note","auctionDate":"2026-08-12","bidToCover":2.53,"previous":{"bidToCover":2.61,"highYieldPercent":4.52}}]}}}},"402":{"description":"Payment Required"},"503":{"description":"Source temporarily unavailable (not charged)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_treasury_auctions"}},"/api/v1/rates/liquidity":{"get":{"operationId":"getDollarLiquidity","summary":"Get net dollar liquidity and its trend","description":"Net dollar liquidity: Federal Reserve total assets (H.4.1, weekly) minus the Treasury General Account (Daily Treasury Statement) minus the overnight reverse repo facility (New York Fed, daily), the money left in the system that risk assets such as crypto and equities tend to follow. Returns the latest nowcast, each component with its date, the 1/4/13/52-week change, a trend (EXPANDING above +1% over 4 weeks, CONTRACTING below -1%, otherwise FLAT), the percentile over two years and a 26-week series. Sources: federalreserve.gov and fiscaldata.treasury.gov (public domain), markets.newyorkfed.org (with its notice).","tags":["Macro"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Net dollar liquidity","content":{"application/json":{"schema":{"type":"object"},"example":{"netLiquidityUsd":5788665000000,"netLiquidityTrillionsUsd":5.789,"asOf":"2026-09-30","method":"Fed total assets (H.4.1, weekly) - Treasury General Account (daily) - overnight reverse repo (daily)","components":{"fedTotalAssets":{"usd":6747704000000,"date":"2026-09-23","note":"weekly, Wednesday level"},"treasuryGeneralAccount":{"usd":936600000000,"date":"2026-09-29","note":"daily closing balance; subtracts from liquidity"},"overnightReverseRepo":{"usd":11539000000,"date":"2026-09-30","note":"daily take-up; subtracts from liquidity"}},"weeklyChange":{"1w":{"usd":-12400000000,"percent":-0.21},"4w":{"usd":61300000000,"percent":1.07},"13w":{"usd":148900000000,"percent":2.64},"52w":{"usd":402100000000,"percent":7.47}},"trend":"EXPANDING","percentileOfRange":88,"rangeWeeks":104,"read":"Net dollar liquidity rose 1.1% over 4 weeks: a tailwind for risk assets such as crypto and equities.","weeklySeries":[{"date":"2026-09-23","netLiquidityUsd":5788817000000,"fedTotalAssetsUsd":6747704000000,"treasuryGeneralAccountUsd":947317000000,"overnightReverseRepoUsd":11570000000}],"sources":["Federal Reserve H.4.1, Factors Affecting Reserve Balances (federalreserve.gov, public domain)","Daily Treasury Statement, operating cash balance (fiscaldata.treasury.gov, public domain)","New York Fed reverse repo operations (markets.newyorkfed.org)"],"nyFedNotice":"The reverse repo data are subject to the Terms of Use posted at newyorkfed.org. ..."}}}},"402":{"description":"Payment Required"},"404":{"description":"Not loaded yet right after a restart (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_dollar_liquidity"}},"/api/v1/rates/bank-credit":{"get":{"operationId":"getBankCredit","summary":"Get US bank credit and deposits with growth","description":"Weekly assets and liabilities of all US commercial banks, seasonally adjusted (Federal Reserve H.8): bank credit, securities, loans and leases, commercial and industrial, real estate and consumer loans, and deposits. Each with the level, 4- and 13-week annualized growth and 52-week growth; plus the loan-to-deposit ratio, loan growth momentum (ACCELERATING when 13-week annualized growth beats the yearly pace by more than a point, DECELERATING when it trails by more than a point, otherwise STEADY) and a 26-week series. Source: federalreserve.gov (public domain).","tags":["Macro"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Bank credit","content":{"application/json":{"schema":{"type":"object"},"example":{"weekEnded":"2026-09-16","scope":"All commercial banks in the US, seasonally adjusted, Wednesday level","items":{"bankCredit":{"usd":19876325900000,"annualizedGrowthPercent4w":3.1,"annualizedGrowthPercent13w":4.2,"growthPercent52w":4.8},"securities":{"usd":5797313900000,"annualizedGrowthPercent4w":-1.2,"annualizedGrowthPercent13w":0.8,"growthPercent52w":2.1},"loansAndLeases":{"usd":14079012000000,"annualizedGrowthPercent4w":4.9,"annualizedGrowthPercent13w":5.6,"growthPercent52w":5.9},"commercialAndIndustrialLoans":{"usd":2965268900000,"annualizedGrowthPercent4w":6.2,"annualizedGrowthPercent13w":7,"growthPercent52w":6.4},"realEstateLoans":{"usd":5836741700000,"annualizedGrowthPercent4w":3,"annualizedGrowthPercent13w":3.3,"growthPercent52w":3.4},"consumerLoans":{"usd":1925988600000,"annualizedGrowthPercent4w":2.4,"annualizedGrowthPercent13w":3.1,"growthPercent52w":3.8},"deposits":{"usd":19568400400000,"annualizedGrowthPercent4w":2.2,"annualizedGrowthPercent13w":3.5,"growthPercent52w":4.4}},"loanToDepositPercent":71.9,"loanGrowthMomentum":"STEADY","read":"Bank lending grows at a steady pace: 5.6% annualized over 13 weeks vs 5.9% over a year.","weeklySeries":[{"date":"2026-09-16","loansAndLeasesUsd":14079012000000,"depositsUsd":19568400400000}],"source":"Federal Reserve H.8, Assets and Liabilities of Commercial Banks in the United States (federalreserve.gov, public domain)"}}}},"402":{"description":"Payment Required"},"404":{"description":"Not loaded yet right after a restart (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_bank_credit"}},"/api/v1/intelligence/opportunities":{"get":{"operationId":"findOpportunities","summary":"Search trading opportunities matching a goal","description":"Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"objective","in":"query","required":true,"schema":{"type":"string","enum":["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]},"description":"What to look for","example":"unusual_buying"},{"name":"universe","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated symbols (max 100); omit for all covered symbols","example":"all"},{"name":"assetClass","in":"query","required":false,"schema":{"type":"string","enum":["crypto","us_equity","perp_only"]},"description":"Asset class filter: crypto, us_equity or perp_only","example":"crypto"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"minBuyPressure","in":"query","required":false,"schema":{"type":"number","minimum":50,"maximum":100,"default":60},"description":"Pressure on the objective's side (sell pressure for selling objectives)","example":60},{"name":"minVolumeMultiple","in":"query","required":false,"schema":{"type":"number","default":1.5},"description":"Volume vs the symbol's own baseline","example":1.5},{"name":"minVolumeUsd","in":"query","required":false,"schema":{"type":"number","default":0},"description":"USD traded in the window","example":0},{"name":"minConfidence","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100,"default":50},"description":"Minimum signal confidence (0-100)","example":50},{"name":"minIndependentSources","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":3,"default":1},"description":"Distinct sources confirming the direction","example":1},{"name":"include","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated: metrics, evidence, risk_factors, data_quality, track_record, market_context (default all)","example":"metrics,evidence,risk_factors"},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Maximum number of ranked results (1-50)","example":10}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Ranked opportunities","content":{"application/json":{"schema":{"type":"object","properties":{"objective":{"type":"string"},"objectiveDefinition":{"type":"string"},"window":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"algoVersion":{"type":"string"},"request":{"type":"object","description":"The request with defaults applied"},"symbolsScanned":{"type":"integer"},"matches":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"symbol":{"type":"string"},"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"direction":{"type":"string","enum":["BULLISH","BEARISH"]},"score":{"type":"integer","minimum":0,"maximum":100,"description":"40 for meeting the objective + up to 20 for strength + 15 per extra confirming source +/- up to 15 for calibration (live hit rate minus 50 on >= 30 samples), - 10 per conflicting item, - 5 per HIGH risk"},"independentSourcesConfirming":{"type":"integer"},"confirmingSources":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"signal":{"type":"string"},"eventType":{"type":"string"},"metrics":{"type":"object","description":"buyPressure, momentumScore, priceChangePercent, volumeUsd, volumeMultiple, anomalyScore, activityScore, tradeCount, largeTradeCount, confidenceScore, asOf"},"supportingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"conflictingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"riskFactors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"thin_liquidity, low_confidence, bot_dominated_flow, baseline_not_ready, crowded_positioning, price_dislocation, us_market_closed, corporate_action, macro_event, conflicting_evidence, weak_signal_track_record"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"detail":{"type":"string"}}}},"dataQuality":{"type":"object","description":"sourcesAvailable, sourcesMissing, signalAgeSeconds, confidenceScore, tradeCount, baselineReady, organicSharePercent, freshPools, oracleDeviationBps"},"signalTrackRecord1h":{"type":"object","description":"Live 1h hit rate of this signal label over 30 days (all symbols); hitRatePercent is null below 30 evaluated signals; appliesToThisDirection says whether the signal points the same way as the result (only then it counts in the score)"},"nextCalls":{"type":"object","description":"Follow-up routes: preTradeCheck, positioning, smartMoney, trackRecord"},"calibratedHitRatePercent":{"type":["number","null"],"description":"Live hit rate behind this result (the signal 1h record in the result direction, or crowding events 4h for crowded_positioning); null below 30 evaluated samples"},"positioningTrackRecord4h":{"type":"object","description":"crowded_positioning only: 4h record of crowding events on this side"}}}},"noMatchReason":{"type":"string"},"filteredOut":{"type":"object","additionalProperties":{"type":"integer"},"description":"Why symbols were excluded, with counts"},"notCovered":{"type":"array","items":{"type":"string"}},"marketContext":{"type":"object","description":"regime, usMarketSession, stablecoinNetIssuance24hUsd, macroEventsNext2h"},"method":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"objective":"unusual_buying","window":"15m","asOf":"2026-09-25T11:00:00Z","algoVersion":"opportunities-v1-2026-09-25","symbolsScanned":104,"matches":1,"results":[{"rank":1,"symbol":"ETHUSD","assetClass":"crypto","direction":"BULLISH","score":78,"independentSourcesConfirming":2,"confirmingSources":["spot_dex_flow","smart_money"],"price":2692.07,"signal":"BUYING_ACTIVITY","eventType":"BULLISH_ACCUMULATION","metrics":{"volumeUsd":3400000,"volumeMultiple":2.8,"momentumScore":66.1,"confidenceScore":96.0,"buyPressure":72.4},"supportingEvidence":[{"source":"spot_dex_flow","type":"buy_pressure","direction":"BULLISH","observedValue":72.4,"unit":"percent of organic aggressor volume","detail":"Buy pressure 72.4% over 15m (55+ bullish, 45- bearish)"}],"conflictingEvidence":[],"riskFactors":[{"type":"macro_event","detail":"US CPI in 45 min","severity":"MEDIUM"}],"dataQuality":{"sourcesAvailable":["spot_dex_flow","perp_positioning","smart_money"],"signalAgeSeconds":38,"freshPools":28,"organicSharePercent":67.0},"signalTrackRecord1h":{"sufficientSample":true,"signal":"BUYING_ACTIVITY","evaluated":145,"hitRatePercent":71.7},"nextCalls":{"preTradeCheck":"/api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy&window=15m"}}],"filteredOut":{"buy_pressure_below_minBuyPressure":88,"volume_not_unusual":15},"marketContext":{"usMarketSession":"REGULAR","regime":"MIXED"}}}}},"400":{"description":"Invalid request with the accepted values (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No fresh market data (not charged)"}},"x-mcp-tool":"find_opportunities"},"post":{"operationId":"findOpportunitiesPost","summary":"Search opportunities from a JSON goal and constraints","description":"Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["objective"],"properties":{"objective":{"type":"string","enum":["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]},"universe":{"type":"array","items":{"type":"string"},"maxItems":100,"description":"Symbols to scan; omit for all covered"},"constraints":{"type":"object","description":"Optional; the same keys are also accepted at the top level","properties":{"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"window":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"minBuyPressure":{"type":"number","minimum":50,"maximum":100,"default":60,"description":"Pressure on the objective's side"},"minVolumeMultiple":{"type":"number","default":1.5},"minVolumeUsd":{"type":"number","default":0},"minConfidence":{"type":"number","minimum":0,"maximum":100,"default":50},"minIndependentSources":{"type":"integer","minimum":1,"maximum":3,"default":1}}},"include":{"type":"array","items":{"type":"string","enum":["metrics","evidence","risk_factors","data_quality","track_record","market_context"]}},"maxResults":{"type":"integer","minimum":1,"maximum":50,"default":10},"window":{"type":"string","enum":["1m","5m","15m","1h","4h","24h"],"default":"5m","description":"Signal window to scan."}}},"example":{"objective":"unusual_buying","window":"15m","constraints":{"minBuyPressure":60},"maxResults":10}}}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Ranked opportunities","content":{"application/json":{"schema":{"type":"object","properties":{"objective":{"type":"string"},"objectiveDefinition":{"type":"string"},"window":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"algoVersion":{"type":"string"},"request":{"type":"object","description":"The request with defaults applied"},"symbolsScanned":{"type":"integer"},"matches":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"symbol":{"type":"string"},"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"direction":{"type":"string","enum":["BULLISH","BEARISH"]},"score":{"type":"integer","minimum":0,"maximum":100,"description":"40 for meeting the objective + up to 20 for strength + 15 per extra confirming source +/- up to 15 for calibration (live hit rate minus 50 on >= 30 samples), - 10 per conflicting item, - 5 per HIGH risk"},"independentSourcesConfirming":{"type":"integer"},"confirmingSources":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"signal":{"type":"string"},"eventType":{"type":"string"},"metrics":{"type":"object","description":"buyPressure, momentumScore, priceChangePercent, volumeUsd, volumeMultiple, anomalyScore, activityScore, tradeCount, largeTradeCount, confidenceScore, asOf"},"supportingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"conflictingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"riskFactors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"thin_liquidity, low_confidence, bot_dominated_flow, baseline_not_ready, crowded_positioning, price_dislocation, us_market_closed, corporate_action, macro_event, conflicting_evidence, weak_signal_track_record"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"detail":{"type":"string"}}}},"dataQuality":{"type":"object","description":"sourcesAvailable, sourcesMissing, signalAgeSeconds, confidenceScore, tradeCount, baselineReady, organicSharePercent, freshPools, oracleDeviationBps"},"signalTrackRecord1h":{"type":"object","description":"Live 1h hit rate of this signal label over 30 days (all symbols); hitRatePercent is null below 30 evaluated signals; appliesToThisDirection says whether the signal points the same way as the result (only then it counts in the score)"},"nextCalls":{"type":"object","description":"Follow-up routes: preTradeCheck, positioning, smartMoney, trackRecord"},"calibratedHitRatePercent":{"type":["number","null"],"description":"Live hit rate behind this result (the signal 1h record in the result direction, or crowding events 4h for crowded_positioning); null below 30 evaluated samples"},"positioningTrackRecord4h":{"type":"object","description":"crowded_positioning only: 4h record of crowding events on this side"}}}},"noMatchReason":{"type":"string"},"filteredOut":{"type":"object","additionalProperties":{"type":"integer"},"description":"Why symbols were excluded, with counts"},"notCovered":{"type":"array","items":{"type":"string"}},"marketContext":{"type":"object","description":"regime, usMarketSession, stablecoinNetIssuance24hUsd, macroEventsNext2h"},"method":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"objective":"unusual_buying","window":"15m","asOf":"2026-09-25T11:00:00Z","algoVersion":"opportunities-v1-2026-09-25","symbolsScanned":104,"matches":1,"results":[{"rank":1,"symbol":"ETHUSD","assetClass":"crypto","direction":"BULLISH","score":78,"independentSourcesConfirming":2,"confirmingSources":["spot_dex_flow","smart_money"],"price":2692.07,"signal":"BUYING_ACTIVITY","eventType":"BULLISH_ACCUMULATION","metrics":{"volumeUsd":3400000,"volumeMultiple":2.8,"momentumScore":66.1,"confidenceScore":96.0,"buyPressure":72.4},"supportingEvidence":[{"source":"spot_dex_flow","type":"buy_pressure","direction":"BULLISH","observedValue":72.4,"unit":"percent of organic aggressor volume","detail":"Buy pressure 72.4% over 15m (55+ bullish, 45- bearish)"}],"conflictingEvidence":[],"riskFactors":[{"type":"macro_event","detail":"US CPI in 45 min","severity":"MEDIUM"}],"dataQuality":{"sourcesAvailable":["spot_dex_flow","perp_positioning","smart_money"],"signalAgeSeconds":38,"freshPools":28,"organicSharePercent":67.0},"signalTrackRecord1h":{"sufficientSample":true,"signal":"BUYING_ACTIVITY","evaluated":145,"hitRatePercent":71.7},"nextCalls":{"preTradeCheck":"/api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy&window=15m"}}],"filteredOut":{"buy_pressure_below_minBuyPressure":88,"volume_not_unusual":15},"marketContext":{"usMarketSession":"REGULAR","regime":"MIXED"}}}}},"400":{"description":"Invalid request with the accepted values (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No fresh market data (not charged)"}},"x-mcp-tool":"find_opportunities"}},"/api/v1/agent/opportunities":{"get":{"operationId":"findOpportunitiesAgent","summary":"Search trading opportunities by goal (agent route)","description":"Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"objective","in":"query","required":true,"schema":{"type":"string","enum":["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]},"description":"What to look for","example":"unusual_buying"},{"name":"universe","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated symbols (max 100); omit for all covered symbols","example":"all"},{"name":"assetClass","in":"query","required":false,"schema":{"type":"string","enum":["crypto","us_equity","perp_only"]},"description":"Asset class filter: crypto, us_equity or perp_only","example":"crypto"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"},{"name":"minBuyPressure","in":"query","required":false,"schema":{"type":"number","minimum":50,"maximum":100,"default":60},"description":"Pressure on the objective's side (sell pressure for selling objectives)","example":60},{"name":"minVolumeMultiple","in":"query","required":false,"schema":{"type":"number","default":1.5},"description":"Volume vs the symbol's own baseline","example":1.5},{"name":"minVolumeUsd","in":"query","required":false,"schema":{"type":"number","default":0},"description":"USD traded in the window","example":0},{"name":"minConfidence","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100,"default":50},"description":"Minimum signal confidence (0-100)","example":50},{"name":"minIndependentSources","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":3,"default":1},"description":"Distinct sources confirming the direction","example":1},{"name":"include","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated: metrics, evidence, risk_factors, data_quality, track_record, market_context (default all)","example":"metrics,evidence,risk_factors"},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Maximum number of ranked results (1-50)","example":10}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Ranked opportunities","content":{"application/json":{"schema":{"type":"object","properties":{"objective":{"type":"string"},"objectiveDefinition":{"type":"string"},"window":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"algoVersion":{"type":"string"},"request":{"type":"object","description":"The request with defaults applied"},"symbolsScanned":{"type":"integer"},"matches":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"symbol":{"type":"string"},"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"direction":{"type":"string","enum":["BULLISH","BEARISH"]},"score":{"type":"integer","minimum":0,"maximum":100,"description":"40 for meeting the objective + up to 20 for strength + 15 per extra confirming source +/- up to 15 for calibration (live hit rate minus 50 on >= 30 samples), - 10 per conflicting item, - 5 per HIGH risk"},"independentSourcesConfirming":{"type":"integer"},"confirmingSources":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"signal":{"type":"string"},"eventType":{"type":"string"},"metrics":{"type":"object","description":"buyPressure, momentumScore, priceChangePercent, volumeUsd, volumeMultiple, anomalyScore, activityScore, tradeCount, largeTradeCount, confidenceScore, asOf"},"supportingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"conflictingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"riskFactors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"thin_liquidity, low_confidence, bot_dominated_flow, baseline_not_ready, crowded_positioning, price_dislocation, us_market_closed, corporate_action, macro_event, conflicting_evidence, weak_signal_track_record"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"detail":{"type":"string"}}}},"dataQuality":{"type":"object","description":"sourcesAvailable, sourcesMissing, signalAgeSeconds, confidenceScore, tradeCount, baselineReady, organicSharePercent, freshPools, oracleDeviationBps"},"signalTrackRecord1h":{"type":"object","description":"Live 1h hit rate of this signal label over 30 days (all symbols); hitRatePercent is null below 30 evaluated signals; appliesToThisDirection says whether the signal points the same way as the result (only then it counts in the score)"},"nextCalls":{"type":"object","description":"Follow-up routes: preTradeCheck, positioning, smartMoney, trackRecord"},"calibratedHitRatePercent":{"type":["number","null"],"description":"Live hit rate behind this result (the signal 1h record in the result direction, or crowding events 4h for crowded_positioning); null below 30 evaluated samples"},"positioningTrackRecord4h":{"type":"object","description":"crowded_positioning only: 4h record of crowding events on this side"}}}},"noMatchReason":{"type":"string"},"filteredOut":{"type":"object","additionalProperties":{"type":"integer"},"description":"Why symbols were excluded, with counts"},"notCovered":{"type":"array","items":{"type":"string"}},"marketContext":{"type":"object","description":"regime, usMarketSession, stablecoinNetIssuance24hUsd, macroEventsNext2h"},"method":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"objective":"unusual_buying","window":"15m","asOf":"2026-09-25T11:00:00Z","algoVersion":"opportunities-v1-2026-09-25","symbolsScanned":104,"matches":1,"results":[{"rank":1,"symbol":"ETHUSD","assetClass":"crypto","direction":"BULLISH","score":78,"independentSourcesConfirming":2,"confirmingSources":["spot_dex_flow","smart_money"],"price":2692.07,"signal":"BUYING_ACTIVITY","eventType":"BULLISH_ACCUMULATION","metrics":{"volumeUsd":3400000,"volumeMultiple":2.8,"momentumScore":66.1,"confidenceScore":96.0,"buyPressure":72.4},"supportingEvidence":[{"source":"spot_dex_flow","type":"buy_pressure","direction":"BULLISH","observedValue":72.4,"unit":"percent of organic aggressor volume","detail":"Buy pressure 72.4% over 15m (55+ bullish, 45- bearish)"}],"conflictingEvidence":[],"riskFactors":[{"type":"macro_event","detail":"US CPI in 45 min","severity":"MEDIUM"}],"dataQuality":{"sourcesAvailable":["spot_dex_flow","perp_positioning","smart_money"],"signalAgeSeconds":38,"freshPools":28,"organicSharePercent":67.0},"signalTrackRecord1h":{"sufficientSample":true,"signal":"BUYING_ACTIVITY","evaluated":145,"hitRatePercent":71.7},"nextCalls":{"preTradeCheck":"/api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy&window=15m"}}],"filteredOut":{"buy_pressure_below_minBuyPressure":88,"volume_not_unusual":15},"marketContext":{"usMarketSession":"REGULAR","regime":"MIXED"}}}}},"400":{"description":"Invalid request with the accepted values (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No fresh market data (not charged)"}},"x-mcp-tool":"find_opportunities"},"post":{"operationId":"findOpportunitiesAgentPost","summary":"Search opportunities from JSON (agent alias route)","description":"Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["objective"],"properties":{"objective":{"type":"string","enum":["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]},"universe":{"type":"array","items":{"type":"string"},"maxItems":100,"description":"Symbols to scan; omit for all covered"},"constraints":{"type":"object","description":"Optional; the same keys are also accepted at the top level","properties":{"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"window":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"minBuyPressure":{"type":"number","minimum":50,"maximum":100,"default":60,"description":"Pressure on the objective's side"},"minVolumeMultiple":{"type":"number","default":1.5},"minVolumeUsd":{"type":"number","default":0},"minConfidence":{"type":"number","minimum":0,"maximum":100,"default":50},"minIndependentSources":{"type":"integer","minimum":1,"maximum":3,"default":1}}},"include":{"type":"array","items":{"type":"string","enum":["metrics","evidence","risk_factors","data_quality","track_record","market_context"]}},"maxResults":{"type":"integer","minimum":1,"maximum":50,"default":10},"window":{"type":"string","enum":["1m","5m","15m","1h","4h","24h"],"default":"5m","description":"Signal window to scan."}}},"example":{"objective":"unusual_buying","window":"15m","constraints":{"minBuyPressure":60},"maxResults":10}}}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Ranked opportunities","content":{"application/json":{"schema":{"type":"object","properties":{"objective":{"type":"string"},"objectiveDefinition":{"type":"string"},"window":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"algoVersion":{"type":"string"},"request":{"type":"object","description":"The request with defaults applied"},"symbolsScanned":{"type":"integer"},"matches":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"symbol":{"type":"string"},"assetClass":{"type":"string","enum":["crypto","us_equity","perp_only"]},"direction":{"type":"string","enum":["BULLISH","BEARISH"]},"score":{"type":"integer","minimum":0,"maximum":100,"description":"40 for meeting the objective + up to 20 for strength + 15 per extra confirming source +/- up to 15 for calibration (live hit rate minus 50 on >= 30 samples), - 10 per conflicting item, - 5 per HIGH risk"},"independentSourcesConfirming":{"type":"integer"},"confirmingSources":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"signal":{"type":"string"},"eventType":{"type":"string"},"metrics":{"type":"object","description":"buyPressure, momentumScore, priceChangePercent, volumeUsd, volumeMultiple, anomalyScore, activityScore, tradeCount, largeTradeCount, confidenceScore, asOf"},"supportingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"conflictingEvidence":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["spot_dex_flow","perp_positioning","smart_money"]},"type":{"type":"string","description":"buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow"},"direction":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL","ACTIVITY"]},"observedValue":{},"unit":{"type":"string"},"detail":{"type":"string"}}}},"riskFactors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"thin_liquidity, low_confidence, bot_dominated_flow, baseline_not_ready, crowded_positioning, price_dislocation, us_market_closed, corporate_action, macro_event, conflicting_evidence, weak_signal_track_record"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"detail":{"type":"string"}}}},"dataQuality":{"type":"object","description":"sourcesAvailable, sourcesMissing, signalAgeSeconds, confidenceScore, tradeCount, baselineReady, organicSharePercent, freshPools, oracleDeviationBps"},"signalTrackRecord1h":{"type":"object","description":"Live 1h hit rate of this signal label over 30 days (all symbols); hitRatePercent is null below 30 evaluated signals; appliesToThisDirection says whether the signal points the same way as the result (only then it counts in the score)"},"nextCalls":{"type":"object","description":"Follow-up routes: preTradeCheck, positioning, smartMoney, trackRecord"},"calibratedHitRatePercent":{"type":["number","null"],"description":"Live hit rate behind this result (the signal 1h record in the result direction, or crowding events 4h for crowded_positioning); null below 30 evaluated samples"},"positioningTrackRecord4h":{"type":"object","description":"crowded_positioning only: 4h record of crowding events on this side"}}}},"noMatchReason":{"type":"string"},"filteredOut":{"type":"object","additionalProperties":{"type":"integer"},"description":"Why symbols were excluded, with counts"},"notCovered":{"type":"array","items":{"type":"string"}},"marketContext":{"type":"object","description":"regime, usMarketSession, stablecoinNetIssuance24hUsd, macroEventsNext2h"},"method":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"objective":"unusual_buying","window":"15m","asOf":"2026-09-25T11:00:00Z","algoVersion":"opportunities-v1-2026-09-25","symbolsScanned":104,"matches":1,"results":[{"rank":1,"symbol":"ETHUSD","assetClass":"crypto","direction":"BULLISH","score":78,"independentSourcesConfirming":2,"confirmingSources":["spot_dex_flow","smart_money"],"price":2692.07,"signal":"BUYING_ACTIVITY","eventType":"BULLISH_ACCUMULATION","metrics":{"volumeUsd":3400000,"volumeMultiple":2.8,"momentumScore":66.1,"confidenceScore":96.0,"buyPressure":72.4},"supportingEvidence":[{"source":"spot_dex_flow","type":"buy_pressure","direction":"BULLISH","observedValue":72.4,"unit":"percent of organic aggressor volume","detail":"Buy pressure 72.4% over 15m (55+ bullish, 45- bearish)"}],"conflictingEvidence":[],"riskFactors":[{"type":"macro_event","detail":"US CPI in 45 min","severity":"MEDIUM"}],"dataQuality":{"sourcesAvailable":["spot_dex_flow","perp_positioning","smart_money"],"signalAgeSeconds":38,"freshPools":28,"organicSharePercent":67.0},"signalTrackRecord1h":{"sufficientSample":true,"signal":"BUYING_ACTIVITY","evaluated":145,"hitRatePercent":71.7},"nextCalls":{"preTradeCheck":"/api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy&window=15m"}}],"filteredOut":{"buy_pressure_below_minBuyPressure":88,"volume_not_unusual":15},"marketContext":{"usMarketSession":"REGULAR","regime":"MIXED"}}}}},"400":{"description":"Invalid request with the accepted values (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No fresh market data (not charged)"}},"x-mcp-tool":"find_opportunities"}},"/api/v1/intelligence/snapshot/{symbol}":{"get":{"operationId":"getSnapshot","summary":"Get price, buy pressure and signal of one asset now","description":"Headline numbers of one crypto asset or tokenized US stock right now: price, price change over the window, buy pressure from the exact taker side of on-chain swaps (arbitrage, MEV and bots excluded), signal, event, confidence and trade count. The full signal is /api/v1/intelligence/{symbol}. 404 (not charged) without recent trade flow.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any covered symbol, not only the example: crypto pairs (ETHUSD) and tokenized US stocks (NVDA); free list at /coverage. Unknown: 404, not charged.","example":"ETHUSD"},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m"],"default":"5m"},"description":"Aggregation window of the signal: 1m, 5m, 15m, 1h, 4h or 24h","example":"5m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"window":{"type":"string"},"price":{"type":"number"},"priceChangePercent":{"type":"number"},"buyPressure":{"type":"number"},"signal":{"type":"string"},"eventType":{"type":"string"},"confidenceScore":{"type":"integer"},"tradeCount":{"type":"integer"},"asOf":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"ETHUSD","window":"5m","price":2692.07,"priceChangePercent":0.214,"buyPressure":61.3,"signal":"BUYING_ACTIVITY","eventType":"NORMAL","confidenceScore":96,"tradeCount":412,"asOf":"2026-09-25T19:30:00Z"}}}},"402":{"description":"Payment Required"},"404":{"description":"No recent trade flow (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_snapshot"}},"/api/v1/report/{symbol}":{"get":{"operationId":"getSymbolReport","summary":"Get a full report on one symbol in a single call","description":"Everything about one symbol: snapshot, pre-trade verdict, technical indicators, perp positioning, smart money and news, plus fundamentals, insider trades (90 days) and Form 144 notices for US stocks. Sections are loaded in parallel; any without data are listed in missingSections instead of failing the report.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any crypto pair or US ticker covered by at least one source: on-chain (/coverage) or SEC filings. Unknown: 404, not charged.","example":"NVDA"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Report sections and the list of missing sections","content":{"application/json":{"schema":{"type":"object","properties":{"technical":{"type":"object","properties":{"rsi14":{"type":"number"},"bias":{"type":"string"}},"additionalProperties":true},"preTrade":{"type":"object","properties":{"score":{"type":"integer"},"verdict":{"type":"string"}},"additionalProperties":true},"missingSections":{"type":"array","items":{"type":"string"}},"symbol":{"type":"string"},"assetType":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"technical":{"rsi14":58.2,"bias":"BULLISH"},"preTrade":{"score":68,"verdict":"FAVORABLE"},"missingSections":["smartMoney"],"symbol":"NVDA","assetType":"us_equity_or_etf"}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_symbol_report"}},"/api/v1/markets/technical/{symbol}":{"get":{"operationId":"getTechnicalIndicators","summary":"Get RSI, MACD, Bollinger and moving averages","description":"RSI(14), MACD(12,26,9), Bollinger(20,2) with %B and bandwidth, SMA20/SMA50, ATR(14) and VWAP over the last 50 candles, computed on candles built from on-chain swaps, with bullish/bearish signals and an overall bias.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any covered symbol, not only the example: crypto pairs (ETHUSD) and tokenized US stocks (NVDA); free list at /coverage. Unknown: 404, not charged.","example":"ETHUSD"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["1m","5m","15m","1h"],"default":"15m"},"description":"Candle interval: 1m, 5m, 15m or 1h","example":"15m"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Indicators, signals and bias","content":{"application/json":{"schema":{"type":"object","properties":{"sma20":{"type":"number"},"rsi14":{"type":"number"},"macd":{"type":"object","properties":{"histogram":{"type":"number"},"signal":{"type":"number"},"macd":{"type":"number"}},"additionalProperties":true},"sma50":{"type":"number"},"bias":{"type":"string"},"symbol":{"type":"string"},"interval":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"sma20":2661.2,"rsi14":61.4,"macd":{"histogram":0.81,"signal":2.4,"macd":3.21},"sma50":2644.9,"bias":"BULLISH","symbol":"ETHUSD","interval":"15m"}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_technical_indicators"}},"/api/v1/markets/stablecoin-flows":{"get":{"operationId":"getStablecoinFlows","summary":"Get net stablecoin issuance per chain","description":"Net issuance (mint minus burn read on chain) of USDC, USDT, USDT0 and USDG for the last 24h and 7d, per token and chain, the hourly series of the last 48h and a NET_ISSUANCE / NET_REDEMPTION signal.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Issuance totals, per chain and hourly series","content":{"application/json":{"schema":{"type":"object","properties":{"signal":{"type":"string"},"last24h":{"type":"object","properties":{"netIssuanceUsd":{"type":"integer"},"mintedUsd":{"type":"integer"},"burnedUsd":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"signal":"NET_ISSUANCE","last24h":{"netIssuanceUsd":224000000,"mintedUsd":412000000,"burnedUsd":188000000}}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_stablecoin_flows"}},"/api/v1/markets/funding-rates":{"get":{"operationId":"getFundingRates","summary":"Get perpetual funding rates and open interest","description":"Latest funding rate (annualised) and open interest of perpetual futures markets: Hyperliquid (public API; crypto and HIP-3 stock, index, commodity and FX perps over $5M open interest; order book, so no long share), GMX v2 and gTrade (on chain, with long share). Largest absolute funding first.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Perp markets with funding and open interest","content":{"application/json":{"schema":{"type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"fundingRateAnnualPercent":{"type":"number"},"openInterestUsd":{"type":"integer"},"longSharePercent":{"type":"number"},"venue":{"type":"string"},"symbol":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"markets":[{"fundingRateAnnualPercent":14.2,"openInterestUsd":48200000,"longSharePercent":61.5,"venue":"gmx_v2","symbol":"ETHUSD"}]}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_funding_rates"}},"/api/v1/markets/risk":{"get":{"operationId":"getMarketRisk","summary":"Get a 0-100 risk-on or risk-off market score","description":"One risk-on/risk-off score: starts at 50 and adds the effect of the trade-flow regime, stablecoin issuance, the Treasury 2s10s curve, tokenized treasury flows, perp crowding and macro releases in the next 24h. Each component is returned with its reading and effect.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Risk score, label and components","content":{"application/json":{"schema":{"type":"object","properties":{"components":{"type":"array","items":{"type":"object","properties":{"effect":{"type":"integer"},"reading":{"type":"integer"},"component":{"type":"string"}},"additionalProperties":true}},"riskScore":{"type":"integer"},"label":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"components":[{"effect":10,"reading":224000000,"component":"stablecoin_issuance_24h"}],"riskScore":55,"label":"NEUTRAL"}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_market_risk"}},"/api/v1/markets/gas":{"get":{"operationId":"getGasFees","summary":"Get gas fees and transaction costs per EVM chain","description":"Base fee, priority fee percentiles (eth_feeHistory) and gas price of each covered EVM chain from public RPC, with the USD cost of a 21k-gas transfer and a 150k-gas swap. L2 costs exclude the L1 data fee.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Gas fees per chain","content":{"application/json":{"schema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"object","properties":{"swapCostUsd":{"type":"number"},"transferCostUsd":{"type":"number"},"nativeToken":{"type":"string"},"baseFeeGwei":{"type":"number"},"chain":{"type":"string"},"gasPriceGwei":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chains":[{"swapCostUsd":0.00368,"transferCostUsd":5.15E-4,"nativeToken":"ETH","baseFeeGwei":0.0071,"chain":"base","gasPriceGwei":0.0092}]}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_gas_fees"}},"/api/v1/sec/form-144/{symbol}":{"get":{"operationId":"getForm144","summary":"Get proposed insider sales from SEC Form 144","description":"SEC Form 144 notices of proposed sales by officers, directors and 10% holders of a US-listed company over the last days (1-365, latest 25 parsed): seller, relationship, units, market value, percent of outstanding and approximate sale date, with totals and top sellers.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged.","example":"AAPL"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365,"default":90},"description":"Look-back period in days","example":90}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Notices, totals and top sellers","content":{"application/json":{"schema":{"type":"object","properties":{"plannedSaleUsd":{"type":"integer"},"noticesInPeriod":{"type":"integer"},"periodDays":{"type":"integer"},"symbol":{"type":"string"},"distinctSellers":{"type":"integer"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"plannedSaleUsd":182400000,"noticesInPeriod":14,"periodDays":90,"symbol":"NVDA","distinctSellers":5}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_form_144"}},"/api/v1/sec/ownership/{symbol}":{"get":{"operationId":"getBeneficialOwnership","summary":"Get 13D and 13G holders above five percent","description":"SEC Schedule 13D (activist intent) and 13G (passive) filings of holders above 5% of a US-listed company over the last days (1-1095): holder names, type of reporting person and percent of class from structured filings, with an activist flag.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged.","example":"AAPL"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1095,"default":365},"description":"Look-back period in days","example":365}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"13D/13G filings and holders","content":{"application/json":{"schema":{"type":"object","properties":{"filingsInPeriod":{"type":"integer"},"symbol":{"type":"string"},"activistFilings13D":{"type":"integer"},"filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"holders":{"type":"array","items":{"type":"object","properties":{"percentOfClass":{"type":"number"},"name":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"filingsInPeriod":2,"symbol":"AAPL","activistFilings13D":0,"filings":[{"form":"SCHEDULE 13G/A","holders":[{"percentOfClass":9.3,"name":"Vanguard Group Inc"}]}]}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_beneficial_ownership"}},"/api/v1/sec/dividends/{symbol}":{"get":{"operationId":"getDividends","summary":"Get dividends per share, growth and yield","description":"Quarterly dividends declared per share from SEC XBRL filings (CommonStockDividendsPerShareDeclared): latest quarter, trailing four-quarter total, year-over-year growth and trailing yield at the tokenized-stock price.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged.","example":"AAPL"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Dividend history, growth and yield","content":{"application/json":{"schema":{"type":"object","properties":{"trailing4QuartersPerShare":{"type":"number"},"symbol":{"type":"string"},"trailingYieldPercent":{"type":"number"},"growthYoYPercent":{"type":"number"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"trailing4QuartersPerShare":3.32,"symbol":"MSFT","trailingYieldPercent":0.66,"growthYoYPercent":10.3}}}},"400":{"description":"Invalid symbol (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_dividends"}},"/api/v1/decision":{"get":{"operationId":"getDecision","summary":"Get a trading decision for a symbol or the market","description":"Premium decision: order flow, technicals, smart money, SEC fundamentals, insider trades and Form 144, perp positioning, the market risk gauge and news are scored -100..100 per pillar and combined into an action (STRONG_BUY, BUY, ACCUMULATE, HOLD, REDUCE, SELL, STRONG_SELL) with conviction, a volatility-sized trade plan (ATR stop, two targets, max position size), execution checks, risks and what would change the view. Without symbol: market-wide stance, allocation and the best long, short and smart-money setups. With an ISIN: European issuer decision from short interest, ESEF fundamentals and euro macro. Every response lists each module's status (available, no_data, stale, timeout, not_applicable, skipped), source and observation time, the conflicting signals, and cheaper next calls with their price. Results are cached for 30 seconds.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional ticker (ETHUSD, NVDA) or ISIN; omit for the market-wide decision","example":"ETHUSD"},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"]},"description":"Optional side to get a GO / GO_SMALL / WAIT / NO_GO answer","example":"buy"},{"name":"include","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["order_flow","technicals","smart_money","fundamentals","insiders","derivatives_positioning","market_risk","news","execution","track_record"]}},"style":"form","explode":false,"description":"Modules to use, comma-separated (default all): order_flow, technicals, smart_money, fundamentals, insiders, derivatives_positioning, market_risk, news, execution, track_record","example":["order_flow","technicals"]},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["detailed","compact"],"default":"detailed"},"description":"compact drops evidence text and method to save LLM context","example":"detailed"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"1.00"}},"responses":{"200":{"description":"Action, conviction, pillars and trade plan","content":{"application/json":{"schema":{"type":"object","properties":{"stance":{"type":"string"},"bestLongSetups":{"type":"array","items":{"type":"object","properties":{"independentSourcesConfirming":{"type":"integer"},"symbol":{"type":"string"},"direction":{"type":"string"},"score":{"type":"integer"}},"additionalProperties":true}},"riskScore":{"type":"integer"},"scope":{"type":"string"},"allocation":{"type":"object","properties":{"stablecoinsOrCashPercent":{"type":"integer"},"guidance":{"type":"string"},"riskAssetsPercent":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"stance":"RISK_ON","bestLongSetups":[{"independentSourcesConfirming":2,"symbol":"UNIUSD","direction":"BULLISH","score":75}],"riskScore":60,"scope":"market","allocation":{"stablecoinsOrCashPercent":30,"guidance":"Lean into momentum and accumulation setups; normal position sizes.","riskAssetsPercent":70}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_decision"}},"/api/v1/gifts/config":{"get":{"operationId":"getGiftLinksConfig","summary":"Get the gift links contract, chain and fee","description":"Free. Gift links send USDC by link or QR code: the sender locks the amount in a contract with no owner or admin (create at /gift), the link carries a one-time key, and whoever holds it claims the whole gift to their own wallet. Gifts are 0.01 to 10 000 USDC; the sender pays a 1% fee on top, kept only when the gift is claimed: a cancelled or expired gift goes back to the sender with the fee. Addresses on the OFAC SDN list are refused. This server never holds the money or the key. USDC on Base.","tags":["Agent Tools"],"security":[],"responses":{"200":{"description":"Contract address, chain id, token, fee percent and explorer","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_gift_link"}},"/api/v1/gifts/{key}":{"get":{"operationId":"getGiftLinkStatus","summary":"Get the status of a gift link","description":"Free. What the chain says about the gift locked under a link key: OPEN (claimable, with the amount the recipient gets, the 1% fee and the expiry), EXPIRED (can only go back to the sender), CLOSED (claimed or cancelled) or NOT_FOUND.","tags":["Agent Tools"],"security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"The address of the gift link key (the part after /gift/ in the link)","example":"0x1d2667Bcf4a8cC09d7c0d606F4Aa6B3ce6c5b3b3"}],"responses":{"200":{"description":"Gift status","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Not an address"},"503":{"description":"Chain not answering or not deployed"}},"x-mcp-tool":"get_gift_link"}},"/api/v1/decision/track-record":{"get":{"operationId":"getDecisionTrackRecord","summary":"Get the live hit rates of the trading decisions","description":"Free. Every full symbol decision (paid, or computed hourly for the main symbols) is logged with its price; hit = the traded price moved in the decision's direction after 1h, 4h and 24h. Returns hit rates and the mean return in the decision's direction per horizon, per action and per conviction bucket, and the latest decisions with outcomes. Rates are withheld below 30 evaluated decisions; nothing is back-filled.","tags":["Agent Tools"],"security":[],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":400,"default":30},"description":"Look-back period in days","example":30},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional symbol, e.g. ETHUSD","example":"ETHUSD"}],"responses":{"200":{"description":"Hit rates, calibration and recent decisions","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_decision_track_record"}},"/api/v1/decision/{symbol}":{"get":{"operationId":"getDecisionForSymbol","summary":"Get a trading decision for one symbol","description":"Premium decision: order flow, technicals, smart money, SEC fundamentals, insider trades and Form 144, perp positioning, the market risk gauge and news are scored -100..100 per pillar and combined into an action (STRONG_BUY, BUY, ACCUMULATE, HOLD, REDUCE, SELL, STRONG_SELL) with conviction, a volatility-sized trade plan (ATR stop, two targets, max position size), execution checks, risks and what would change the view. Without symbol: market-wide stance, allocation and the best long, short and smart-money setups. With an ISIN: European issuer decision from short interest, ESEF fundamentals and euro macro. Every response lists each module's status (available, no_data, stale, timeout, not_applicable, skipped), source and observation time, the conflicting signals, and cheaper next calls with their price. Results are cached for 30 seconds.","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Crypto pair (ETHUSD), US ticker (NVDA) or ISIN (FR0000131906): any symbol covered by at least one source (/coverage, SEC, ESEF).","example":"ETHUSD"},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"]},"description":"Optional side to get a GO / GO_SMALL / WAIT / NO_GO answer","example":"buy"},{"name":"include","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["order_flow","technicals","smart_money","fundamentals","insiders","derivatives_positioning","market_risk","news","execution","track_record"]}},"style":"form","explode":false,"description":"Modules to use, comma-separated (default all): order_flow, technicals, smart_money, fundamentals, insiders, derivatives_positioning, market_risk, news, execution, track_record","example":["order_flow","technicals"]},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["detailed","compact"],"default":"detailed"},"description":"compact drops evidence text and method to save LLM context","example":"detailed"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"1.00"}},"responses":{"200":{"description":"Action, conviction, pillars and trade plan","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"compositeScore":{"type":"number"},"conviction":{"type":"integer"},"action":{"type":"string"},"tradePlan":{"type":"object","properties":{"target1":{"type":"number"},"referencePrice":{"type":"number"},"stopLoss":{"type":"number"},"maxPositionPercentOfEquity":{"type":"number"}},"additionalProperties":true},"symbol":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"answer":"GO_SMALL","compositeScore":24.5,"conviction":52,"action":"ACCUMULATE","tradePlan":{"target1":2712.1,"referencePrice":2656.7,"stopLoss":2601.3,"maxPositionPercentOfEquity":12.4},"symbol":"ETHUSD"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_decision"}},"/api/v1/decision/batch":{"post":{"operationId":"postDecisionBatch","summary":"Get trading decisions for up to five symbols","description":"The same decision as GET for several symbols in one call (1-5), computed in parallel, with a ranking from most bullish to most bearish and per-symbol errors instead of failing the whole request. Priced separately: $3 for up to 5 symbols ($0.60 per symbol at 5).","tags":["Agent Tools"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"3.00"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["symbols"],"additionalProperties":false,"properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5,"description":"Crypto pairs (ETHUSD), US tickers (NVDA) or ISINs"},"side":{"type":"string","enum":["buy","sell"],"description":"Optional side for a GO / GO_SMALL / WAIT / NO_GO answer"},"include":{"type":"array","items":{"type":"string","enum":["order_flow","technicals","smart_money","fundamentals","insiders","derivatives_positioning","market_risk","news","execution","track_record"]},"description":"Modules to use (default all)"},"format":{"type":"string","enum":["detailed","compact"],"default":"detailed","description":"compact drops evidence text"}}},"example":{"symbols":["ETHUSD","NVDA","BTCUSD"],"side":"buy","format":"compact"}}}},"responses":{"200":{"description":"Action, conviction, pillars and trade plan","content":{"application/json":{"schema":{"type":"object","properties":{"ranking":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"action":{"type":"string"},"compositeScore":{"type":"number"},"conviction":{"type":"integer"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"ranking":[{"symbol":"NVDA","action":"ACCUMULATE","compositeScore":21.4,"conviction":38},{"symbol":"ETHUSD","action":"SELL","compositeScore":-45.0,"conviction":72}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_decisions_batch"}},"/api/v1/eu/fx":{"get":{"operationId":"getEuroFxRates","summary":"Get ECB euro reference exchange rates","description":"Euro foreign exchange reference rates of the ECB for about 30 currencies (units per 1 EUR) with the date and the change vs the previous fixing. Source: European Central Bank.","tags":["European Markets"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Rates per currency","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"rates":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"rate":{"type":"number"},"changePercent":{"type":"number"},"pair":{"type":"string"}},"additionalProperties":true}},"base":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"date":"2026-09-25","rates":[{"currency":"USD","rate":1.1712,"changePercent":-0.214,"pair":"EURUSD"}],"base":"EUR"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_euro_fx_rates"}},"/api/v1/eu/rates":{"get":{"operationId":"getEuroRates","summary":"Get euro yield curves, ECB rates and spreads","description":"Euro area government spot yield curves (AAA-rated and all issuers; 3M, 1Y, 2Y, 5Y, 10Y, 20Y, 30Y) with daily change in bps, 2s10s and 3m10y slopes, the key ECB rates (deposit facility, main refinancing, marginal lending) and monthly 10-year sovereign yields per country with the spread vs Germany. Source: European Central Bank.","tags":["European Markets"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Curves, key rates and sovereign yields","content":{"application/json":{"schema":{"type":"object","properties":{"curves":{"type":"object","properties":{"aaa":{"type":"object","properties":{"inverted2s10s":{"type":"boolean"},"slope2s10sBps":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"ecbKeyRatesPercent":{"type":"object","properties":{"depositFacilityRate":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"curves":{"aaa":{"inverted2s10s":false,"slope2s10sBps":68.4}},"ecbKeyRatesPercent":{"depositFacilityRate":2.5}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_euro_rates"}},"/api/v1/eu/macro":{"get":{"operationId":"getEuroMacro","summary":"Get EU inflation and unemployment per country","description":"Latest annual HICP inflation (ECOICOP ver.2, all items) and seasonally adjusted unemployment rate for each EU country, the euro area and the EU, with the previous month. Source: Eurostat (CC BY 4.0).","tags":["European Markets"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Macro indicators per country","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object","properties":{"inflationPercent":{"type":"object","properties":{"period":{"type":"string"},"previous":{"type":"number"},"value":{"type":"number"}},"additionalProperties":true},"geo":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"countries":[{"inflationPercent":{"period":"2026-08","previous":2.0,"value":2.1},"geo":"EA"}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_euro_macro"}},"/api/v1/eu/short-positions":{"get":{"operationId":"getMostShortedEuropean","summary":"Get the most shorted European stocks","description":"Issuers supervised by the French AMF (mostly Euronext Paris) ranked by the sum of disclosed net short positions (0.5% of capital or more, EU Short Selling Regulation): total, 30-day change in percentage points, number of funds short, largest holder and last change. Source: AMF via data.gouv.fr (Licence Ouverte 2.0).","tags":["European Markets"],"security":[{},{"siwx":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"Maximum number of issuers","example":25}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Ranked issuers","content":{"application/json":{"schema":{"type":"object","properties":{"mostShorted":{"type":"array","items":{"type":"object","properties":{"change30dPercentPoints":{"type":"number"},"issuer":{"type":"string"},"disclosedShortPercent":{"type":"number"},"isin":{"type":"string"},"holders":{"type":"integer"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"mostShorted":[{"change30dPercentPoints":0.6,"issuer":"VALEO","disclosedShortPercent":9.8,"isin":"FR0013176526","holders":11}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_most_shorted_european"}},"/api/v1/eu/short-positions/{issuer}":{"get":{"operationId":"getEuropeanShortPositions","summary":"Get funds short one European stock","description":"Disclosed net short positions of one issuer (ISIN or part of the name): each fund with percent of capital and start date, the total, weekly history over the last days, the latest 15 changes and a signal (HEAVILY_SHORTED, SHORTS_BUILDING, SHORTS_COVERING, SHORTED). Source: AMF via data.gouv.fr (Licence Ouverte 2.0).","tags":["European Markets"],"security":[{},{"siwx":[]}],"parameters":[{"name":"issuer","in":"path","required":true,"schema":{"type":"string"},"description":"Any issuer in the AMF short-position disclosures, by ISIN (FR0000131906) or name (Renault). Unknown: 404, not charged.","example":"FR0000131906"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":7,"maximum":730,"default":90},"description":"Look-back period in days","example":90}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Holders, history and signal","content":{"application/json":{"schema":{"type":"object","properties":{"issuer":{"type":"string"},"signal":{"type":"string"},"isin":{"type":"string"},"disclosedShortPercent":{"type":"number"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"issuer":"RENAULT","signal":"SHORTS_BUILDING","isin":"FR0000131906","disclosedShortPercent":4.1}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_european_short_positions"}},"/api/v1/eu/fundamentals/{company}":{"get":{"operationId":"getEuropeanFundamentals","summary":"Get IFRS fundamentals of a European company","description":"Revenue, operating profit, net income, EPS, assets, liabilities, equity, cash, operating cash flow, capex and dividends paid from the latest ESEF annual report (IFRS inline XBRL) of a European listed company, with the prior year, growth, margins, ROE, equity ratio, free cash flow, a 0-100 score and a link to the report. Found by LEI, ISIN (via GLEIF) or name.","tags":["European Markets"],"security":[{},{"siwx":[]}],"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"},"description":"Any issuer with an ESEF annual report, by LEI, ISIN or name (RENAULT, TotalEnergies). Unknown: 404, not charged.","example":"RENAULT"}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Figures, ratios and score","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"lei":{"type":"string"},"country":{"type":"string"},"fiscalYearEnd":{"type":"string"},"currency":{"type":"string"},"figures":{"type":"object","properties":{"cash":{"type":"number"},"operatingCashFlow":{"type":"number"},"revenue":{"type":"number"},"equity":{"type":"number"},"totalAssets":{"type":"number"},"epsBasic":{"type":"number"},"netIncome":{"type":"number"},"operatingProfit":{"type":"number"}},"additionalProperties":true},"priorYear":{"type":"object","properties":{"revenue":{"type":"number"},"netIncome":{"type":"number"}},"additionalProperties":true},"ratios":{"type":"object","properties":{"returnOnEquityPercent":{"type":"number"},"operatingMarginPercent":{"type":"number"},"netMarginPercent":{"type":"number"},"revenueGrowthPercent":{"type":"number"},"equityRatioPercent":{"type":"number"}},"additionalProperties":true},"fundamentalScore":{"type":"integer"},"signal":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"reportUrl":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"company":"RENAULT","lei":"969500F7JLTX36OUI695","country":"FR","fiscalYearEnd":"2025-12-31","currency":"EUR","figures":{"cash":2.0014E10,"operatingCashFlow":2.339E9,"revenue":5.7922E10,"equity":2.0791E10,"totalAssets":1.2101E11,"epsBasic":-39.99,"netIncome":-1.0931E10,"operatingProfit":-7.867E9},"priorYear":{"revenue":5.6232E10,"netIncome":7.52E8},"ratios":{"returnOnEquityPercent":-52.58,"operatingMarginPercent":-13.58,"netMarginPercent":-18.87,"revenueGrowthPercent":3.01,"equityRatioPercent":17.18},"fundamentalScore":35,"signal":"WEAK","reasons":["revenue +3.01%","net margin -18.87%","ROE -52.58%","free cash flow positive"],"reportUrl":"https://filings.xbrl.org/969500F7JLTX36OUI695/2025-12-31/ESEF/FR/0/renault-2025-12-31-0-fr/reports/ixbrlviewer.html"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this request (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"charged":{"type":"boolean","example":false}}}}}},"503":{"description":"Source temporarily unavailable (not charged)"}},"x-mcp-tool":"get_european_fundamentals"}},"/api/v1/alerts":{"get":{"operationId":"getAlertCatalog","summary":"Webhook alert events, filters, pack and signing (free)","tags":["Agent Tools"],"security":[],"description":"Free. Lists the events that can be pushed to a webhook, their filters, the prepaid pack (price, days, deliveries), the delivery format and how to verify the HMAC-SHA256 signature.","responses":{"200":{"description":"Alert catalog","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"manage_alert_subscription"}},"/api/v1/alerts/subscriptions":{"post":{"operationId":"subscribeAlerts","summary":"Subscribe a webhook to market alerts (prepaid pack)","tags":["Agent Tools"],"description":"Push instead of polling. One x402 payment buys a pack of 7 days and up to 200 deliveries to your public HTTPS URL; the pack starts when the payment settles. Events: decision_change (the hourly decision of a symbol with live on-chain trading, about 40, changed action), unusual_flow (non-normal 5m trade-flow event with confidence >= 60, at most hourly per symbol), funding_extreme (a Hyperliquid perp with over $5M open interest reaches >= 50%/yr or <= -25%/yr funding), news (classified news or filing with materiality >= minMateriality, default 4 of 5; filter by categories and symbols) token_risk_change (the verdict or sell simulation of up to 5 watched tokens changed; checked every 30 minutes) and stablecoin_depeg (a dollar stablecoin reaches WATCH at 30 bps or DEPEG at 100 bps; checked every 5 minutes). Each delivery is a JSON POST {id, subscriptionId, event, symbol, occurredAt, data, deliveriesLeft, expiresAt} with headers X-MI-Event, X-MI-Delivery, X-MI-Timestamp and X-MI-Signature = sha256=hex(HMAC_SHA256(secret, timestamp + \".\" + body)). A 2xx within 10 s counts as delivered; failures are retried after 30 s and 5 min and do not use up the pack. After 50 failures in a row the subscription is suspended until POST /{id}/resume; missed events can be fetched from GET /{id}/events. Private, loopback and non-HTTPS URLs are refused and redirects are not followed.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","events"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Public HTTPS URL that receives the POSTs"},"events":{"type":"array","minItems":1,"items":{"type":"string","enum":["decision_change","unusual_flow","funding_extreme","news","token_risk_change","stablecoin_depeg","sec_filing","prediction_market_move"]}},"symbols":{"type":"array","maxItems":25,"items":{"type":"string"},"description":"Only these symbols (empty = all)"},"tokens":{"type":"array","maxItems":5,"description":"For token_risk_change","items":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"ERC-20 contract (0x...) or Solana mint"},"chain":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","solana"],"description":"Default base (solana for a base58 mint)"}}}},"categories":{"type":"array","items":{"type":"string","enum":["crypto","stocks","europe","policy","filings"]},"description":"News categories (empty = all)"},"minMateriality":{"type":"integer","minimum":1,"maximum":5,"default":4},"description":{"type":"string","maxLength":200},"forms":{"type":"array","maxItems":10,"items":{"type":"string","enum":["4","8-K","144","SC 13D","SC 13G","10-Q","10-K","S-1","DEF 14A"]},"description":"For sec_filing: only these SEC forms (default all). sec_filing needs symbols (US tickers)."}}},"example":{"url":"https://your-agent.example.com/hooks/market","events":["decision_change","funding_extreme"],"symbols":["ETHUSD","BTCUSD","NVDA"]}}}},"responses":{"200":{"description":"The subscription with its secret (shown only once)","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending","active","used_up","expired","cancelled","suspended"]},"secret":{"type":"string","description":"Only in the response to the subscribe call"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["decision_change","unusual_flow","funding_extreme","news","token_risk_change","stablecoin_depeg","sec_filing","prediction_market_move"]}},"symbols":{"type":"array","items":{"type":"string"}},"tokens":{"type":"array","items":{"type":"object"}},"categories":{"type":"array","items":{"type":"string"}},"minMateriality":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"deliveriesLeft":{"type":"integer"},"delivered":{"type":"integer"},"manage":{"type":"object"},"recentDeliveries":{"type":"array","items":{"type":"object"}}}},"example":{"secret":"whsec_...","expiresAt":"2026-10-06T08:00:00Z","events":["decision_change","funding_extreme"],"id":"sub_3f9c2a61d0b84e5a9c7e1f20","status":"active","deliveriesLeft":200}}}},"400":{"description":"Invalid request (nothing is charged)"},"402":{"description":"Payment Required, or the payment did not settle (nothing activated)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"subscribe_alerts"}},"/api/v1/alerts/subscriptions/{id}":{"get":{"operationId":"getAlertSubscription","summary":"Status of a webhook subscription (free)","tags":["Agent Tools"],"security":[],"description":"Free with the subscription secret: status, deliveries left, expiry, last error and the last 20 deliveries.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"description":"Subscription id","example":"sub_3f9c2a61d0b84e5a9c7e1f20"},{"name":"X-Alert-Secret","in":"header","required":true,"schema":{"type":"string"},"description":"The secret returned when subscribing","example":"whsec_..."}],"responses":{"200":{"description":"Subscription","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending","active","used_up","expired","cancelled","suspended"]},"secret":{"type":"string","description":"Only in the response to the subscribe call"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["decision_change","unusual_flow","funding_extreme","news","token_risk_change","stablecoin_depeg","sec_filing","prediction_market_move"]}},"symbols":{"type":"array","items":{"type":"string"}},"tokens":{"type":"array","items":{"type":"object"}},"categories":{"type":"array","items":{"type":"string"}},"minMateriality":{"type":"integer"},"expiresAt":{"type":"string","format":"date-time"},"deliveriesLeft":{"type":"integer"},"delivered":{"type":"integer"},"manage":{"type":"object"},"recentDeliveries":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Invalid request"},"404":{"description":"Subscription not found or wrong secret"}},"x-mcp-tool":"manage_alert_subscription"},"delete":{"operationId":"cancelAlertSubscription","summary":"Cancel a webhook subscription (free)","tags":["Agent Tools"],"security":[],"description":"Free with the subscription secret. Stops all deliveries.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"description":"Subscription id","example":"sub_3f9c2a61d0b84e5a9c7e1f20"},{"name":"X-Alert-Secret","in":"header","required":true,"schema":{"type":"string"},"description":"The secret returned when subscribing","example":"whsec_..."}],"responses":{"200":{"description":"Cancelled","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"404":{"description":"Subscription not found or wrong secret"}},"x-mcp-tool":"manage_alert_subscription"}},"/api/v1/alerts/subscriptions/{id}/test":{"post":{"operationId":"testAlertSubscription","summary":"Send a signed test delivery (free)","tags":["Agent Tools"],"security":[],"description":"Free with the subscription secret: sends a signed \"ping\" event to the URL now and returns the HTTP status; does not use up the pack.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"description":"Subscription id","example":"sub_3f9c2a61d0b84e5a9c7e1f20"},{"name":"X-Alert-Secret","in":"header","required":true,"schema":{"type":"string"},"description":"The secret returned when subscribing","example":"whsec_..."}],"responses":{"200":{"description":"Delivery result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"404":{"description":"Subscription not found or wrong secret"}},"x-mcp-tool":"manage_alert_subscription"}},"/api/v1/decision/lite":{"get":{"operationId":"getDecisionLite","summary":"Cheap live trading decision","tags":["Agent Tools"],"description":"Cheap live decision ($0.05): the same engine as /api/v1/decision/{symbol} ($1), reduced to action (STRONG_BUY, BUY, ACCUMULATE, HOLD, REDUCE, SELL, STRONG_SELL), direction, conviction, compositeScore, a GO/GO_SMALL/WAIT/NO_GO answer when side is given, reference price, the stance and score of each pillar (order flow, technicals, smart money, fundamentals, insiders, perp positioning, market risk, news) and the measured 30-day hit rate. Without the trade plan, execution check, evidence and risks. Crypto pairs, US tickers or ISINs. Free delayed sample: /api/v1/decision/sample.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Crypto pair (ETHUSD), US ticker (NVDA) or ISIN","example":"ETHUSD"},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"]},"description":"Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side","example":"buy"}],"responses":{"200":{"description":"Lite decision","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"conviction":{"type":"integer"},"direction":{"type":"string"},"action":{"type":"string"},"pillars":{"type":"array","items":{"type":"object","properties":{"score":{"type":"integer"},"stance":{"type":"string"},"pillar":{"type":"string"}},"additionalProperties":true}},"symbol":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"answer":"GO_SMALL","conviction":39,"direction":"BULLISH","action":"ACCUMULATE","pillars":[{"score":30,"stance":"BULLISH","pillar":"order_flow"}],"symbol":"ETHUSD"}}}},"400":{"description":"Invalid symbol"},"402":{"description":"Payment Required"},"404":{"description":"No data for the symbol (not charged)"}},"x-mcp-tool":"get_decision_lite"}},"/api/v1/decision/lite/{symbol}":{"get":{"operationId":"getDecisionLiteForSymbol","summary":"Cheap live trading decision for one symbol","tags":["Agent Tools"],"description":"Cheap live decision ($0.05): the same engine as /api/v1/decision/{symbol} ($1), reduced to action (STRONG_BUY, BUY, ACCUMULATE, HOLD, REDUCE, SELL, STRONG_SELL), direction, conviction, compositeScore, a GO/GO_SMALL/WAIT/NO_GO answer when side is given, reference price, the stance and score of each pillar (order flow, technicals, smart money, fundamentals, insiders, perp positioning, market risk, news) and the measured 30-day hit rate. Without the trade plan, execution check, evidence and risks. Crypto pairs, US tickers or ISINs. Free delayed sample: /api/v1/decision/sample.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Crypto pair (ETHUSD), US ticker (NVDA) or ISIN (FR0000131906): any symbol covered by at least one source (/coverage, SEC, ESEF).","example":"ETHUSD"},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"]},"description":"Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side","example":"buy"}],"responses":{"200":{"description":"Lite decision","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"conviction":{"type":"integer"},"direction":{"type":"string"},"action":{"type":"string"},"pillars":{"type":"array","items":{"type":"object","properties":{"score":{"type":"integer"},"stance":{"type":"string"},"pillar":{"type":"string"}},"additionalProperties":true}},"symbol":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"answer":"GO_SMALL","conviction":39,"direction":"BULLISH","action":"ACCUMULATE","pillars":[{"score":30,"stance":"BULLISH","pillar":"order_flow"}],"symbol":"ETHUSD"}}}},"400":{"description":"Invalid symbol"},"402":{"description":"Payment Required"},"404":{"description":"No data for the symbol (not charged)"}},"x-mcp-tool":"get_decision_lite"}},"/api/v1/decision/sample":{"get":{"operationId":"getDecisionSample","summary":"Free delayed sample of the decision with its outcome","tags":["Agent Tools"],"security":[],"description":"Free. The latest hourly decision (action, direction, conviction, composite score, pillar scores, price) of every symbol with live on-chain trading (about 40, listed at /api/v1/datasets), delayed at least one hour, with the price change 1h, 4h and 24h later and whether it moved in the decision direction. Judge the decisions before buying a live one.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional; omit for every symbol","example":"ETHUSD"}],"responses":{"200":{"description":"Delayed decisions with outcomes","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No delayed decision for that symbol"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_decision_sample"}},"/api/v1/alerts/subscriptions/{id}/events":{"get":{"operationId":"getAlertEvents","summary":"Catch up on missed webhook events (free with the secret)","tags":["Agent Tools"],"security":[],"description":"Events of the subscription since a time (default 24 hours, at most 14 days), oldest first, with their full payloads and delivery status: lets a subscriber whose endpoint was down catch up without polling the paid routes. Events that were not delivered count against the pack when first fetched here, so the pack is the same whether events are pushed or pulled; those beyond what is left are withheld. Up to 100 per call; follow next.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"description":"Subscription id","example":"sub_3f9c2a61d0b84e5a9c7e1f20"},{"name":"X-Alert-Secret","in":"header","required":true,"schema":{"type":"string"},"description":"The secret returned when subscribing","example":"whsec_..."},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Endpoint query parameter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"example":100,"description":"Maximum number of results to return"}],"responses":{"200":{"description":"Events with payloads","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid since"},"404":{"description":"Subscription not found or wrong secret"}},"x-mcp-tool":"manage_alert_subscription"}},"/api/v1/alerts/subscriptions/{id}/resume":{"post":{"operationId":"resumeAlertSubscription","summary":"Resume a suspended webhook subscription (free)","tags":["Agent Tools"],"security":[],"description":"After 50 failed deliveries in a row a subscription is suspended (its events are still kept for /events). Resume re-activates it once the endpoint works, optionally at a new URL.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"description":"Subscription id","example":"sub_3f9c2a61d0b84e5a9c7e1f20"},{"name":"X-Alert-Secret","in":"header","required":true,"schema":{"type":"string"},"description":"The secret returned when subscribing","example":"whsec_..."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Subscription","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Not resumable (expired, cancelled, used up) or URL rejected"},"404":{"description":"Subscription not found or wrong secret"}},"x-mcp-tool":"manage_alert_subscription"}},"/api/v1/intelligence/new-tokens":{"get":{"operationId":"getNewTokens","summary":"Tokens launched in the last hour, already risk-checked","tags":["Agent Tools"],"description":"Every new pool against ETH, WETH or USDC (USDT on Ethereum) created on Uniswap v2, v3, v4 or Aerodrome on Base or Ethereum, newest first. About five minutes after its pool is created each token gets the full token-risk check (liquidity, buy and sell simulation, admin functions, observed tax, Uniswap v4 hook powers decoded from the hook address) and a verdict (LOW_RISK, CAUTION, HIGH_RISK) with a 0-100 safety score. By default only checked tokens with at least $1,000 of liquidity are listed; includePending=true also lists pools not checked yet. Uniswap v4 liquidity is the in-range depth from StateView, an approximation. Most new tokens lose value quickly; automated checks, not an audit.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum"],"default":"base"},"description":"Chain to scan for new pools: base or ethereum. Not the payment network: payment networks are in x-payment-info.networks.","example":"base"},{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":1440,"default":60},"description":"Look-back window in minutes","example":60},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"description":"Maximum tokens","example":30},{"name":"minLiquidityUsd","in":"query","required":false,"schema":{"type":"number","default":1000},"description":"Minimum pool liquidity in USD","example":1000},{"name":"includePending","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Also list pools whose check has not run yet","example":false},{"name":"includeEstablished","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Also list new pools of tokens that already existed a day earlier (new markets, not launches)","example":false},{"name":"verdict","in":"query","required":false,"schema":{"type":"string","enum":["LOW_RISK","CAUTION","HIGH_RISK"]},"description":"Only this verdict","example":"LOW_RISK"}],"responses":{"200":{"description":"New tokens with verdicts","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"windowMinutes":{"type":"integer"},"poolsCreatedInWindow":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"liquidityUsd":{"type":"number"},"sellSimulation":{"type":"string"},"ageMinutes":{"type":"integer"},"safetyScore":{"type":"integer"},"verdict":{"type":"string"},"quote":{"type":"string"},"tokenInfo":{"type":"object","properties":{"symbol":{"type":"string"}},"additionalProperties":true},"token":{"type":"string"},"dex":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chain":"base","windowMinutes":60,"poolsCreatedInWindow":212,"tokens":[{"liquidityUsd":18450.2,"sellSimulation":"OK","ageMinutes":14,"safetyScore":70,"verdict":"CAUTION","quote":"ETH","tokenInfo":{"symbol":"EXAMPLE"},"token":"0x4f...","dex":"uniswap_v4"}]}}}},"400":{"description":"Invalid parameter"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"find_new_tokens"}},"/api/v1/intelligence/quote":{"get":{"operationId":"getSwapQuote","summary":"Swap quote on the best on-chain route","tags":["Agent Tools"],"description":"How much a swap returns right now: every direct route between the two tokens (Uniswap v3 in the 0.01/0.05/0.3/1% tiers, Uniswap v2 or QuickSwap, Aerodrome volatile and stable on Base, Uniswap v4 pools seen by the new-token watcher on Base and Ethereum) and, when neither side is ETH, the best two-hop route through WETH, each simulated with eth_call against the on-chain quoters and reserves at the latest block. Returns the best route with amountOut, price, price impact versus a 1%-size trade and minimumReceived at slippageBps, plus up to five alternatives and warnings (thin pools, unknown tokens to check with token-risk). Quotes are cached 15 s. Nothing is executed.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"],"default":"base"},"description":"Chain the swap is quoted on: base, ethereum, arbitrum, optimism or polygon. Not the payment network: payment networks are in x-payment-info.networks.","example":"base"},{"name":"sell","in":"query","required":true,"schema":{"type":"string"},"description":"Token to sell: ETH, WETH, USDC (USDT on Ethereum) or a 0x token address","example":"USDC"},{"name":"buy","in":"query","required":true,"schema":{"type":"string"},"description":"Token to buy: ETH, WETH, USDC (USDT on Ethereum) or a 0x token address","example":"WETH"},{"name":"amount","in":"query","required":true,"schema":{"type":"string"},"description":"Amount of the sell token in whole units, e.g. 1000 or 0.5","example":"100"},{"name":"slippageBps","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5000,"default":50},"description":"Slippage tolerance for minimumReceived, in basis points","example":50}],"responses":{"200":{"description":"Best route and alternatives","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"buy":{"type":"object","properties":{"symbol":{"type":"string"},"amount":{"type":"string"}},"additionalProperties":true},"best":{"type":"object","properties":{"route":{"type":"object","properties":{"fee":{"type":"integer"}},"additionalProperties":true},"minimumReceived":{"type":"string"},"dex":{"type":"string"},"priceImpactPercent":{"type":"number"}},"additionalProperties":true},"sell":{"type":"object","properties":{"symbol":{"type":"string"},"amount":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"chain":"base","buy":{"symbol":"WETH","amount":"0.3729"},"best":{"route":{"fee":500},"minimumReceived":"0.37108","dex":"uniswap_v3","priceImpactPercent":0.01},"sell":{"symbol":"USDC","amount":"1000"}}}}},"400":{"description":"Invalid parameter (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"get_swap_quote"}},"/api/v1/calendar":{"get":{"operationId":"getMacroCalendar","summary":"Upcoming market-moving macro events","tags":["Agent Tools"],"description":"The next scheduled events that move markets, in UTC, from the official publishers: BLS and BEA release schedules (CPI, Employment Situation, PCE in Personal Income and Outlays, GDP, PPI, JOLTS, ECI, trade and others), FOMC meetings from federalreserve.gov (decision at 14:00 New York time, * = with projections) and ECB monetary policy meetings from ecb.europa.eu (14:15 Frankfurt time). Each event has importance (high: CPI, jobs report, PCE, GDP advance, FOMC, ECB; medium: PPI, JOLTS, ECI, other GDP estimates, trade; low: the rest), region, category and hours until it. Refreshed every six hours. The decision endpoints add an eventRisk block when a high-impact event is less than 24 hours away.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":14},"description":"Days ahead","example":14},{"name":"importance","in":"query","required":false,"schema":{"type":"string","enum":["high","medium","low"],"default":"medium"},"description":"Minimum importance","example":"medium"},{"name":"region","in":"query","required":false,"schema":{"type":"string","enum":["all","us","eu"],"default":"all"},"description":"Region","example":"all"}],"responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"inHours":{"type":"number"},"region":{"type":"string"},"importance":{"type":"string"},"name":{"type":"string"},"at":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"events":[{"inHours":50.5,"region":"us","importance":"high","name":"Consumer Price Index","at":"2026-10-14T12:30:00Z"},{"region":"eu","importance":"high","name":"ECB monetary policy decision and press conference","at":"2026-10-29T12:15:00Z"}]}}}},"400":{"description":"Invalid parameter"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"get_macro_calendar"}},"/api/v1/portfolio/check":{"post":{"operationId":"checkPortfolio","summary":"Risk review of a portfolio in one call","tags":["Agent Tools"],"description":"POST up to 15 positions (symbol with valueUsd, or quantity valued at the latest on-chain price) and up to 5 on-chain tokens (address, chain, valueUsd). Returns a verdict (OK, REVIEW, HIGH_RISK) with flags, concentration (largest weight, Herfindahl, effective positions), Pearson correlations of hourly returns over 7 days on common trading hours, portfolio volatility and a parametric one-day 95% value at risk, the current lite decision of every symbol and the bullish/bearish tilt of the portfolio, the token-risk verdict of each token, and high-impact macro events in the next 24 hours. decisions=false skips the decisions.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"positions":{"type":"array","maxItems":15,"items":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Crypto pair or US stock ticker, e.g. ETHUSD or NVDA"},"valueUsd":{"type":"number"},"quantity":{"type":"number"}}}},"tokens":{"type":"array","maxItems":5,"items":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Token contract address (0x... on EVM chains, a mint on Solana)"},"chain":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","solana"]},"valueUsd":{"type":"number"}}}},"decisions":{"type":"boolean","default":true}}},"example":{"positions":[{"symbol":"ETHUSD","valueUsd":6000},{"symbol":"NVDA","valueUsd":3000},{"symbol":"BTCUSD","quantity":0.02}]}}}},"responses":{"200":{"description":"Portfolio review","content":{"application/json":{"schema":{"type":"object","properties":{"risk":{"type":"object","properties":{"oneDayValueAtRisk95Percent":{"type":"number"},"volatilityAnnualPercent":{"type":"number"}},"additionalProperties":true},"decisionTilt":{"type":"object","properties":{"bearishPercent":{"type":"number"},"bullishPercent":{"type":"number"}},"additionalProperties":true},"totalValueUsd":{"type":"number"},"flags":{"type":"array","items":{"type":"string"}},"verdict":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"risk":{"oneDayValueAtRisk95Percent":6.1,"volatilityAnnualPercent":58.3},"decisionTilt":{"bearishPercent":0.0,"bullishPercent":80.4},"totalValueUsd":11200.0,"flags":["WARN: ETHUSD is 54% of the portfolio; one move decides the result"],"verdict":"REVIEW"}}}},"400":{"description":"Invalid body (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"check_portfolio"}},"/api/v1/markets/stablecoins":{"get":{"operationId":"getStablecoinPegs","summary":"Peg of the main dollar stablecoins","tags":["Agent Tools"],"description":"Every 5 minutes: USDT, DAI, USDS, USDe, PYUSD, GHO, crvUSD, RLUSD, USD1, FDUSD priced by the best Ethereum DEX route for a $100 sale into USDC (Uniswap v2/v3/v4, direct or via WETH) adjusted by Chainlink USDC/USD, the price impact of a $100,000 sale as depth, Chainlink USD prices where a feed exists (USDC, USDT, DAI, USDe, PYUSD), the deviation in basis points and a status: PEGGED (< 30 bps), WATCH (30-100 bps), DEPEG (> 100 bps, not contradicted by the oracle) or THIN_MARKET (a gap only a thin DEX pool shows while the oracle, if any, is on peg). offPeg lists the WATCH and DEPEG coins. Webhook subscribers can receive stablecoin_depeg events.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Pegs","content":{"application/json":{"schema":{"type":"object","properties":{"offPeg":{"type":"array"},"coins":{"type":"array","items":{"type":"object","properties":{"impactOf100kSalePercent":{"type":"number"},"chainlinkUsd":{"type":"number"},"status":{"type":"string"},"deviationBps":{"type":"number"},"priceUsd":{"type":"number"},"symbol":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"offPeg":[],"coins":[{"impactOf100kSalePercent":0.01,"chainlinkUsd":0.99967,"status":"PEGGED","deviationBps":-4.2,"priceUsd":0.99958,"symbol":"USDT"}]}}}},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_stablecoin_pegs"}},"/api/v1/markets/yields":{"get":{"operationId":"getDefiYields","summary":"Supply and borrow APY, utilization and USD size","tags":["Agent Tools"],"description":"Supply and borrow APY, utilization and USD size (supplied and borrowed) of every active reserve of Aave v3 on Ethereum, Base, Arbitrum, Optimism and Polygon, Spark on Ethereum and the Compound v3 (Comet) markets on Ethereum, Base, Arbitrum, Optimism and Polygon, read on chain every 10 minutes (Pool.getReserveData and the pool oracle; Comet getSupplyRate/getBorrowRate). Sorted by supply APY. APY is the per-second compounding of the current variable rate; base yield only, reward-token incentives are not included. status: ACTIVE, FROZEN (no new supply or borrow) or PAUSED. bestSupplyByAsset gives the highest active USDC, USDT, WETH, WBTC and DAI rate among the matching markets. Answers 503 (not charged) until the first reading after a restart.","security":[{},{"siwx":[]}],"parameters":[{"name":"asset","in":"query","required":false,"schema":{"type":"string"},"description":"Token symbol (USDC, USDT, WETH, WBTC, DAI, ...), or stablecoins for every dollar and euro stablecoin; all assets when omitted.","example":"USDC"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon"]},"description":"Only markets on this chain. Not the payment network."},{"name":"protocol","in":"query","required":false,"schema":{"type":"string","enum":["aave_v3","spark","compound_v3"]},"description":"Only this protocol."},{"name":"minTvlUsd","in":"query","required":false,"schema":{"type":"number","default":1000000,"minimum":0},"description":"Leave out markets with less than this supplied (USD)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"minimum":1,"maximum":200},"description":"Maximum markets returned."}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"responses":{"200":{"description":"Markets with APY, utilization and size, best rate per asset","content":{"application/json":{"schema":{"type":"object","properties":{"bestSupplyByAsset":{"type":"object","properties":{"USDC":{"type":"object","properties":{"chain":{"type":"string"},"supplyApyPercent":{"type":"number"},"protocol":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"matching":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"stablecoin":{"type":"boolean"},"supplyApyPercent":{"type":"number"},"borrowApyPercent":{"type":"number"},"utilizationPercent":{"type":"number"},"totalSuppliedUsd":{"type":"integer"},"totalBorrowedUsd":{"type":"integer"},"status":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"bestSupplyByAsset":{"USDC":{"chain":"base","supplyApyPercent":6.14,"protocol":"compound_v3"}},"matching":1,"markets":[{"protocol":"compound_v3","chain":"base","asset":"USDC","stablecoin":true,"supplyApyPercent":6.14,"borrowApyPercent":7.6,"utilizationPercent":90.9,"totalSuppliedUsd":9653893,"totalBorrowedUsd":8775388,"status":"ACTIVE"}]}}}},"402":{"description":"Payment Required"},"503":{"description":"First reading in progress (not charged)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_defi_yields"}},"/api/v1/markets/oil-inventories":{"get":{"operationId":"getOilInventories","summary":"Get weekly US oil inventories and supply","description":"US oil from the EIA Weekly Petroleum Status Report (released Wednesdays 10:30 New York time): commercial crude (excluding the SPR), Cushing, Strategic Petroleum Reserve, gasoline and distillate stocks in thousand barrels, each with the weekly change, the 5-year average level and the 5-year average change for the same week (a draw larger than the seasonal average means tighter supply), plus crude production, refinery utilization, crude imports and exports, a one-sentence reading, the next expected release and a 26-week series. Source: U.S. Energy Information Administration (public domain).","tags":["Macro"],"security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Oil inventories","content":{"application/json":{"schema":{"type":"object"},"example":{"weekEnded":"2026-09-25","nextReleaseExpected":"2026-10-07 10:30 America/New_York (a day later after a Monday holiday)","stocksThousandBarrels":{"commercialCrude":{"label":"Commercial crude oil (excluding SPR)","level":427320,"weeklyChange":922,"fiveYearAverageForThisWeek":431806,"versusFiveYearAveragePercent":-1,"fiveYearAverageChangeForThisWeek":1544},"cushing":{"label":"Crude oil at Cushing, Oklahoma (WTI delivery hub)","level":24301,"weeklyChange":553,"fiveYearAverageForThisWeek":31120,"versusFiveYearAveragePercent":-21.9,"fiveYearAverageChangeForThisWeek":302},"strategicPetroleumReserve":{"label":"Strategic Petroleum Reserve","level":283767,"weeklyChange":-785,"fiveYearAverageForThisWeek":450122,"versusFiveYearAveragePercent":-37,"fiveYearAverageChangeForThisWeek":-1210},"gasoline":{"label":"Total motor gasoline","level":204362,"weeklyChange":-1684,"fiveYearAverageForThisWeek":214560,"versusFiveYearAveragePercent":-4.8,"fiveYearAverageChangeForThisWeek":1122},"distillate":{"label":"Distillate fuel oil (diesel, heating oil)","level":105180,"weeklyChange":-2251,"fiveYearAverageForThisWeek":121904,"versusFiveYearAveragePercent":-13.7,"fiveYearAverageChangeForThisWeek":-1810}},"supply":{"crudeProduction":{"value":13955,"weekEnded":"2026-09-25","weeklyChange":12,"unit":"thousand barrels per day"},"refineryUtilization":{"value":92.5,"weekEnded":"2026-09-25","weeklyChange":-0.6,"unit":"percent of operable capacity"}},"read":"Commercial crude stocks rose 0.92 million barrels vs a 5-year average build of 1.54 million for this week (tighter than usual, supportive for oil prices); the level is 1.0% below the 5-year average for this week.","weeklySeries":[{"week":"2026-09-25","commercialCrude":427320,"gasoline":204362,"distillate":105180,"cushing":24301}],"source":"U.S. Energy Information Administration (EIA), Weekly Petroleum Status Report"}}}},"402":{"description":"Payment Required"},"404":{"description":"Not loaded yet right after a restart (not charged)"},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_oil_inventories"}},"/api/v1/markets/funding-carry":{"get":{"operationId":"getFundingCarry","summary":"Carry trades from perp funding","tags":["Agent Tools"],"description":"Hyperliquid perpetual markets (crypto and HIP-3 stocks and commodities) whose funding pays a hedged position: funding now and averaged over 24 hours and 7 days from 5-minute snapshots, the share of the last 24 hours with the same sign (persistence STEADY, MOSTLY, FLIPPING), the side that collects it (SHORT perp and LONG spot when longs pay), gross annualized carry, open interest, 24h volume, whether a live on-chain spot market exists for the hedge, and the funding of the same symbol on GMX v2 and gTrade with cross-venue spreads. Ranked by |24h average| x steadiness (x1.2 with on-chain spot). Gross figures: fees, borrow, slippage and basis are not deducted.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"minOiUsd","in":"query","required":false,"schema":{"type":"number","default":5000000},"description":"Minimum open interest in USD","example":5000000},{"name":"minFundingAnnualPercent","in":"query","required":false,"schema":{"type":"number","default":15},"description":"Minimum absolute annualized funding (24h average when available)","example":15},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"Maximum opportunities","example":20}],"responses":{"200":{"description":"Opportunities and cross-venue spreads","content":{"application/json":{"schema":{"type":"object","properties":{"opportunities":{"type":"array","items":{"type":"object","properties":{"fundingAnnualPercentAvg24h":{"type":"number"},"persistence":{"type":"string"},"symbol":{"type":"string"},"venue":{"type":"string"},"openInterestUsd":{"type":"integer"},"fundingAnnualPercentNow":{"type":"number"},"collect":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"opportunities":[{"fundingAnnualPercentAvg24h":61.2,"persistence":"STEADY","symbol":"AEROUSD","venue":"hyperliquid","openInterestUsd":33462857,"fundingAnnualPercentNow":85.7,"collect":"SHORT perp, LONG spot (longs pay shorts)"}]}}}},"400":{"description":"Invalid parameter"},"402":{"description":"Payment Required"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-mcp-tool":"find_funding_carry"}},"/api/v1/intelligence/wallet/{address}":{"get":{"operationId":"getWalletProfile","summary":"Track record of a wallet (copy-trading check)","tags":["Agent Tools"],"description":"The track record of one address in the pools this API follows (ETH, BTC, tokenized stocks and other covered symbols on Base, Ethereum, Arbitrum, Optimism, Polygon and Robinhood Chain), from the swap pollers wallet records: realized PnL, unrealized PnL of open positions marked at the latest price, win rate, closed positions, trades per day, bought and sold USD, average holding time and style (SCALPER under 1 hour, INTRADAY under 24 hours, SWING), PnL percentile among tracked wallets with at least 3 closed positions, a label (SMART_MONEY: top 10% PnL with at least 10 closes and a 55% win rate; PROFITABLE; UNPROFITABLE; INSUFFICIENT_HISTORY), per-symbol results and 7 days of daily net flow. 404 (not charged) when the wallet has no swaps in the tracked pools. History starts when tracking began; swap recipients can be contracts.","security":[{},{"siwx":[]}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"Any EVM wallet address (0x...); profiles exist for wallets seen trading in the covered DEX pools. Unknown: 404, not charged.","example":"0xb21e8ec81ce0cca1b1dcda68bf6bc22015005942"}],"responses":{"200":{"description":"Wallet profile","content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string"},"performance":{"type":"object","properties":{"pnlPercentileAmongTrackedWallets":{"type":"number"},"realizedPnlUsd":{"type":"number"},"winRatePercent":{"type":"number"}},"additionalProperties":true},"label":{"type":"string"},"style":{"type":"object","properties":{"type":{"type":"string"},"averageHoldingHours":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"wallet":"0xb21e8ec81ce0cca1b1dcda68bf6bc22015005942","performance":{"pnlPercentileAmongTrackedWallets":99.9,"realizedPnlUsd":2768.0,"winRatePercent":58.1},"label":"SMART_MONEY","style":{"type":"INTRADAY","averageHoldingHours":3.2}}}}},"400":{"description":"Invalid address"},"402":{"description":"Payment Required"},"404":{"description":"No swaps of this wallet in the tracked pools (not charged)"}},"x-mcp-tool":"get_wallet_profile"}},"/api/v1/credits":{"get":{"operationId":"getCreditsInfo","summary":"Prepaid credits: packs and how to use them","description":"Free. Prepaid credits for clients that cannot sign an x402 payment per call (most MCP clients): the packs, how to buy and top up, and how to send the key.","tags":["Agent Tools"],"security":[],"responses":{"200":{"description":"Packs and usage","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_credit_balance"}},"/api/v1/credits/balance":{"get":{"operationId":"getCreditsBalance","summary":"Balance of a prepaid-credit key","description":"Free. Send the credit key in X-API-Key: balance, purchased and spent in USD, calls.","tags":["Agent Tools"],"security":[],"parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"The credit key (mi_...)","example":"mi_..."}],"responses":{"200":{"description":"Balance","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"get_credit_balance"}},"/api/v1/credits/buy/{usd}":{"post":{"operationId":"buyCredits","summary":"Buy or top up prepaid credits","description":"One x402 payment of the pack price ($5, $20 or $50; credit $5, $22 or $60) returns an API key with that credit (shown once). With an existing credit key in X-API-Key the pack is added to it. Each call made with the key costs the route's x402 price; calls answered with HTTP 400 or above are refunded. Main-network payments only (no testnet).","tags":["Agent Tools"],"security":[{}],"parameters":[{"name":"usd","in":"path","required":true,"schema":{"type":"integer","enum":[5,20,50]},"description":"Pack price in USD: 5, 20 or 50.","example":5},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Optional: a credit key to top up","example":"mi_..."}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"dynamic","currency":"USD","min":"5.00","max":"50.00"}},"responses":{"200":{"description":"apiKey (new) or toppedUp","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"creditUsd":{"type":"integer"},"apiKey":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"status":"active once the payment settles","creditUsd":22,"apiKey":"mi_..."}}}},"400":{"description":"Unknown pack or testnet payment (not charged)"},"402":{"description":"Payment Required (the pack price)"},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}}}},"/api/v1/sec/fails-to-deliver":{"get":{"operationId":"getFailsToDeliverTop","summary":"Largest fails-to-deliver","description":"The US securities with the largest fails-to-deliver by value on the latest settlement date in the SEC data (NSCC Continuous Net Settlement), with shares, price and value. SEC publishes twice a month, about two weeks after the period.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"minimum":1,"maximum":100},"description":"Maximum number of results to return","example":25},{"name":"includeFunds","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Also list ETFs and funds (their units fail routinely in creation and redemption)","example":false}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"settlementDate and largestByValue","content":{"application/json":{"schema":{"type":"object","properties":{"settlementDate":{"type":"string"},"largestByValue":{"type":"array","items":{"type":"object","properties":{"shares":{"type":"integer"},"symbol":{"type":"string"},"valueUsd":{"type":"integer"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"settlementDate":"2026-08-14","largestByValue":[{"shares":1250000,"symbol":"GME","valueUsd":31250000}]}}}},"400":{"description":"Invalid query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_fails_to_deliver"}},"/api/v1/sec/fails-to-deliver/{symbol}":{"get":{"operationId":"getFailsToDeliver","summary":"Fails-to-deliver of a US stock","description":"Daily fails-to-deliver of a US security from SEC data for up to 120 days: shares, price, value, share of shares outstanding (XBRL), and a signal from the Reg SHO threshold pattern (10,000 shares and 0.5% of shares outstanding for five settlement days in a row): THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS or OCCASIONAL_FAILS.","tags":["SEC Fundamentals"],"security":[{},{"siwx":[]}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Any US ticker in the SEC fails-to-deliver files (17,000+, e.g. GME, AMC, TSLA). Unknown: 404, not charged.","example":"AAPL"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":90,"minimum":5,"maximum":120},"description":"Look-back period in days","example":90}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"summary with signal, and daily rows","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"summary":{"type":"object","properties":{"thresholdRunNow":{"type":"integer"},"signal":{"type":"string"},"maxShares":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"symbol":"GME","summary":{"thresholdRunNow":2,"signal":"PERSISTENT_FAILS","maxShares":1250000}}}}},"400":{"description":"Invalid query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_fails_to_deliver"}},"/api/v1/cot":{"get":{"operationId":"getCotOverview","summary":"Futures positioning (COT) for 24 markets","description":"CFTC Commitments of Traders (legacy futures-only report) for gold, silver, copper, WTI, natural gas, S&P 500, Nasdaq-100, Dow, Russell 2000, VIX, 2y/5y/10y notes and bonds, euro, yen, pound, NZ dollar, dollar index, bitcoin, ether, corn, soybeans and wheat: speculators (non-commercial), commercials and small traders net, weekly and 4-week change, and a COT index (speculators net within its 3-year range, 0-100) with CROWDED_LONG, LEANING_LONG, NEUTRAL, LEANING_SHORT or CROWDED_SHORT. Most crowded first.","tags":["Macro"],"security":[{},{"siwx":[]}],"parameters":[],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"markets and extremes","content":{"application/json":{"schema":{"type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"market":{"type":"string"},"cotIndex":{"type":"number"}},"additionalProperties":true}},"extremes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"markets":[{"market":"gold","cotIndex":94.2}],"extremes":["gold: CROWDED_LONG","jpy: CROWDED_SHORT"]}}}},"400":{"description":"Invalid query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_cot_positioning"}},"/api/v1/cot/{market}":{"get":{"operationId":"getCotMarket","summary":"Futures positioning (COT) of one market","description":"CFTC Commitments of Traders of one futures market with its weekly history: speculators, commercials and small traders net, open interest, COT index and positioning. Market keys: gold, silver, copper, wti, natgas, sp500, nasdaq100, dow, russell2000, vix, ust2y, ust5y, ust10y, ustbond, eur, jpy, gbp, nzd, dxy, bitcoin, ether, corn, soybeans, wheat; aliases such as GOLD, SPY, BTC, EURUSD and CFTC codes work too.","tags":["Macro"],"security":[{},{"siwx":[]}],"parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"},"description":"One of 24 CFTC markets by key, alias or code: gold, silver, wti, natgas, sp500, nasdaq100, ust10y, eur, jpy, bitcoin, ether... (list: /api/v1/cot).","example":"gold"},{"name":"weeks","in":"query","required":false,"schema":{"type":"integer","default":26,"minimum":4,"maximum":156},"description":"Weeks of history (4-156)","example":26}],"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"latest positioning and history","content":{"application/json":{"schema":{"type":"object","properties":{"positioning":{"type":"string"},"market":{"type":"string"},"cotIndex":{"type":"number"},"speculatorsNet":{"type":"integer"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."},"example":{"positioning":"CROWDED_LONG","market":"gold","cotIndex":94.2,"speculatorsNet":245000}}}},"400":{"description":"Invalid query (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No data (not charged)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"no_data"},"message":{"type":"string"},"symbol":{"type":"string"},"coveredSymbols":{"type":"array","items":{"type":"string"}},"charged":{"type":"boolean","example":false}}}}}}},"x-mcp-tool":"get_cot_positioning"}},"/api/v1/feedback":{"get":{"operationId":"getFeedbackInfo","summary":"How to send feedback to the operator","description":"Free. The fields accepted by POST /api/v1/feedback.","tags":["Agent Tools"],"security":[],"responses":{"200":{"description":"Fields and an example","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-mcp-tool":"send_feedback"},"post":{"operationId":"sendFeedback","summary":"Tell the operator what was missing","description":"Free. Tell us what was missing or wrong: a route or tool you expected, a symbol without data, a confusing parameter. At least one of rating, missing or message; 10 per hour per client. Read by a human.","tags":["Agent Tools"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"route":{"type":"string","description":"Route or MCP tool it is about"},"rating":{"type":"integer","minimum":1,"maximum":5},"missing":{"type":"string","maxLength":1000},"message":{"type":"string","maxLength":1000},"contact":{"type":"string","maxLength":120}}},"example":{"route":"/api/v1/intelligence/SOLUSD","rating":3,"missing":"funding rate history per venue"}}}},"responses":{"200":{"description":"Received"},"400":{"description":"Empty or invalid"},"429":{"description":"More than 10 in an hour"}},"x-mcp-tool":"send_feedback"}},"/api/v1/analytics/weighted-mean":{"post":{"operationId":"analyticsWeightedMean","summary":"Weighted mean of supplied values","description":"Weighted arithmetic mean = sum(value_i * weight_i) / sum(weight_i). Weights default to 1 and must be >= 0 with a positive total. Computed in 34-digit decimal arithmetic and rounded HALF_EVEN to 6 decimals. Processes only the numbers you send; it never fetches or verifies market data. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"observations":{"items":{"type":"object","properties":{"weight":{"description":"Weight >= 0, default 1","type":"number"},"value":{"description":"The value","type":"number"}},"required":["value"]},"minItems":1,"maxItems":10000,"type":"array","description":"The observations: each a value and an optional weight"}},"required":["observations"]},"example":{"observations":[{"weight":100,"value":0.72},{"weight":500,"value":0.81},{"weight":50,"value":0.44}]}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"weightedMean":{"type":"number"},"observations":{"type":"number"},"totalWeight":{"type":"number"},"method":{"type":"string"},"meta":{"type":"object"}}},"example":{"operation":"weighted-mean","result":0.767692,"weightedMean":0.767692,"observations":3,"totalWeight":6.5E+2,"method":"WEIGHTED_ARITHMETIC_MEAN","meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/weighted-median":{"post":{"operationId":"analyticsWeightedMedian","summary":"Weighted median of supplied values","description":"Observations are sorted by value; zero-weight observations are ignored. With W the total weight and C(k) the cumulative weight of the k smallest values, the weighted median is the smallest value with C(k) >= W/2; when C(k) equals W/2 exactly it is the midpoint of that value and the next larger one, so equal weights give the ordinary median. Rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"observations":{"items":{"type":"object","properties":{"weight":{"description":"Weight >= 0, default 1","type":"number"},"value":{"description":"The value","type":"number"}},"required":["value"]},"minItems":1,"maxItems":10000,"type":"array","description":"The observations: each a value and an optional weight"}},"required":["observations"]},"example":{"observations":[{"weight":1,"value":10},{"weight":5,"value":20},{"weight":1,"value":100}]}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"weightedMedian":{"type":"number"},"observations":{"type":"number"},"totalWeight":{"type":"number"},"method":{"type":"string"},"meta":{"type":"object"}}},"example":{"operation":"weighted-median","result":2E+1,"weightedMedian":2E+1,"observations":3,"totalWeight":7,"method":"WEIGHTED_MEDIAN_MIDPOINT","meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/weighted-score":{"post":{"operationId":"analyticsWeightedScore","summary":"Weighted composite score from scored factors","description":"score = sum(score_i * weight_i) / sum(weight_i). Weights default to 1, must be >= 0 with a positive total, and are normalised by their total (weightsNormalized=true when they did not already sum to 1). contribution_i = score_i * weight_i / sum(weight), so the contributions add up to the score. Scores must lie in [scoreMin, scoreMax], default [0, 100]. Rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"factors":{"items":{"type":"object","properties":{"score":{"description":"The factor's score, within the score range","type":"number"},"name":{"type":"string","maxLength":64,"description":"Factor label, echoed back (default factorN)"},"weight":{"description":"Weight >= 0, default 1; normalised by the total","type":"number"}},"required":["score"]},"minItems":1,"maxItems":100,"type":"array","description":"The factors: each a score with an optional name and weight"},"scoreMin":{"description":"Lowest allowed score (default 0)","type":"number"},"scoreMax":{"description":"Highest allowed score (default 100)","type":"number"}},"required":["factors"]},"example":{"factors":[{"score":82,"name":"momentum","weight":0.3},{"score":74,"name":"fundamentals","weight":0.4},{"score":63,"name":"risk","weight":0.3}]}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"score":{"type":"number"},"factors":{"type":"number"},"totalWeight":{"type":"number"},"weightsNormalized":{"type":"boolean"},"scoreRange":{"type":"object"},"method":{"type":"string"},"components":{"type":"array"},"meta":{"type":"object"}}},"example":{"operation":"weighted-score","result":73.1,"score":73.1,"factors":3,"totalWeight":1,"weightsNormalized":false,"scoreRange":{"max":1E+2,"min":0},"method":"WEIGHTED_MEAN","components":[{"name":"momentum","score":82,"weight":0.3,"normalizedWeight":0.3,"contribution":24.6},{"name":"fundamentals","score":74,"weight":0.4,"normalizedWeight":0.4,"contribution":29.6},{"name":"risk","score":63,"weight":0.3,"normalizedWeight":0.3,"contribution":18.9}],"meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/zscore":{"post":{"operationId":"analyticsZScore","summary":"Z-score of a value against a reference distribution","description":"z = (value - mean) / sd, where mean and sd are of the reference values. method SAMPLE (default) uses sd = sqrt(sum((x - mean)^2) / (n - 1)); POPULATION divides by n. Needs at least 2 reference values that are not all equal. Rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"values":{"items":{"description":"Reference value","type":"number"},"minItems":2,"maxItems":10000,"type":"array"},"method":{"enum":["SAMPLE","POPULATION"],"description":"Standard deviation: SAMPLE divides by n-1, POPULATION by n","default":"SAMPLE","type":"string"},"value":{"description":"The observation to score","type":"number"}},"required":["value","values"]},"example":{"values":[98,102,101,110,99,103,100],"method":"SAMPLE","value":125.0}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"value":{"type":"number"},"mean":{"type":"number"},"standardDeviation":{"type":"number"},"zScore":{"type":"number"},"observations":{"type":"number"},"method":{"type":"string"},"meta":{"type":"object"}}},"example":{"operation":"zscore","result":5.820464,"value":125,"mean":101.857143,"standardDeviation":3.976119,"zScore":5.820464,"observations":7,"method":"SAMPLE","meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/percentile":{"post":{"operationId":"analyticsPercentile","summary":"Percentile rank of a value within a dataset","description":"LINEAR (default): inverse of the linear-interpolation quantile (Excel PERCENTILE.INC, NumPy 'linear'): the i-th smallest of n values (1-based) has rank 100*(i-1)/(n-1), values between neighbours are interpolated, below the minimum 0, above the maximum 100, and a value equal to tied values gets the mean of their ranks; needs n >= 2. MIDRANK: 100*(below + 0.5*equal)/n. AT_OR_BELOW: 100*(below + equal)/n. Rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"values":{"items":{"description":"Reference value","type":"number"},"minItems":1,"maxItems":10000,"type":"array"},"method":{"type":"string","enum":["LINEAR","MIDRANK","AT_OR_BELOW"],"default":"LINEAR"},"value":{"description":"The value to rank","type":"number"}},"required":["value","values"]},"example":{"values":[10,20,30,40,50,60,70,80,90,100],"method":"LINEAR","value":95}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"percentile":{"type":"number"},"value":{"type":"number"},"observations":{"type":"number"},"method":{"type":"string"},"countBelow":{"type":"number"},"countEqual":{"type":"number"},"countAbove":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"meta":{"type":"object"}}},"example":{"operation":"percentile","result":94.444444,"percentile":94.444444,"value":95,"observations":10,"method":"LINEAR","countBelow":9,"countEqual":0,"countAbove":1,"min":1E+1,"max":1E+2,"meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/correlation":{"post":{"operationId":"analyticsCorrelation","summary":"Correlation between two numeric series","description":"PEARSON (default): r = sum((x-mx)(y-my)) / sqrt(sum((x-mx)^2) * sum((y-my)^2)). SPEARMAN: Pearson of the ranks, tied values sharing the mean of their ranks. x and y must have equal length, at least 3 pairs, and neither may be constant. Returns r in [-1, 1] and r^2, rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"x":{"items":{"description":"First series","type":"number"},"minItems":3,"maxItems":10000,"type":"array"},"method":{"type":"string","enum":["PEARSON","SPEARMAN"],"default":"PEARSON"},"y":{"items":{"description":"Second series, same length as x","type":"number"},"minItems":3,"maxItems":10000,"type":"array"}},"required":["x","y"]},"example":{"x":[1,2,3,4,5],"method":"PEARSON","y":[2,4,5,8,10]}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"correlation":{"type":"number"},"rSquared":{"type":"number"},"direction":{"type":"string"},"observations":{"type":"number"},"method":{"type":"string"},"meta":{"type":"object"}}},"example":{"operation":"correlation","result":0.990148,"correlation":0.990148,"rSquared":0.980392,"direction":"POSITIVE","observations":5,"method":"PEARSON","meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/anomaly-score":{"post":{"operationId":"analyticsAnomalyScore","summary":"Bounded anomaly score of a value versus a reference","description":"z = (value - mean) / sd as in zscore (SAMPLE by default). anomalyScore = 100 * tanh(|z| / 3), so |z| of 1, 2, 3, 4 map to 32.1, 58.3, 76.2, 87.0. Severity from |z|: < 1 NORMAL, 1-2 LOW, 2-3 MEDIUM, 3-4 HIGH, >= 4 EXTREME. direction is ABOVE, BELOW or AT_MEAN. A normalised analytical score, not a statistical probability. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"values":{"items":{"description":"Reference value","type":"number"},"minItems":2,"maxItems":10000,"type":"array"},"method":{"enum":["SAMPLE","POPULATION"],"description":"Standard deviation: SAMPLE divides by n-1, POPULATION by n","default":"SAMPLE","type":"string"},"value":{"description":"The observation to score","type":"number"}},"required":["value","values"]},"example":{"values":[100,104,98,101,97,103,99,102,100,96],"value":106}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"anomalyScore":{"type":"number"},"zScore":{"type":"number"},"severity":{"type":"string"},"direction":{"type":"string"},"value":{"type":"number"},"mean":{"type":"number"},"standardDeviation":{"type":"number"},"observations":{"type":"number"},"method":{"type":"string"},"scoring":{"type":"string"},"meta":{"type":"object"}}},"example":{"operation":"anomaly-score","result":64.959439,"anomalyScore":64.959439,"zScore":2.32379,"severity":"MEDIUM","direction":"ABOVE","value":106,"mean":1E+2,"standardDeviation":2.581989,"observations":10,"method":"SAMPLE","scoring":"100*tanh(|z|/3)","meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/analytics/confidence":{"post":{"operationId":"analyticsConfidence","summary":"Deterministic confidence score from evidence factors","description":"confidence = sum(score_i * weight_i) / sum(weight_i) on a 0-100 scale; every factor score must be within 0-100, weights default to 1, must be >= 0 with a positive total and are normalised by their total. band: < 20 VERY_LOW, 20-40 LOW, 40-60 MEDIUM, 60-80 HIGH, >= 80 VERY_HIGH. weakestFactor is the lowest-scoring factor (first on ties). Not a probability; rounded HALF_EVEN to 6 decimals. Price: one fixed x402 payment per call; rejected inputs (HTTP 400/413) are not charged.","tags":["Analytics Primitives"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"factors":{"items":{"type":"object","properties":{"score":{"description":"The factor's score, within the score range","type":"number"},"name":{"type":"string","maxLength":64,"description":"Factor label, echoed back (default factorN)"},"weight":{"description":"Weight >= 0, default 1; normalised by the total","type":"number"}},"required":["score"]},"minItems":1,"maxItems":100,"type":"array","description":"The factors: each a score with an optional name and weight"}},"required":["factors"]},"example":{"factors":[{"score":90,"name":"sampleSize","weight":0.25},{"score":85,"name":"dataFreshness","weight":0.25},{"score":80,"name":"sourceAgreement","weight":0.25},{"score":75,"name":"signalConsistency","weight":0.25}]}}}},"responses":{"200":{"description":"Result. meta (requestId, processingTimeMs) is the only part that varies between identical requests.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"type":"number"},"confidence":{"type":"number"},"band":{"type":"string"},"scale":{"type":"string"},"weakestFactor":{"type":"string"},"totalWeight":{"type":"number"},"weightsNormalized":{"type":"boolean"},"method":{"type":"string"},"factors":{"type":"array"},"meta":{"type":"object"}}},"example":{"operation":"confidence","result":82.5,"confidence":82.5,"band":"VERY_HIGH","scale":"0-100","weakestFactor":"signalConsistency","totalWeight":1,"weightsNormalized":false,"method":"WEIGHTED_MEAN","factors":[{"name":"sampleSize","score":9E+1,"weight":0.25,"normalizedWeight":0.25,"contribution":22.5},{"name":"dataFreshness","score":85,"weight":0.25,"normalizedWeight":0.25,"contribution":21.25},{"name":"sourceAgreement","score":8E+1,"weight":0.25,"normalizedWeight":0.25,"contribution":2E+1},{"name":"signalConsistency","score":75,"weight":0.25,"normalizedWeight":0.25,"contribution":18.75}],"meta":{"requestId":"3f2b8c1e-5d4a-4f0e-9b7c-2a1d6e8f9c0b","processingTimeMs":0,"deterministic":true}}}}},"400":{"description":"Invalid input (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"EMPTY_DATASET","message":"values is missing or empty","charged":false}}}},"402":{"description":"Payment Required"},"413":{"description":"Too many values or body too large (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsError"},"example":{"error":"PAYLOAD_TOO_LARGE","message":"values has 20000 entries; the maximum is 10000","charged":false}}}},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/markets/prediction-markets/movers":{"get":{"operationId":"PredictionMarketsController_movers","summary":"Prediction market movers","description":"Prediction market movers: biggest odds swings ($0.005) on Hyperliquid prediction markets over the last hours=1-720: the option whose probability moved most, from and to, change in points, 24h volume and resolution date, for Fed decisions, IPOs, crypto and stock price targets and sports. Use to catch event repricing early.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24},"description":"Look-back period in hours"},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["crypto","stocks","macro","ipo","sports","awards","other"]},"description":"Category filter, e.g. crypto, stocks, macro, sports or ipo"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Maximum number of results to return"},{"name":"minVolumeUsd","in":"query","required":false,"schema":{"type":"number","default":1000.0},"description":"Minimum USD traded in the window"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"movers":[{"changePoints":-20.0,"category":"crypto","volume24hUsd":11831,"fromProbability":0.82,"id":"o7173","toProbability":0.62,"question":"Will BTC-USDC perp mark reach 87500 before 2026-11-01T00:00:00Z?","option":"Yes"}],"hours":24,"matching":1},"schema":{"type":"object","properties":{"movers":{"type":"array","items":{"type":"object","properties":{"changePoints":{"type":"number"},"category":{"type":"string"},"volume24hUsd":{"type":"integer"},"fromProbability":{"type":"number"},"id":{"type":"string"},"toProbability":{"type":"number"},"question":{"type":"string"},"option":{"type":"string"}},"additionalProperties":true}},"hours":{"type":"integer"},"matching":{"type":"integer"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}],"x-mcp-tool":"get_prediction_market_movers"}},"/api/v1/rates/treasury-yield-curve":{"get":{"operationId":"SearchAliasController_treasuryYieldCurve","summary":"Treasury yield curve: US Treasury yields from 1 month to 30","description":"Treasury yield curve ($0.01): US Treasury yields from 1 month to 30 years, par and real (TIPS), daily changes, 2s10s, 3m10y and 5s30s spreads with inversion flags, 10-year breakeven inflation, SOFR, EFFR and euro STR. Official Treasury and Fed data.","tags":["Agent Tools"],"x-generated":true,"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-24","nominalYieldsPercent":{"2 Yr":4.87,"3 Mo":4.24,"30 Yr":5.47,"10 Yr":5.18},"slopesBps":{"3m10y":94.0,"2s10s":31.0},"inversions":{"3m10y":false,"2s10s":false},"breakevenInflation10yPercent":2.33,"overnight":{"SOFR":{"effectiveDate":"2026-09-23","ratePercent":3.87},"ESTR":{"ratePercent":2.44}}},"schema":{"type":"object","properties":{"date":{"type":"string"},"nominalYieldsPercent":{"type":"object","properties":{"2 Yr":{"type":"number"},"3 Mo":{"type":"number"},"30 Yr":{"type":"number"},"10 Yr":{"type":"number"}},"additionalProperties":true},"slopesBps":{"type":"object","properties":{"3m10y":{"type":"number"},"2s10s":{"type":"number"}},"additionalProperties":true},"inversions":{"type":"object","properties":{"3m10y":{"type":"boolean"},"2s10s":{"type":"boolean"}},"additionalProperties":true},"breakevenInflation10yPercent":{"type":"number"},"overnight":{"type":"object","properties":{"SOFR":{"type":"object","properties":{"effectiveDate":{"type":"string"},"ratePercent":{"type":"number"}},"additionalProperties":true},"ESTR":{"type":"object","properties":{"ratePercent":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/markets/prediction-markets":{"get":{"operationId":"PredictionMarketsController_predictionMarkets","summary":"Prediction markets and odds, live from Hyperliquid","description":"Prediction markets and odds, live from Hyperliquid ($0.005): every open HIP-4 market as a plain question with each option's probability, 24h change and USDC volume, most traded first: crypto and stock price targets, Fed rate decisions, IPOs (Anthropic, OpenAI), sports and awards. Filter by category or text. Use for market-implied odds.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["crypto","stocks","macro","ipo","sports","awards","other"]},"description":"Category filter, e.g. crypto, stocks, macro, sports or ipo"},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Text that the market question must contain"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25},"description":"Maximum number of results to return"},{"name":"includeUntraded","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Also list markets without trading in the last 24 hours"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"liveMarketsByCategory":{"crypto":70,"ipo":3,"sports":60,"macro":2},"markets":[{"probabilityYes":0.21,"volume24hUsd":9000,"question":"Will BTC-USDC perp mark reach 87500 before 2026-11-01T00:00:00Z?","options":[{"change24hPoints":-4.0,"probability":0.21,"label":"Yes"}],"id":"o7173","category":"crypto"}]},"schema":{"type":"object","properties":{"liveMarketsByCategory":{"type":"object","properties":{"crypto":{"type":"integer"},"ipo":{"type":"integer"},"sports":{"type":"integer"},"macro":{"type":"integer"}},"additionalProperties":true},"markets":{"type":"array","items":{"type":"object","properties":{"probabilityYes":{"type":"number"},"volume24hUsd":{"type":"integer"},"question":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"change24hPoints":{"type":"number"},"probability":{"type":"number"},"label":{"type":"string"}},"additionalProperties":true}},"id":{"type":"string"},"category":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}],"x-mcp-tool":"get_prediction_markets"}},"/api/v1/markets/stablecoin-peg":{"get":{"operationId":"SearchAliasController_stablecoinPeg","summary":"Stablecoin peg and depeg monitor","description":"Stablecoin peg and depeg monitor ($0.005): is USDT, USDC, DAI, USDS, USDe, PYUSD, GHO, crvUSD, RLUSD, USD1 or FDUSD still worth a dollar? DEX price, depth of a $100k sale and Chainlink price, status PEGGED, WATCH, DEPEG or THIN_MARKET, refreshed every 5 minutes.","tags":["Agent Tools"],"x-generated":true,"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"offPeg":[],"coins":[{"impactOf100kSalePercent":0.01,"chainlinkUsd":0.99967,"status":"PEGGED","deviationBps":-4.2,"priceUsd":0.99958,"symbol":"USDT"}]},"schema":{"type":"object","properties":{"offPeg":{"type":"array"},"coins":{"type":"array","items":{"type":"object","properties":{"impactOf100kSalePercent":{"type":"number"},"chainlinkUsd":{"type":"number"},"status":{"type":"string"},"deviationBps":{"type":"number"},"priceUsd":{"type":"number"},"symbol":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}]}},"/api/v1/rates/fed-rate-odds":{"get":{"operationId":"PredictionMarketsController_fedRateOdds","summary":"Fed rate odds: FOMC rate cut, hold or hike probability for the","description":"Fed rate odds: FOMC rate cut, hold or hike probability ($0.005) for the next Federal Reserve decision and other central banks, priced on Hyperliquid prediction markets, with 24h change in points, USDC volume and the decision date. Use before trading around a rate decision.","tags":["Agent Tools"],"x-generated":true,"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"decisions":[{"category":"macro","options":[{"change24hPoints":7.0,"probability":0.62,"label":"No change","volume24hUsd":12000},{"change24hPoints":-7.0,"probability":0.35,"label":"Cut","volume24hUsd":9000},{"change24hPoints":0.0,"probability":0.03,"label":"Hike","volume24hUsd":100}],"id":"q331","question":"Federal Reserve October 2026 FOMC decision on the upper bound of the federal funds rate target range","decisionAt":"2026-10-28T18:00:00Z"}]},"schema":{"type":"object","properties":{"decisions":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"change24hPoints":{"type":"number"},"probability":{"type":"number"},"label":{"type":"string"},"volume24hUsd":{"type":"integer"}},"additionalProperties":true}},"id":{"type":"string"},"question":{"type":"string"},"decisionAt":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}],"x-mcp-tool":"get_fed_rate_odds"}},"/api/v1/markets/defi-yields":{"get":{"operationId":"SearchAliasController_defiYields","summary":"DeFi yields now: best supply and borrow APY of every Aave v3","description":"DeFi yields now ($0.002): best supply and borrow APY of every Aave v3, Spark and Compound v3 market on Ethereum, Base, Arbitrum, Optimism and Polygon, read on chain every 10 minutes, highest APY first, filter by asset, chain or protocol. Use to find where stablecoins or ETH earn most.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"asset","in":"query","required":false,"schema":{"type":"string"},"description":"Asset symbol, e.g. USDC, USDT, WETH or WBTC; stablecoins for all dollar stablecoins"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"]},"description":"Chain of the token: base, ethereum, arbitrum, optimism or polygon (token-risk also takes solana). Not the payment network"},{"name":"protocol","in":"query","required":false,"schema":{"type":"string"},"description":"Lending protocol: aave_v3, spark or compound_v3"},{"name":"minTvlUsd","in":"query","required":false,"schema":{"type":"number","default":1000000.0},"description":"Only markets with at least this much supplied, in USD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25},"description":"Maximum number of results to return"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"bestSupplyByAsset":{"USDC":{"chain":"base","supplyApyPercent":6.14,"protocol":"compound_v3"}},"matching":1,"markets":[{"protocol":"compound_v3","chain":"base","asset":"USDC","stablecoin":true,"supplyApyPercent":6.14,"borrowApyPercent":7.6,"utilizationPercent":90.9,"totalSuppliedUsd":9653893,"totalBorrowedUsd":8775388,"status":"ACTIVE"}]},"schema":{"type":"object","properties":{"bestSupplyByAsset":{"type":"object","properties":{"USDC":{"type":"object","properties":{"chain":{"type":"string"},"supplyApyPercent":{"type":"number"},"protocol":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"matching":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"stablecoin":{"type":"boolean"},"supplyApyPercent":{"type":"number"},"borrowApyPercent":{"type":"number"},"utilizationPercent":{"type":"number"},"totalSuppliedUsd":{"type":"integer"},"totalBorrowedUsd":{"type":"integer"},"status":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"security":[{},{"siwx":[]}]}},"/api/v1/markets/usdc-yield":{"get":{"operationId":"SearchAliasController_usdcYield","summary":"USDC yield, best lending rates now","description":"USDC yield, best lending rates now ($0.002): supply and borrow APY of USDC on every Aave v3, Spark and Compound v3 market (Ethereum, Base, Arbitrum, Optimism, Polygon), utilization and size, highest APY first, read on chain every 10 minutes. Use to park idle USDC.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon"]},"description":"Chain of the token: base, ethereum, arbitrum, optimism or polygon (token-risk also takes solana). Not the payment network"},{"name":"protocol","in":"query","required":false,"schema":{"type":"string"},"description":"Lending protocol: aave_v3, spark or compound_v3"},{"name":"minTvlUsd","in":"query","required":false,"schema":{"type":"number","default":1000000.0},"description":"Only markets with at least this much supplied, in USD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25},"description":"Maximum number of results to return"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"bestSupplyByAsset":{"USDC":{"chain":"base","supplyApyPercent":6.14,"protocol":"compound_v3"}},"matching":1,"markets":[{"protocol":"compound_v3","chain":"base","asset":"USDC","stablecoin":true,"supplyApyPercent":6.14,"borrowApyPercent":7.6,"utilizationPercent":90.9,"totalSuppliedUsd":9653893,"totalBorrowedUsd":8775388,"status":"ACTIVE"}]},"schema":{"type":"object","properties":{"bestSupplyByAsset":{"type":"object","properties":{"USDC":{"type":"object","properties":{"chain":{"type":"string"},"supplyApyPercent":{"type":"number"},"protocol":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"matching":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"stablecoin":{"type":"boolean"},"supplyApyPercent":{"type":"number"},"borrowApyPercent":{"type":"number"},"utilizationPercent":{"type":"number"},"totalSuppliedUsd":{"type":"integer"},"totalBorrowedUsd":{"type":"integer"},"status":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"security":[{},{"siwx":[]}]}},"/api/v1/markets/gas-price":{"get":{"operationId":"SearchAliasController_gasPrice","summary":"Gas price now on every EVM chain","description":"Gas price now on every EVM chain ($0.001): base fee, priority fee percentiles and the USD cost of a transfer and a DEX swap on Ethereum, Base, Arbitrum, Optimism, Polygon and other chains, cheapest first. Use to budget or time a transaction.","tags":["Agent Tools"],"x-generated":true,"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"chains":[{"swapCostUsd":0.00368,"transferCostUsd":5.15E-4,"nativeToken":"ETH","baseFeeGwei":0.0071,"chain":"base","gasPriceGwei":0.0092}]},"schema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"object","properties":{"swapCostUsd":{"type":"number"},"transferCostUsd":{"type":"number"},"nativeToken":{"type":"string"},"baseFeeGwei":{"type":"number"},"chain":{"type":"string"},"gasPriceGwei":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"security":[{},{"siwx":[]}]}},"/api/v1/news/crypto-news":{"get":{"operationId":"SearchAliasController_cryptoNews","summary":"Crypto news, latest headlines","description":"Crypto news, latest headlines ($0.005): newest crypto market news with title, source, link, publish time, extracted tickers and keyword sentiment, filter by text query. Use to catch what moves bitcoin, ether and altcoins right now.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Text that the title must contain, e.g. a ticker or a word"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Maximum number of results to return"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":[{"source":"sec.gov","provider":"sec-edgar","category":"filings","title":"NVDA 8-K: NVIDIA Corp - Item 2.02: Results of Operations and Financial Condition","url":"https://www.sec.gov/Archives/edgar/data/...","publishedAt":"2026-09-23T19:05:00Z","symbols":["NVDA"],"sentiment":"neutral","sentimentScore":0}],"schema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"provider":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"publishedAt":{"type":"string"},"symbols":{"type":"array","items":{"type":"string"}},"sentiment":{"type":"string"},"sentimentScore":{"type":"integer"}},"additionalProperties":true},"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}]}},"/api/v1/sec/filings":{"get":{"operationId":"SearchAliasController_secFilings","summary":"SEC filings, latest 8-K material events","description":"SEC filings, latest 8-K material events ($0.005): newest SEC EDGAR 8-K filings of US companies with tickers, title, filing link and time (earnings, deals, executive changes, bankruptcy), filter by ticker or text. Use to catch company news the moment it is filed.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Text that the title must contain, e.g. a ticker or a word"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Maximum number of results to return"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":[{"source":"sec.gov","provider":"sec-edgar","category":"filings","title":"NVDA 8-K: NVIDIA Corp - Item 2.02: Results of Operations and Financial Condition","url":"https://www.sec.gov/Archives/edgar/data/...","publishedAt":"2026-09-23T19:05:00Z","symbols":["NVDA"],"sentiment":"neutral","sentimentScore":0}],"schema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"provider":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"publishedAt":{"type":"string"},"symbols":{"type":"array","items":{"type":"string"}},"sentiment":{"type":"string"},"sentimentScore":{"type":"integer"}},"additionalProperties":true},"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}]}},"/mcp/core":{"post":{"operationId":"McpController_core","summary":"Use when the MCP client should load few tools","description":"Use when the MCP client should load few tools. Compact MCP server with the 18 most used tools: live decision, pre-trade check, opportunity scan, snapshot, move explanation, token verdict and risk, new tokens, swap quote, Fed rate odds, prediction markets, DeFi yields, market summary, macro calendar, news and fundamentals. Each tools/call costs its HTTP route price; the full server is /mcp.","tags":["Agent Tools"],"x-generated":true,"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"jsonrpc":"2.0","result":{"tools":[{"name":"get_decision_lite"}]},"id":1},"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"result":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"id":{"type":"integer"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"dynamic","currency":"USD","min":"0.001","max":"0.05"}},"security":[{},{"siwx":[]}]}},"/api/v1/intelligence/whale-activity/{address}":{"get":{"operationId":"SearchAliasController_whaleActivity","summary":"Whale activity in a token","description":"Whale activity in a token ($0.01): the largest wallets buying and selling any ERC-20 in the last hour on Base, Ethereum, Arbitrum, Optimism or Polygon, net USD per wallet, buys and sells, smart-money labels, bot flags and smart-money net flow. Use to see whether whales accumulate or dump.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token contract address, e.g. 0x940181a94a35a4569e4529a3cdfb74e38fd98631 (Base), or a Solana mint"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","enum":["base","ethereum","arbitrum","optimism","polygon"]},"description":"Chain of the token: base, ethereum, arbitrum, optimism or polygon (token-risk also takes solana). Not the payment network"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Maximum number of results to return"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"topSellers":[],"summary":{"whaleVerdict":"WHALES_ACCUMULATING","whalesNetUsd":31870.4,"volumeUsd":412390.2,"buyVolumeUsd":231004.7,"sellVolumeUsd":181385.5,"priceUsd":0.812345,"priceChangePercent":2.4,"transactions":1204,"attributedTransactions":80,"attributedVolumePercent":58.2,"averageUnattributedTxUsd":153.8,"attributedWallets":61,"netBuyers":34,"netSellers":27,"top10BuyersSharePercent":41.3,"smartMoneyNetUsd":18420.5,"flowVerdict":"ACCUMULATION","verdictReason":"The 61 largest wallets (34 net buyers, 27 net sellers) bought a net $31870 of $240011 they traded; flowVerdict ACCUMULATION is the buy/sell split of all swaps."},"topBuyers":[{"wallet":"0x3f5c...9a1e","netUsd":18420.5,"boughtUsd":18420.5,"soldUsd":0.0,"buys":3,"sells":0,"label":"SMART_MONEY","automated":false}],"token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","chain":"base","venues":{"aerodrome_slipstream":268053.6,"uniswap_v3":103097.6,"pancakeswap_v3":41239.0}},"schema":{"type":"object","properties":{"topSellers":{"type":"array"},"summary":{"type":"object","properties":{"whaleVerdict":{"type":"string"},"whalesNetUsd":{"type":"number"},"volumeUsd":{"type":"number"},"buyVolumeUsd":{"type":"number"},"sellVolumeUsd":{"type":"number"},"priceUsd":{"type":"number"},"priceChangePercent":{"type":"number"},"transactions":{"type":"integer"},"attributedTransactions":{"type":"integer"},"attributedVolumePercent":{"type":"number"},"averageUnattributedTxUsd":{"type":"number"},"attributedWallets":{"type":"integer"},"netBuyers":{"type":"integer"},"netSellers":{"type":"integer"},"top10BuyersSharePercent":{"type":"number"},"smartMoneyNetUsd":{"type":"number"},"flowVerdict":{"type":"string"},"verdictReason":{"type":"string"}},"additionalProperties":true},"topBuyers":{"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string"},"netUsd":{"type":"number"},"boughtUsd":{"type":"number"},"soldUsd":{"type":"number"},"buys":{"type":"integer"},"sells":{"type":"integer"},"label":{"type":"string"},"automated":{"type":"boolean"}},"additionalProperties":true}},"token":{"type":"string"},"chain":{"type":"string"},"venues":{"type":"object","properties":{"aerodrome_slipstream":{"type":"number"},"uniswap_v3":{"type":"number"},"pancakeswap_v3":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/intelligence/wallet-profile/{address}":{"get":{"operationId":"SearchAliasController_walletProfile","summary":"Wallet profile of any crypto trader","description":"Wallet profile of any crypto trader ($0.01): PnL, win rate, holding time and style (scalper, intraday, swing), open positions, PnL percentile among tracked DEX wallets, a label (SMART_MONEY, PROFITABLE, UNPROFITABLE) and daily net flow. Use before copying or trusting a wallet.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Wallet address, e.g. 0xb21e8ec81ce0cca1b1dcda68bf6bc22015005942"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"wallet":"0xb21e8ec81ce0cca1b1dcda68bf6bc22015005942","performance":{"pnlPercentileAmongTrackedWallets":99.9,"realizedPnlUsd":2768.0,"winRatePercent":58.1},"label":"SMART_MONEY","style":{"type":"INTRADAY","averageHoldingHours":3.2}},"schema":{"type":"object","properties":{"wallet":{"type":"string"},"performance":{"type":"object","properties":{"pnlPercentileAmongTrackedWallets":{"type":"number"},"realizedPnlUsd":{"type":"number"},"winRatePercent":{"type":"number"}},"additionalProperties":true},"label":{"type":"string"},"style":{"type":"object","properties":{"type":{"type":"string"},"averageHoldingHours":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/intelligence/honeypot-check/{address}":{"get":{"operationId":"SearchAliasController_honeypotCheck","summary":"Honeypot check for any token","description":"Honeypot check for any token ($0.02): can it be sold after you buy? Simulated sell and buy on chain, owner and proxy, mint, blacklist, pause and fee functions, liquidity, LP burn and buy tax on Base, Ethereum, Arbitrum, Optimism and Polygon; mint and freeze authority on Solana. Verdict and 0-100 safety score.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token contract address, e.g. 0x940181a94a35a4569e4529a3cdfb74e38fd98631 (Base), or a Solana mint"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","enum":["base","ethereum","arbitrum","optimism","polygon"]},"description":"Chain of the token: base, ethereum, arbitrum, optimism or polygon (token-risk also takes solana). Not the payment network"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"chain":"base","token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","tokenInfo":{"decimals":18,"symbol":"AERO","name":"Aerodrome"},"verdict":"LOW_RISK","safetyScore":90,"reasons":["Code contains a function by which new supply can be minted; no owner() found"],"checks":[{"check":"sell_simulation","detail":"A recent buyer's transfer of half their balance into the pool (a sale) succeeds","status":"PASS"},{"check":"liquidity","detail":"$41817539 of liquidity across 12 pools","status":"PASS"}],"contract":{"upgradeable":false,"adminFunctions":["MINT"],"proxy":false},"liquidity":{"lpBurnedPercent":0.0,"totalUsd":4.181753885E7},"simulation":{"buy":"OK","observedBuyTaxPercent":0.0,"sell":"OK"},"tradeFlow":{"verdict":"BALANCED"}},"schema":{"type":"object","properties":{"chain":{"type":"string"},"token":{"type":"string"},"tokenInfo":{"type":"object","properties":{"decimals":{"type":"integer"},"symbol":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"verdict":{"type":"string"},"safetyScore":{"type":"integer"},"reasons":{"type":"array","items":{"type":"string"}},"checks":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string"},"detail":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true}},"contract":{"type":"object","properties":{"upgradeable":{"type":"boolean"},"adminFunctions":{"type":"array","items":{"type":"string"}},"proxy":{"type":"boolean"}},"additionalProperties":true},"liquidity":{"type":"object","properties":{"lpBurnedPercent":{"type":"number"},"totalUsd":{"type":"number"}},"additionalProperties":true},"simulation":{"type":"object","properties":{"buy":{"type":"string"},"observedBuyTaxPercent":{"type":"number"},"sell":{"type":"string"}},"additionalProperties":true},"tradeFlow":{"type":"object","properties":{"verdict":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"security":[{},{"siwx":[]}]}},"/api/v1/intelligence/order-flow/{symbol}":{"get":{"operationId":"SearchAliasController_orderFlow","summary":"Order flow of a crypto or tokenized stock","description":"Order flow of a crypto or tokenized stock ($0.01): buy and sell volume from the taker side of on-chain swaps, buy pressure, momentum, volume versus its own baseline, anomaly flags and a signal for ETHUSD, BTCUSD, NVDA, TSLA and more, windows 1m to 24h. Use to see who is in control now.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Crypto pair or tokenized stock, e.g. ETHUSD"},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"5m","enum":["1m","5m","15m","1h","4h","24h"]},"description":"Aggregation window: 1m, 5m, 15m, 1h, 4h or 24h"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"symbol":"ETHUSD","price":2668.42,"priceChangePercent":0.42,"volume":812.5,"tradeCount":412,"buyPressure":61.3,"buySellImbalance":22.6,"sideDataAvailable":true,"momentumScore":64.2,"activityScore":71.8,"anomalyScore":38.5,"confidenceScore":92.1,"activityMultiple":1.7,"volumeMultiple":1.9,"dominantSide":"BUY","signal":"BUYING_ACTIVITY","signalStrength":"MEDIUM","eventType":"NORMAL","largeTradeCount":3,"evidence":["Buy pressure is 61.3%","Volume is 1.9x baseline"],"timestamp":"2026-09-23T19:30:00Z"},"schema":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"number"},"priceChangePercent":{"type":"number"},"volume":{"type":"number"},"tradeCount":{"type":"integer"},"buyPressure":{"type":"number"},"buySellImbalance":{"type":"number"},"sideDataAvailable":{"type":"boolean"},"momentumScore":{"type":"number"},"activityScore":{"type":"number"},"anomalyScore":{"type":"number"},"confidenceScore":{"type":"number"},"activityMultiple":{"type":"number"},"volumeMultiple":{"type":"number"},"dominantSide":{"type":"string"},"signal":{"type":"string"},"signalStrength":{"type":"string"},"eventType":{"type":"string"},"largeTradeCount":{"type":"integer"},"evidence":{"type":"array","items":{"type":"string"}},"timestamp":{"type":"string"}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"security":[{},{"siwx":[]}]}},"/api/v1/intelligence/rug-check/{address}":{"get":{"operationId":"SearchAliasController_rugCheck","summary":"Rug check for any token: is this token a rug pull or scam?","description":"Rug check for any token ($0.01): is this token a rug pull or scam? Short verdict LOW_RISK, CAUTION or HIGH_RISK with a 0-100 safety score, one plain sentence, can it be sold, buy tax, liquidity, owner control and the top three risks, for a contract on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token contract address, e.g. 0x940181a94a35a4569e4529a3cdfb74e38fd98631 (Base), or a Solana mint"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","enum":["base","ethereum","arbitrum","optimism","polygon"]},"description":"Chain of the token: base, ethereum, arbitrum, optimism or polygon (token-risk also takes solana). Not the payment network"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"token":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","chain":"base","symbol":"AERO","name":"Aerodrome","verdict":"LOW_RISK","safetyScore":90,"summary":"AERO on Base looks low-risk: a simulated sale succeeds, no buy tax was seen, $41.8M of liquidity backs it.","oneLiner":"Sells cleanly, no buy tax, $41.8M deep: the boring kind of token.","canSell":"YES","buyTaxPercent":0.0,"liquidityUsd":4.181753885E7,"ownerControl":"NO_OWNER_FOUND","upgradeable":false,"adminFunctions":["MINT"],"risks":["Code contains a function by which new supply can be minted; no owner() found"],"positives":["A recent buyer's transfer of half their balance into the pool (a sale) succeeds"],"fullReport":"/api/v1/intelligence/token-risk/0x940181a94a35a4569e4529a3cdfb74e38fd98631?chain=base","share":{"pageUrl":"https://api.marketintelligenceapi.com/v/abc23defgh","imageUrl":"https://api.marketintelligenceapi.com/v/abc23defgh/card.png"}},"schema":{"type":"object","properties":{"token":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"verdict":{"type":"string"},"safetyScore":{"type":"integer"},"summary":{"type":"string"},"oneLiner":{"type":"string"},"canSell":{"type":"string"},"buyTaxPercent":{"type":"number"},"liquidityUsd":{"type":"number"},"ownerControl":{"type":"string"},"upgradeable":{"type":"boolean"},"adminFunctions":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"positives":{"type":"array","items":{"type":"string"}},"fullReport":{"type":"string"},"share":{"type":"object","properties":{"pageUrl":{"type":"string"},"imageUrl":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}},"/api/v1/sec/insider-trades/{symbol}":{"get":{"operationId":"SearchAliasController_insiderTrades","summary":"Insider trades of a US stock from SEC Form 4","description":"Insider trades of a US stock from SEC Form 4 ($0.01): insider buying and selling by executives, directors and 10% owners over days=1-365, open-market buys and sales in USD, 10b5-1 plan share, per-insider totals and a signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING). Use before trading a stock.","tags":["Agent Tools"],"x-generated":true,"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"US stock ticker, e.g. AAPL"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":90},"description":"Look-back period in days"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"symbol":"TSLA","companyName":"Tesla, Inc.","periodDays":90,"filingsInPeriod":6,"signal":"NET_SELLING","interpretation":"2 insider(s) sold on the open market and none bought.","summary":{"netValueUsd":-3412880.5,"openMarketSales":{"transactions":4,"valueUsd":3412880.5,"insiders":2},"openMarketBuys":{"valueUsd":0.0,"transactions":0}},"transactions":[{"role":"Chief Financial Officer","type":"OPEN_MARKET_SALE","under10b5Plan":false,"valueUsd":938414.2,"pricePerShare":360.134,"insider":"Taneja Vaibhav","shares":2605.75,"date":"2026-09-08","code":"S"}]},"schema":{"type":"object","properties":{"symbol":{"type":"string"},"companyName":{"type":"string"},"periodDays":{"type":"integer"},"filingsInPeriod":{"type":"integer"},"signal":{"type":"string"},"interpretation":{"type":"string"},"summary":{"type":"object","properties":{"netValueUsd":{"type":"number"},"openMarketSales":{"type":"object","properties":{"transactions":{"type":"integer"},"valueUsd":{"type":"number"},"insiders":{"type":"integer"}},"additionalProperties":true},"openMarketBuys":{"type":"object","properties":{"valueUsd":{"type":"number"},"transactions":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true},"transactions":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"type":{"type":"string"},"under10b5Plan":{"type":"boolean"},"valueUsd":{"type":"number"},"pricePerShare":{"type":"number"},"insider":{"type":"string"},"shares":{"type":"number"},"date":{"type":"string"},"code":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true,"description":"Fields of the example; real answers carry more (the schema is open)."}}}},"402":{"description":"Payment required: the x402 requirements (price, networks, payTo) are in the PAYMENT-REQUIRED header and the body. Sign one of accepts[] and repeat the request with PAYMENT-SIGNATURE. Nothing is charged until a 2xx answer."},"404":{"description":"No data for this symbol, window or input right now. Never charged; the body names the covered values and the right route."},"400":{"description":"Invalid parameter: the message says which and what is allowed. Never charged."}},"x-payment-info":{"protocols":[{"x402":{}}],"networks":["eip155:8453","eip155:137","eip155:42161","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:480"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{},{"siwx":[]}]}}},"tags":[{"name":"European Markets","description":"ECB FX and rates, Eurostat macro, AMF short positions and ESEF fundamentals"},{"name":"Market News","description":"Crypto and stock headlines with publisher, sentiment and event type."},{"name":"Crypto News","description":"Latest crypto market headlines."},{"name":"Stock News","description":"Latest stock market headlines and SEC 8-K events."},{"name":"Symbol News","description":"Headlines and filings tagged with one ticker or crypto pair."},{"name":"Agent Tools","description":"One-call answers for agents: pre-trade checks, token risk, decisions, reports and opportunity scans."},{"name":"Market Intelligence","description":"Live on-chain trade flow per symbol: buy pressure, momentum, anomalies and rankings, windows 1m to 24h."},{"name":"MCP","description":"The same data as Model Context Protocol tools: POST /mcp (all tools) or /mcp/core (the most used)."},{"name":"SEC Fundamentals","description":"Fundamentals from SEC XBRL filings: revenue, margins, growth, balance sheet and a signal."},{"name":"Stock Fundamentals","description":"Fundamentals and insider activity of US-listed companies."},{"name":"Financial Statements","description":"Reported financial statement items from SEC and ESEF filings."},{"name":"Free","description":"Free discovery, samples, coverage, status and track records: no payment needed."},{"name":"Macro","description":"Treasury yields, Fed odds, liquidity, bank credit, COT positioning, oil inventories and the macro calendar."},{"name":"Analytics Primitives","description":"Deterministic analytical primitives for AI agents: statistics on numbers the caller supplies. No market data is fetched or verified."}],"x-agentcash-guidance":{"llmsTxtUrl":"https://api.marketintelligenceapi.com/llms.txt"},"x-mcp":{"endpoint":"/mcp","core":"/mcp/core","transport":"streamable-http","note":"Each operation's x-mcp-tool is the tool with the same answer and price; free routes have free tools."}}