market-intelligence-api

Market Intelligence API gives AI agents live market data and analysis they pay for per call with x402 (USDC on Base, Polygon, Arbitrum, World Chain, Solana…

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • 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, sma
  • 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 (about 40, e.g. ETHUSD, B

What data it sees

Do you need an account

No: the server works without sign-in

Market Intelligence API gives AI agents live market data and analysis they pay for per call with x402 (USDC on Base, Polygon, Arbitrum, World Chain, Solana, or EURC). No account or API key is needed. It covers on-chain DEX order flow, a one-call trading decision (with a public track record), risk checks for new tokens on Base and Ethereum (Uniswap v2/v3/v4 hooks, sell simulation, holders, impersonation), swap quotes, Hyperliquid perps and funding carry, SEC filings, insider trades, CFTC futures positioning and a macro calendar. It is also an MCP server with 71 tools. Every paid route can be tried for free on Base Sepolia with faucet USDC.

How to connect

How to connect market-intelligence-api to Claude

The server address to paste into Claude settings:

https://market-intelligence-api--hisazzul.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect market-intelligence-api to ChatGPT

The server address to paste into ChatGPT settings:

https://market-intelligence-api--hisazzul.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect market-intelligence-api to Cursor

The server address to paste into Cursor settings:

https://market-intelligence-api--hisazzul.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (60)

Raw names from tools/list. Only developers need these.

find_opportunitiesGoal-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.
get_market_previewFREE 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_sampleFREE sample of the premium decision: the latest hourly decision (action, direction, conviction, pillar scores) of every symbol with live on-chain trading (about 40, 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_feedbackFREE: 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_liteCheap 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.
get_signal_track_record_summaryFREE: 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_coverageFREE: which data sources cover each symbol (spot on-chain DEX flow, perp venues), so you know what a paid call will return.
get_snapshotCheapest call ($0.001): headline numbers of one symbol right now: price, change, buy pressure, signal, event, confidence and trade count.
pre_trade_checkRight 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.
analyze_tokenSend 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.
check_token_riskDue 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.
find_new_tokensTokens 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_quoteRight 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.
get_macro_calendarNext 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.
check_portfolioReview 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).
get_stablecoin_pegsPeg 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.
find_funding_carryCarry 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.
get_wallet_profileBefore copying a wallet ($0.01): realized and unrealized PnL, win rate, holding style, open positions, PnL percentile among ~7,000 tracked wallets, a label (SMART_MONEY, PROFITABLE, UNPROFITABLE) and daily net flow, from the pools this API follows.
get_tokenized_stock_premiumPrice 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_datasetOne 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_tradesInsider 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).
get_insider_trades_batchInsider 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.
get_fundamentals_batchFundamentals 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_moveWhy 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_earningsEarnings 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_reportEverything 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.
get_technical_indicatorsRSI(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_flowsNet 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_ratesLatest funding rate, open interest and long share for every perpetual market on GMX v2 and gTrade, largest funding first.
get_market_riskOne 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.
get_gas_feesCurrent 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_144SEC Form 144 notices of proposed insider sales of a US-listed company: planned sale value, sellers and their relationship, approximate sale dates.
get_beneficial_ownershipSEC Schedule 13D (activist) and 13G (passive) filings of holders above 5% of a US-listed company, with holder names and percent of class.
get_dividendsQuarterly dividends declared per share from SEC XBRL filings: latest quarter, trailing 4 quarters, year-over-year growth and trailing yield.
get_fails_to_deliverSEC 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.
get_cot_positioningCFTC 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.
get_decisionPremium 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.
get_decisions_batchPremium 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.
subscribe_alertsPush 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_newsUS 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_ratesECB euro reference exchange rates for about 30 currencies with the daily change.
get_euro_ratesEuro 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_macroLatest HICP inflation and unemployment rate per EU country and the euro area (Eurostat).
get_most_shorted_europeanMost shorted stocks supervised by the French AMF (mostly Euronext Paris): disclosed net short interest, 30-day change, number of funds short.
get_european_short_positionsDisclosed net short positions of one European issuer (ISIN or name): funds short, percent of capital, weekly history and a signal.
get_european_fundamentalsIFRS 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_recordLive 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.
get_positioningPerpetual 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_moneyMost 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_curveUS 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_spreadUSDC 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_treasuriesSupply 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_treasury_auctionsUpcoming 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_candlesOHLCV candles for a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count.
get_tokenized_equities24/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_intelligenceRank covered symbols using live trade activity, pressure, momentum, acceleration and anomaly signals.
get_market_summaryGet market-wide breadth, buying pressure, momentum, unusual activity and data freshness.
get_symbol_intelligenceGet the latest trade-derived intelligence for one symbol.
get_top_momentumFind symbols with the strongest short-term momentum score.
get_top_activityFind symbols with the highest relative trade activity.