com.marketintelligenceapi.api/market-intelligence

Tools

• analyze_token

  Send any ERC-20 token contract address (Base by default; also ethereum, arbitrum, optimism, polygon), get its live DEX trade flow for the last hour: buy/sell volume in USD, buy pressure, price change, largest trade, trader concentration and a verdict. Use for trade flow of a token; for safety before buying use check_token_risk.

  shallow
• backtest_signals

  Validate intelligence signals with walk-forward historical forward returns, win rates, MFE/MAE and confidence calibration. Uses only prior buckets to build the baseline.

  shallow
• check_portfolio

  Review holdings in one call ($0.25): up to 15 positions (symbol with valueUsd or quantity) and 5 on-chain tokens. Returns concentration, correlations, volatility and one-day 95% VaR from hourly on-chain data, the current decision per symbol, token risk verdicts, macro events in the next 24h, flags and a verdict (OK, REVIEW, HIGH_RISK). Use for existing holdings; for one new trade use pre_trade_check.

  shallow
• check_token_risk

  Due diligence before buying any token (Base by default; also ethereum, arbitrum, optimism, polygon, solana). EVM: simulated sell and buy (honeypot check), owner and upgradeable proxy, mint, blacklist, pause and fee functions, liquidity, LP burn, observed buy tax, last-hour flow. Solana mints: mint and freeze authority, Token-2022 transfer fee, permanent delegate, transfer hook, pause and top-wallet concentration. Verdict LOW_RISK, CAUTION or HIGH_RISK. Use before buying a token; for its trading activity use analyze_token.

  shallow
• compare_symbols

  Compare selected symbols by price change, pressure, momentum, activity, anomaly and confidence.

  shallow
• explain_move

  Why is a symbol moving? ($0.02) The 15-minute move and its likely drivers from every source (on-chain flow, unusual activity, smart money, perp crowding, 48h news, SEC filings, insiders) with direction and weight, plus a one-sentence summary. Crypto, tokenized stocks and US stocks.

  shallow
• find_funding_carry

  Carry trades ($0.005): Hyperliquid perps whose funding pays a hedged position, ranked by the 24h average and its steadiness, with the collecting side, open interest, on-chain spot for the hedge and spreads vs GMX v2 and gTrade.

  shallow
• find_market_events

  Find high-confidence market events such as bullish accumulation, potential breakouts, distribution, capitulation and momentum changes. Use for discrete events (breakouts, capitulation); for continuous rankings use get_market_intelligence.

  shallow
• find_new_tokens

  Tokens launched in the last hour on Base or Ethereum, already risk-checked: every new Uniswap v2/v3/v4 or Aerodrome pool against ETH, WETH or USDC with liquidity, sell simulation, v4 hook powers, first trades and a verdict (LOW_RISK, CAUTION, HIGH_RISK).

  shallow
• find_opportunities

  Goal-driven scan: name an objective and constraints, get ranked symbols with supporting and conflicting evidence grouped by independent source (spot DEX flow, perp positioning, smart-money wallets), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Use instead of chaining screeners. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning, smart_money_accumulation, smart_money_distribution. Use to discover symbols; once you have one, call pre_trade_check or get_decision_lite.

  shallow
• find_strong_buying

  Find symbols with strong buy-side trade pressure. Ranks by buy pressure only; for confirmed setups with evidence use find_opportunities.

  shallow
• find_strong_selling

  Find symbols with strong sell-side trade pressure. Ranks by sell pressure only; for confirmed setups with evidence use find_opportunities.

  shallow
• find_unusual_activity

  Find statistically unusual trade activity using anomaly score and a minimum trade count. Ranks by anomaly score; for plain volume use get_top_activity.

  shallow
• get_bank_credit

  US bank credit and deposits ($0.005), weekly from the Fed H.8: bank credit, loans and leases, C&I, real estate and consumer loans, securities and deposits of all commercial banks, with 4/13-week annualized and 52-week growth, the loan-to-deposit ratio and loan growth momentum (ACCELERATING, STEADY, DECELERATING).

  shallow
• get_beneficial_ownership

  SEC Schedule 13D (activist) and 13G (passive) filings of holders above 5% of a US-listed company, with holder names and percent of class.

  shallow
• get_candles

  OHLCV candles for a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count. Use for recent candles; for one complete UTC day per venue use get_dataset.

  shallow
• get_cot_positioning

  CFTC Commitments of Traders ($0.005): how futures speculators, hedgers and small traders are positioned in gold, oil, S&P 500, Nasdaq, Treasuries, dollar, euro, yen, bitcoin, ether, VIX and grains, with a 3-year COT index (CROWDED_LONG/SHORT). Omit market for all 24 markets, most crowded first.

  shallow
• get_data_coverage

  FREE: which data sources cover each symbol (spot on-chain DEX flow, perp venues), so you know what a paid call will return.

  shallow
• get_dataset

  One UTC day of trade-flow candles for a symbol, per venue (onchain_dex, solana_dex): OHLCV with aggressor buy/sell volume, buy pressure, VWAP and trades. For backtesting and research.

  shallow
• get_decision

  Premium decision ($1): every dataset combined into one action (STRONG_BUY..STRONG_SELL) with conviction, evidence per pillar (order flow, technicals, smart money, fundamentals, insiders, positioning, market risk, news), a volatility-sized trade plan and what would change the view. Omit symbol for the market-wide stance and best setups; an ISIN gives a European issuer decision (several symbols: get_decisions_batch). Every module reports its status, source and freshness. Use only when the full evidence and trade plan justify $1; otherwise get_decision_lite.

  shallow
• get_decision_lite

  Cheap live decision ($0.05): action (STRONG_BUY..STRONG_SELL), direction, conviction, a GO/WAIT answer for a side, the stance of each pillar and the measured hit rate. Same engine as get_decision ($1), without the trade plan, execution check, evidence and risks. Use as the default decision; get_decision ($1) adds full evidence and a trade plan, get_decision_sample is free but delayed.

  shallow
• get_decision_sample

  FREE sample of the premium decision: the latest hourly decision (action, direction, conviction, pillar scores) of every symbol with live on-chain trading (e.g. ETHUSD, BTCUSD, NVDA, TSLA, SPY, AAPL), delayed at least an hour, with what the price did 1h/4h/24h later. Judge the decisions before buying a live one.

  shallow
• get_decisions_batch

  Premium decisions ($3) for up to 5 symbols in one call, computed in parallel: each full decision (action, conviction, pillars, trade plan, module status) plus a ranking from most bullish to most bearish. Use instead of several get_decision calls for 2-5 symbols.

  shallow
• get_defi_rate_spread

  USDC lending and borrowing APR on Aave v3 (Ethereum, Base, Arbitrum, Optimism, Polygon) read on chain vs the 3-month Treasury bill: the DeFi vs TradFi dollar spread and what it says about leverage demand.

  shallow
• get_dividends

  Quarterly dividends declared per share from SEC XBRL filings: latest quarter, trailing 4 quarters, year-over-year growth and trailing yield.

  shallow
• get_dollar_liquidity

  Net dollar liquidity ($0.005): Fed total assets minus the Treasury General Account minus overnight reverse repo, now and weekly, with its 1/4/13/52-week change, a trend (EXPANDING, CONTRACTING, FLAT), its percentile over two years and a 26-week series. A macro tailwind or headwind for crypto and equities.

  shallow
• get_earnings

  Earnings of a US-listed company ($0.01): next expected report date (projected from past 8-K earnings releases), the last quarters' revenue and diluted EPS with YoY growth, and whether growth accelerates vs its own trend. SEC EDGAR, no analyst estimates.

  shallow
• get_euro_fx_rates

  ECB euro reference exchange rates for about 30 currencies with the daily change.

  shallow
• get_euro_macro

  Latest HICP inflation and unemployment rate per EU country and the euro area (Eurostat).

  shallow
• get_euro_rates

  Euro area government yield curves (AAA and all issuers, 3M-30Y) with daily change and slopes, key ECB rates and 10-year sovereign yields per country with spreads vs Germany.

  shallow
• get_european_fundamentals

  IFRS fundamentals of a European listed company from its ESEF annual report: revenue, profit, cash flow, balance sheet, growth, margins, ROE and a score.

  shallow
• get_european_short_positions

  Disclosed net short positions of one European issuer (ISIN or name): funds short, percent of capital, weekly history and a signal.

  shallow
• get_fails_to_deliver

  SEC fails-to-deliver of a US stock ($0.005): daily failed deliveries up to 120 days, value, share of shares outstanding and the Reg SHO threshold pattern (THRESHOLD_LIKE = hard to borrow, squeeze risk). Omit symbol for the largest fails on the latest settlement date.

  shallow
• get_form_144

  SEC Form 144 notices of proposed insider sales of a US-listed company: planned sale value, sellers and their relationship, approximate sale dates.

  shallow
• get_fundamental_intelligence

  Get SEC EDGAR-derived fundamental intelligence for a US equity, including growth, margins, balance-sheet ratios, latest filing context and a deterministic fundamental signal. For several tickers at once use get_fundamentals_batch.

  shallow
• get_fundamentals_batch

  Fundamentals of up to 10 US-listed companies in one call ($0.03): per ticker revenue, earnings, margins, growth, balance sheet and a fundamental signal from SEC filings.

  shallow
• get_funding_rates

  Latest funding rate, open interest and long share for every perpetual market on GMX v2 and gTrade, largest funding first.

  shallow
• get_gas_fees

  Current gas fees on Ethereum, Base, Arbitrum, Optimism, Polygon and other covered EVM chains: base fee, priority fee percentiles and the USD cost of a transfer and a swap.

  shallow
• get_insider_trades

  Insider buying and selling of a US-listed company from SEC Form 4: open-market purchases and sales, 10b5-1 plans, per-insider totals, recent transactions and a signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING). For several tickers at once use get_insider_trades_batch.

  shallow
• get_insider_trades_batch

  Insider trades for up to 10 US tickers in one call ($0.03): per ticker the SEC Form 4 buys, sales and signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING). Screens a watchlist.

  shallow
• get_macro_calendar

  Next market-moving events ($0.002) in UTC with importance, from official calendars: US CPI, jobs report, PCE, GDP, PPI, JOLTS (BLS, BEA), FOMC and ECB rate decisions. Check before opening a position.

  shallow
• get_market_intelligence

  Rank covered symbols using live trade activity, pressure, momentum, acceleration and anomaly signals. Use for a general ranking; find_strong_buying, find_strong_selling, get_top_momentum and find_unusual_activity each rank by one signal.

  shallow
• get_market_news

  Get recent crypto and US stock news headlines and corporate filing events. Results include source attribution, publication time, extracted symbols and a lightweight headline sentiment indicator. For one symbol use get_symbol_news.

  shallow
• get_market_preview

  FREE sample: 15-minute delayed 5m candles (close, USD volume, buy pressure) for ETHUSD or BTCUSD, to try the data before paying for live tools.

  shallow
• get_market_regime

  Classify the covered market as BULLISH, BEARISH or MIXED using trade-derived breadth and pressure. Use for a regime label; for a cross-asset 0-100 risk score use get_market_risk.

  shallow
• get_market_risk

  One 0-100 risk-on/risk-off score from trade-flow regime, stablecoin issuance, Treasury curve, tokenized treasury flows, perp crowding and upcoming macro releases, with each component. Use for a cross-asset risk score; for crypto breadth only use get_market_regime.

  shallow
• get_market_summary

  Get market-wide breadth, buying pressure, momentum, unusual activity and data freshness. Use for breadth numbers; for a BULLISH/BEARISH label use get_market_regime, for a 0-100 risk score get_market_risk.

  shallow
• get_most_shorted_european

  Most shorted stocks supervised by the French AMF (mostly Euronext Paris): disclosed net short interest, 30-day change, number of funds short.

  shallow
• get_oil_inventories

  US oil inventories and supply ($0.005), weekly from the EIA: commercial crude, Cushing, SPR, gasoline and distillate stocks with the weekly change and the 5-year average for the same week (a draw larger than usual is tighter supply), plus crude production, refinery utilization, imports and exports, and the next release date.

  shallow
• get_policy_news

  US administration policy news with market exposure: headlines on the President and tariffs, the Fed, sanctions, crypto and trade deals, plus every new executive order, proclamation and memorandum (Federal Register). Each item has topics, exposed sectors and symbols; no political judgement.

  shallow
• get_positioning

  Perpetual futures positioning next to the spot flow for a tokenized stock, ETF or commodity (TSLA, NVDA, SPY, QQQ, AMZN, XAUUSD gold, XAGUSD, WTIUSD, BRENTUSD, NATGASUSD, ...): open interest long/short per venue (GMX v2, gTrade), funding, 1h/24h change and a CROWDED_LONG / CROWDED_SHORT flag.

  shallow
• get_signal_track_record_summary

  FREE: live hit rate of the published signals over 7/30/90 days per horizon (5m, 15m, 1h, 24h), by signal and by confidence, plus the perp crowding record. Judge the signals before buying them.

  shallow
• get_smart_money

  Most profitable wallets trading a symbol on DEXes (addresses only): realized and unrealized PnL, win rate, holding time, and the recent net flow of the top wallets vs all wallets. Arbitrage, MEV, bots and routers are excluded.

  shallow
• get_snapshot

  Cheapest call ($0.001): headline numbers of one symbol right now: price, change, buy pressure, signal, event, confidence and trade count. Use for a quick price/pressure check; for a trade verdict use pre_trade_check, for an action with conviction get_decision_lite.

  shallow
• get_stablecoin_flows

  Net stablecoin issuance (USDC, USDT, USDT0, USDG mint minus burn) for 24h and 7d, per chain, with the hourly series of the last 48h and a NET_ISSUANCE / NET_REDEMPTION signal.

  shallow
• get_stablecoin_pegs

  Peg of the main dollar stablecoins ($0.002): USDT, DAI, USDS, USDe, PYUSD, GHO, crvUSD, RLUSD, USD1, FDUSD and USDC from Ethereum DEX prices, depth and Chainlink, with PEGGED / WATCH / DEPEG / THIN_MARKET. Refreshed every 5 minutes.

  shallow
• get_swap_quote

  Right before an on-chain swap ($0.002): how much you get now on the best route (Uniswap v2/v3/v4, Aerodrome, direct or through WETH) on Base, Ethereum, Arbitrum, Optimism or Polygon, with price impact, minimum received at your slippage and alternatives. Simulated, nothing executed.

  shallow
• get_symbol_intelligence

  Get the latest trade-derived intelligence for one symbol. Use for the raw signals of one symbol; get_snapshot is cheaper for headline numbers.

  shallow
• get_symbol_news

  News for one symbol ($0.003): headlines and SEC filing events tagged with the ticker (e.g. NVDA, ETHUSD), newest first, with publisher attribution, sentiment and an event type and materiality where classified.

  shallow
• get_symbol_report

  Everything about one symbol in a single call: snapshot, pre-trade verdict, technical indicators, perp positioning, smart money, news and, for US stocks, fundamentals, insider trades and Form 144 notices. Missing sections are listed, not failed. Use for research on one symbol; it returns data, not a single action (use get_decision_lite for that).

  shallow
• get_technical_indicators

  RSI(14), MACD(12,26,9), Bollinger(20,2), SMA20/50, ATR and VWAP on on-chain candles of a symbol, with bullish/bearish signals and an overall bias.

  shallow
• get_tokenized_equities

  24/7 trade flow of tokenized US equities and ETFs, labelled with the current US market session: reads US stock sentiment overnight, pre-market, after hours and on weekends.

  shallow
• get_tokenized_stock_premium

  Price gap (premium in bps) of the same tokenized US stock between Robinhood Chain/EVM DEX pools and Solana xStocks pools. Without symbol: latest premium of every paired stock. With symbol: history over hours with statistics per US market session.

  shallow
• get_tokenized_treasuries

  Supply and 24h/7d net issuance of tokenized treasury funds on chain (BlackRock BUIDL, Ondo USDY and OUSG, Superstate USTB, Hashnote USYC) as a risk-on/risk-off gauge.

  shallow
• get_top_activity

  Find symbols with the highest relative trade activity. Ranks by relative volume only; for statistical outliers use find_unusual_activity.

  shallow
• get_top_momentum

  Find symbols with the strongest short-term momentum score. Ranks by momentum only; for a combined ranking use get_market_intelligence.

  shallow
• get_track_record

  Live track record of the published signals: hit rate (price moved in the signal's direction) after 5m, 15m, 1h and 24h, per signal type and per confidence bucket (calibration), over the last days, optionally for one symbol, plus the latest signals with outcomes. Use for detailed hit rates per symbol and window; get_signal_track_record_summary is a free overview.

  shallow
• get_treasury_auctions

  Upcoming and recent US Treasury auctions: high yield, bid-to-cover, indirect and dealer shares, and the change vs the previous auction of the same security.

  shallow
• get_wallet_profile

  Before copying a wallet ($0.01): realized and unrealized PnL, win rate, holding style, open positions, PnL percentile among all tracked DEX wallets, a label (SMART_MONEY, PROFITABLE, UNPROFITABLE) and daily net flow, from the pools this API follows.

  shallow
• get_yield_curve

  US Treasury par and real (TIPS) yield curve with daily changes, slopes (2s10s, 3m10y, 5s30s), inversion flags, 10y breakeven inflation, and overnight rates SOFR, EFFR (NY Fed) and euro STR (ECB).

  shallow
• manage_alert_subscription

  FREE: check or cancel an alert subscription bought with subscribe_alerts. action=status returns its state, events, deliveries left and expiry; action=cancel stops it (no refund).

  shallow
• pre_trade_check

  Right before a trade: 'I want to buy (or sell) SYMBOL - is now a good moment?'. Returns a verdict (FAVORABLE, CAUTION, UNFAVORABLE), a score and the checks behind it: order flow, momentum, volatility, adverse events, market regime and news/filings of the last 24h. Use when you already know the symbol and side and only need go/no-go timing; for a full action and trade plan use get_decision.

  shallow
• query_signal_history

  Historical multi-signal query ($0.05): for up to several symbols and a UTC time range, the momentum, activity, buying, selling, anomaly and regime signals as they were at each point, in one call (replaces many signal calls for backtests and post-mortems). Use to read past signals; to measure their accuracy use backtest_signals.

  shallow
• send_feedback

  FREE: tell the operator what was missing or wrong (a route or tool you expected, a symbol without data, a confusing parameter). Read by a human; it decides the next routes.

  shallow
• subscribe_alerts

  Push instead of polling ($0.50): buys a 7-day pack of up to 200 webhook deliveries to your public HTTPS URL, signed with HMAC-SHA256. Events: decision_change (hourly decision flips), unusual_flow, funding_extreme (Hyperliquid), news (materiality filter), token_risk_change (up to 5 watched tokens), sec_filing (new SEC filings of your US tickers; needs symbols, filter with forms). Returns the subscription id and its secret (shown once).

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/5b7c01cf-e4e2-4e66-abc8-749988acbe30/badge.svg)](https://vouch.tools/servers/5b7c01cf-e4e2-4e66-abc8-749988acbe30)