Market Intelligence API

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Market data for AI agents via x402: token safety, DeFi yields, order flow, SEC filings, macro, perps

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Market Intelligence API": {
      "url": "https://api.marketintelligenceapi.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (90)

• find_opportunities read-only

  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.

  Parameters:

  • objective (required) — string — What to look for
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m
  • include — array — Blocks to return; default all
  • universe — array — Symbols to scan (max 100); omit for all covered symbols
  • assetClass — string — Restrict to crypto, us_equity or perp_only symbols
  • maxResults — integer — Maximum number of ranked symbols (default 10)
  • minVolumeUsd — number — USD traded in the window
  • minConfidence — number — Minimum signal confidence, 0-100
  • minBuyPressure — number — Pressure on the objective's side (buy for buying, sell for selling)
  • minVolumeMultiple — number — Volume vs the symbol's own baseline
  • minIndependentSources — integer — Distinct sources confirming the direction

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_preview read-only

  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.

  Parameters:

  • symbol — string — Any covered symbol, not only the examples: crypto pair (ETHUSD), US ticker (NVDA) or ISIN; free list via get_data_coverage. Unknown symbols are not charged

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_decision_sample read-only

  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.

  Parameters:

  • symbol — string — Optional; omit for all ten symbols

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• send_feedback read-only

  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.

  Parameters:

  • route — string — Route or tool it is about (optional)
  • rating — integer — Optional 1-5 rating of the route or tool
  • message — string — Anything else, up to 1000 characters
  • missing — string — What you needed and did not find

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_decision_track_record read-only

  FREE: how the decision engine has done: hit rate and average move after its BUY and SELL calls by horizon (1h, 4h, 24h) over the last days, optionally for one symbol. Judge it before paying for get_decision.

  Parameters:

  • days — integer — Number of days to cover (look-back; days ahead for calendars)
  • symbol — string — Optional, e.g. ETHUSD or NVDA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_datasets read-only

  FREE: the dataset catalog: which symbols, dates and candle resolutions can be bought with get_dataset (one UTC day of candles with the buy/sell split per venue, JSON or CSV).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_credit_balance read-only

  FREE: the prepaid credit of the API key sent in X-API-Key (balance, spent, calls), and the credit packs on sale. Without a key: the packs only.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_gift_link read-only

  FREE: status of a USDC gift link by its key address (OPEN with amount, fee and expiry; EXPIRED; CLOSED; NOT_FOUND), or without a key the gift contract, chain, fee and limits.

  Parameters:

  • key — string — Optional: the gift's key address (0x...), as in /gift/{key}

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_service_status read-only

  FREE: is the service healthy right now: freshness of every data source, live symbols and the last updates, as on /status.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_transparency read-only

  FREE: who runs this service, data sources and their licences, what is stored, payment terms and contacts, as on /transparency.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• prepare_gift_link read-only

  FREE: send USDC by link, step 1 of 2. Returns a gift link and the EIP-712 USDC authorization (typedData) for your wallet to sign; the same kind of signature as an x402 payment, no gas. The recipient opens the link and claims to any wallet or exchange address. Fee 1% on top, kept only when claimed; an unclaimed gift goes back to the sender. Then call fund_gift_link.

  Parameters:

  • amountUsdc (required) — string — What the recipient gets, in USDC, e.g. "5" or "2.50"
  • from (required) — string — 0x address of your wallet that pays (USDC on Base)
  • keyAddress — string — Optional: the address of a one-time key you made; then no one else ever sees the link key
  • expiresInDays — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• fund_gift_link read-only

  FREE: send USDC by link, step 2 of 2. Pass the giftKey from prepare_gift_link and your wallet's signature of its typedData; our relayer submits it (gas paid by us) and the money moves from your wallet into the gift contract. The link works once mined.

  Parameters:

  • giftKey (required) — string — giftKey returned by prepare_gift_link
  • signature (required) — string — 65-byte hex signature (eth_signTypedData_v4) of typedData

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_decision_lite read-only

  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.

  Parameters:

  • symbol (required) — string — Crypto pair (ETHUSD), US ticker (NVDA) or ISIN
  • side — string — Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_signal_track_record_summary read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_data_coverage read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_snapshot read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, BTCUSD, NVDA, TSLA
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• pre_trade_check read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, BTCUSD, NVDA, TSLA
  • side — string — The side you intend to trade: buy or sell
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• analyze_token read-only

  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.

  Parameters:

  • address (required) — string — 0x-prefixed token contract address
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• check_token_risk read-only

  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 for the full due-diligence report with every check; for a short answer use get_token_verdict.

  Parameters:

  • address (required) — string — 0x-prefixed ERC-20 contract, or a base58 Solana mint
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_token_verdict read-only

  Use when the user asks "is this token safe?", "is it a rug or a honeypot?", "check this CA" or "can I sell it?". Send a token contract address (Base by default; also ethereum, arbitrum, optimism, polygon, or a Solana mint), get a short verdict: LOW_RISK, CAUTION or HIGH_RISK, a 0-100 safety score, one plain-language sentence, whether a simulated sale succeeds (honeypot check), observed buy tax, liquidity, who controls the contract, the top three risks, a oneLiner to quote and a share card. Cheaper and shorter than check_token_risk. Use for a quick safe-to-buy answer; for every check and the raw contract, liquidity and simulation data use check_token_risk.

  Parameters:

  • address (required) — string — 0x-prefixed ERC-20 contract, or a base58 Solana mint
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_token_price read-only

  Live USD price of any token by contract address ($0.001): Base by default, also ethereum, arbitrum, optimism, polygon. From a simulated $100 buy and sale on the best on-chain route (Uniswap v2/v3/v4, Aerodrome): price, buy and sell price, round-trip cost (liquidity), total supply and fully diluted value. Use for the current USD price of one token by address; for a full swap quote of a size use get_swap_quote.

  Parameters:

  • address (required) — string — 0x-prefixed ERC-20 contract address
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_token_traders read-only

  Who bought and who sold a token in the last hour ($0.01): send an ERC-20 contract address (Base by default; also ethereum, arbitrum, optimism, polygon), get the top buyers and sellers by net USD, each the wallet that signed the swap, with buys, sells, a label from the tracked pools (SMART_MONEY, PROFITABLE, UNPROFITABLE, UNTRACKED), an automated flag, unique wallets, top-10 buyer share and smart-money net flow. Use to see which wallets are buying or selling a token; for the aggregate flow use analyze_token, for one wallet's record get_wallet_profile.

  Parameters:

  • address (required) — string — 0x-prefixed ERC-20 contract address
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network
  • limit — integer — Maximum number of results

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_new_tokens read-only

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

  Parameters:

  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network
  • limit — integer — Maximum number of results
  • minutes — integer — Look-back for new pools in minutes (default 60)
  • verdict — string — Keep only tokens with this risk verdict: LOW_RISK, CAUTION or HIGH_RISK
  • minLiquidityUsd — number — Minimum pool liquidity in USD
  • includeEstablished — boolean — Also list new pools of tokens that already existed a day earlier (new markets, not launches)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_swap_quote read-only

  Right before an on-chain swap ($0.005): 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.

  Parameters:

  • sell (required) — string — ETH, WETH, USDC or a 0x token address
  • buy (required) — string — ETH, WETH, USDC or a 0x token address
  • amount (required) — string — Sell amount in whole units, e.g. 1000
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network
  • slippageBps — integer — Slippage tolerance for the minimum received, in basis points

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_macro_calendar read-only

  Next market-moving events ($0.005) 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.

  Parameters:

  • days — integer — Number of days to cover (look-back; days ahead for calendars)
  • region — string — Region: all, us or eu
  • importance — string — Minimum importance of the events to include

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• check_portfolio read-only

  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.

  Parameters:

  • tokens — array — On-chain tokens to review: up to 5 objects with address, chain and valueUsd
  • decisions — boolean — Include the live decision for each position
  • positions — array — Holdings: up to 15 objects with symbol and valueUsd or quantity

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_oil_inventories read-only

  US oil inventories and supply ($0.01), 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_defi_yields read-only

  DeFi lending yields ($0.002): supply and borrow APY, utilization and USD size of every Aave v3 (Ethereum, Base, Arbitrum, Optimism, Polygon), Spark and Compound v3 market, read on chain every 10 minutes, highest supply APY first, with the best USDC, USDT, WETH, WBTC and DAI rate. Base yield only (no reward tokens).

  Parameters:

  • asset — string — Token symbol (USDC, WETH, ...) or stablecoins for every stablecoin; omit for all
  • chain — string — Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed). Not the payment network
  • limit — integer — Maximum number of results
  • protocol — string
  • minTvlUsd — number — Leave out markets with less supplied

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_prediction_markets read-only

  Prediction markets live from Hyperliquid HIP-4 ($0.005): every open market as a plain question with each option's probability, 24h change in points and 24h USDC volume, most traded first: crypto and stock price targets, Fed and central-bank rate decisions, IPOs (Anthropic, OpenAI), sports and awards. Filter by category or text.

  Parameters:

  • q — string — Text to find in the question or options, e.g. BTC, FOMC, Anthropic
  • limit — integer — Maximum number of results
  • category — string — News category; omit for all

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_prediction_market_movers read-only

  Biggest odds moves in prediction markets ($0.005): Hyperliquid markets whose probability changed most over the last hours=1-720 (default 24), with the option, from and to probability, change in points, volume and resolution date. Use to catch repricing of Fed, IPO, crypto and stock events early.

  Parameters:

  • hours — integer — Look-back in hours
  • limit — integer — Maximum number of results
  • category — string — News category; omit for all
  • minVolumeUsd — number — Leave out markets with less 24h volume

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_fed_rate_odds read-only

  Fed rate decision odds ($0.005): probability of a cut, no change or a hike at the next FOMC and other central-bank decisions, from Hyperliquid prediction markets, with 24h change, volume and the decision date.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_stablecoin_pegs read-only

  Peg of the main dollar stablecoins ($0.005): 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_funding_carry read-only

  Carry trades ($0.01): 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.

  Parameters:

  • limit — integer — Maximum number of results
  • minOiUsd — number — Minimum open interest in USD
  • minFundingAnnualPercent — number — Minimum annualized funding in percent

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_wallet_profile read-only

  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.

  Parameters:

  • address (required) — string — 0x wallet address

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_tokenized_stock_premium read-only

  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.

  Parameters:

  • hours — integer — Look-back in hours
  • symbol — string — Optional ticker for history, e.g. NVDA
  • symbols — string — Optional comma-separated tickers for the latest premiums
  • interval — string — Candle interval

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_dataset read-only

  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.

  Parameters:

  • symbol (required) — string — Any covered symbol, not only the examples: crypto pair (ETHUSD), US ticker (NVDA) or ISIN; free list via get_data_coverage. Unknown symbols are not charged
  • date — string — YYYY-MM-DD (UTC); defaults to yesterday
  • interval — string — Candle interval

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_insider_trades read-only

  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.

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. TSLA
  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_insider_trades_batch read-only

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

  Parameters:

  • symbols (required) — array — US tickers, e.g. ["TSLA", "NVDA"]
  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_fundamentals_batch read-only

  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.

  Parameters:

  • symbols (required) — array — US tickers, e.g. ["AAPL", "MSFT"]

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• explain_move read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, NVDA, TSLA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_earnings read-only

  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.

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. AAPL

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_symbol_report read-only

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

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, NVDA, TSLA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_technical_indicators read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, NVDA
  • interval — string — Candle interval

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_stablecoin_flows read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_funding_rates read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_risk read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_gas_fees read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_form_144 read-only

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

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. NVDA
  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_beneficial_ownership read-only

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

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. AAPL
  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_dividends read-only

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

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. MSFT

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_fails_to_deliver read-only

  SEC fails-to-deliver of a US stock ($0.01): 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.

  Parameters:

  • days — integer — Number of days to cover (look-back; days ahead for calendars)
  • symbol — string — US ticker, e.g. GME; omit for the market-wide top list

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_cot_positioning read-only

  CFTC Commitments of Traders ($0.01): 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.

  Parameters:

  • weeks — integer — Weeks of history per market
  • market — string — e.g. gold, wti, sp500, ust10y, eur, bitcoin (aliases GOLD, SPY, BTC, EURUSD)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_decision read-only

  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.

  Parameters:

  • side — string — Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side
  • format — string — compact drops evidence text to save context
  • symbol — string — Optional: ETHUSD, NVDA, or an ISIN such as FR0000131906
  • include — array — Optional: modules to use (default all)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_decisions_batch read-only

  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.

  Parameters:

  • symbols (required) — array — Crypto pairs (ETHUSD), US tickers (NVDA) or ISINs
  • side — string — Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side
  • format — string — compact drops evidence text to save context
  • include — array — Optional: modules to use (default all)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• subscribe_alerts read-only

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

  Parameters:

  • url (required) — string — Public HTTPS URL that receives the POSTs
  • events (required) — array — Event types to receive: decision_change, unusual_flow, funding_extreme, news, token_risk_change, stablecoin_depeg, prediction_market_move, sec_filing
  • forms — array — For sec_filing: only these forms (default all)
  • tokens — array — For token_risk_change: [{"address": "0x...", "chain": "base"}]
  • symbols — array — Optional: only these symbols
  • categories — array — News categories for news events; omit for all
  • minMateriality — integer — Minimum news materiality, 1-5

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_policy_news read-only

  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.

  Parameters:

  • hours — integer — Look-back in hours
  • limit — integer — Maximum number of results
  • topic — string — Policy topic; omit for all
  • symbol — string — Optional exposed symbol, e.g. NVDA, BTCUSD

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_euro_fx_rates read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_euro_rates read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_euro_macro read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_most_shorted_european read-only

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

  Parameters:

  • limit — integer — Maximum number of results

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_european_short_positions read-only

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

  Parameters:

  • issuer (required) — string — ISIN (FR0000131906) or name (Renault)
  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_european_fundamentals read-only

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

  Parameters:

  • company (required) — string — LEI, ISIN or company name

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_track_record read-only

  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.

  Parameters:

  • days — integer — Number of days to cover (look-back; days ahead for calendars)
  • symbol — string — Optional symbol, e.g. ETHUSD
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_positioning read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. TSLA, XAUUSD

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_smart_money read-only

  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.

  Parameters:

  • symbol (required) — string — e.g. ETHUSD, BTCUSD, NVDA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_yield_curve read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_defi_rate_spread read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_tokenized_treasuries read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_bank_credit read-only

  US bank credit and deposits ($0.01), 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).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_dollar_liquidity read-only

  Net dollar liquidity ($0.01): 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_treasury_auctions read-only

  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.

  Parameters:

  • days — integer — Number of days to cover (look-back; days ahead for calendars)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_candles read-only

  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.

  Parameters:

  • symbol (required) — string — Any covered symbol, not only the examples: crypto pair (ETHUSD), US ticker (NVDA) or ISIN; free list via get_data_coverage. Unknown symbols are not charged
  • limit — integer — Maximum number of results
  • interval — string — Candle interval

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_tokenized_equities read-only

  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.

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_intelligence read-only

  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.

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_summary read-only

  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.

  Parameters:

  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_symbol_intelligence read-only

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

  Parameters:

  • symbol (required) — string — Any covered symbol, not only the examples: crypto pair (ETHUSD), US ticker (NVDA) or ISIN; free list via get_data_coverage. Unknown symbols are not charged
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_top_momentum read-only

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

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_top_activity read-only

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

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_market_events read-only

  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.

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• backtest_signals read-only

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

  Parameters:

  • end — string — ISO-8601 end timestamp; defaults to now
  • start — string — ISO-8601 start timestamp; defaults to 24h ago
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m
  • symbols — string — Optional comma-separated symbols
  • minConfidence — integer — Minimum signal confidence, 0-100
  • minBaselineSamples — integer — Minimum baseline buckets a symbol needs to be scored

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_unusual_activity read-only

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

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m
  • minTrades — integer — Minimum trades in the window
  • minAnomaly — number — Minimum anomaly score

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_strong_buying read-only

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

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m
  • minBuyPressure — number — Minimum buy pressure in percent (50-100)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_strong_selling read-only

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

  Parameters:

  • limit — integer — Maximum number of results
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m
  • maxBuyPressure — number — Maximum buy pressure in percent (0-50)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• compare_symbols read-only

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

  Parameters:

  • symbols (required) — string — Comma-separated symbols, e.g. BTCUSD,ETHUSD,SOLUSD
  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_regime read-only

  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.

  Parameters:

  • window — string — Aggregation window of the live trade buckets: 1m, 5m (default) or 15m

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_fundamental_intelligence read-only

  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 a crypto pair (BTCUSD): perp price, volume, open interest, funding and CME positioning. For several tickers at once use get_fundamentals_batch.

  Parameters:

  • symbol (required) — string — US equity ticker, e.g. AAPL, MSFT, NVDA, or a crypto pair, e.g. BTCUSD

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_market_news read-only

  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.

  Parameters:

  • limit — integer — Maximum number of results
  • query — string — Optional keyword, company, or ticker query
  • category — string — News category; omit for all

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• manage_alert_subscription destructive

  FREE: manage an alert subscription bought with subscribe_alerts. action=status (state, deliveries left, expiry), events (the last 14 days with payloads, since= to catch up), test (send a test delivery), resume (re-activate a suspended one, optionally at a new url) or cancel (no refund).

  Parameters:

  • id (required) — string — Subscription id returned by subscribe_alerts
  • secret (required) — string — Subscription secret returned by subscribe_alerts
  • url — string — resume: a new public HTTPS webhook URL (optional)
  • since — string — events: ISO-8601 time to start from, e.g. 2026-10-20T08:00:00Z
  • action — string

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• get_symbol_news read-only

  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.

  Parameters:

  • symbol (required) — string — Ticker or crypto pair, e.g. NVDA, TSLA, ETHUSD
  • limit — integer — Maximum number of results

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• query_signal_history read-only

  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.

  Parameters:

  • symbols (required) — string — Comma-separated, e.g. BTCUSD,ETHUSD
  • from (required) — string — ISO-8601 UTC start, e.g. 2026-09-29T00:00:00Z
  • to (required) — string — ISO-8601 UTC end, e.g. 2026-09-29T06:00:00Z
  • signals — string — Optional comma-separated: momentum,activity,buying,selling,anomaly,regime

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.