com.marketintelligenceapi.api/market-intelligence

Market Intelligence API

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

1.8.0
Version
remote
Transport
82
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 82 tools scanned
  • metadata: scanned

No findings.

Tools (82)

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

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

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

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

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

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

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

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

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

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

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

  • get_token_verdict

    Is this token safe to buy? 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 and the top three risks. 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.

  • get_token_price

    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.

  • get_token_traders

    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.

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

  • get_swap_quote

    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.

  • get_macro_calendar

    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.

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

  • get_oil_inventories

    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.

  • get_defi_yields

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

  • get_prediction_markets

    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.

  • get_prediction_market_movers

    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.

  • get_fed_rate_odds

    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.

  • get_stablecoin_pegs

    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.

  • find_funding_carry

    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.

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

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

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

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

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

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

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

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

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

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

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

  • get_funding_rates

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

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

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

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

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

  • get_dividends

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

  • get_fails_to_deliver

    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.

  • get_cot_positioning

    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.

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

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

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

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

  • get_euro_fx_rates

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

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

  • get_euro_macro

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

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

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

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

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

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

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

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

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

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

  • get_bank_credit

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

  • get_dollar_liquidity

    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.

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

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

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

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

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

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

  • get_top_momentum

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

  • get_top_activity

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

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

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

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

  • find_strong_buying

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

  • find_strong_selling

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

  • compare_symbols

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

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

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

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

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

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

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