Market Intelligence API
Market data for AI agents: token safety and honeypot checks, on-chain order flow, SEC filings and insider trades, Fed and Treasury data, DeFi yields. Pay per call with x402, no account.
Hosted MCP Server
npx add-mcp 'https://api.marketintelligenceapi.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Market data for AI agents, pay per call with x402: token safety and honeypot checks before you buy (Base, Ethereum, Solana), stablecoin peg monitor, DeFi lending yields, SEC filings, fundamentals and insider trades, Treasury yield curve, Fed liquidity and rate odds, Hyperliquid funding and positioning, on-chain order flow from executed DEX trades on six EVM chains and Solana, CFTC positioning, macro calendar and news. Every answer is timestamped and names its source.
Pay per call with x402 in USDC (Base, Polygon, Arbitrum, World Chain, Solana) or EURC (Base, World Chain). No account, no API key, no subscription to manage. Trying it out? Routes up to $0.05 also accept free faucet USDC on Base Sepolia (eip155:84532), 10 calls per wallet per day.
Building an agent? Plugins that pay for you: ElizaOS plugin · Coinbase AgentKit provider · Python and TypeScript examples · MCP servers /mcp (setup) and /mcp/core (15 core tools), also on Smithery: full · core.
Start here
Who is buying and selling right now?GET /api/v1/intelligence/ETHUSD $0.005 · executed DEX trades: buy/sell pressure, momentum, anomaly vs its own baseline, large trades, order cost; market-wide: /api/v1/intelligence/summary
Is this token safe to buy? Can I sell it later?GET /api/v1/intelligence/token-risk/{address}?chain=base $0.02 · sell simulation and contract checks; chain = base, ethereum, arbitrum, optimism, polygon or solana
Is the trade crowded?GET /api/v1/intelligence/positioning/ETHUSD $0.01 · perp open interest, funding and crowding next to spot flow; carry: /api/v1/markets/funding-carry
Everything filed about one stock GET /api/v1/report/NVDA $0.03 · SEC fundamentals, insiders, Form 144, 13D/13G, fails-to-deliver, flow, technicals and news in one call
Bring your own numbers POST /api/v1/analytics/zscore $0.01 · exact, deterministic statistics on values you supply: z-score, percentile, correlation, weighted score, anomaly, confidence
Want one combined view?GET /api/v1/decision/lite/ETHUSD?side=buy $0.05 · a rule-based aggregation of the data above; check its free live hit rate first: /api/v1/decision/track-record
Data at a glance
- 56 symbols with live on-chain trading (14 quieter ones still covered), on-chain trade history since 2026-09-23, updated every minute.
- Decisions, measured: 49.0% of directional calls were right after 4 hours (4863 evaluated). The data endpoints are the product; the decisions are an aggregation of them, published with this record.
- Freshness of every chain and source: /status.
Why agents use it
- Observed data, not opinions. Values come from executed on-chain trades, official filings and central-bank releases, each with a timestamp and its source.
- You pay only for answers. Charged only on HTTP 2xx: validation errors, server failures and symbols without data (404) cost nothing.
- Nothing hidden. Free delayed samples, live data freshness per source, and the measured hit rates of every signal and decision.
- Built for agent context windows. Compact formats, typed verdicts (LOW_RISK / HIGH_RISK, FAVORABLE / CAUTION),
nextActionswith the next call and its price. - One API for crypto, US and European markets, from on-chain order flow to SEC and ESEF filings, ECB data and US policy news.
- Push, not poll. Signed webhooks for unusual flow, extreme funding, stablecoin depegs, material news, token risk and decision changes.
- MCP or HTTP. The same data as 82 MCP tools at
https://api.marketintelligenceapi.com/mcp.
Free to try
- /api/v1/decision/sample: The latest hourly decisions of every live symbol, an hour old, with what the price did afterwards
- /api/v1/decision/track-record: Hit rates of every logged decision after 1h, 4h and 24h
- /track-record: Hit rates and calibration of the signals
- /api/v1/preview?symbol=ETHUSD: 15-minute delayed sample of the candle data
- /api/v1/datasets: Which symbols are live and which dates can be bought
- /coverage: Which sources cover each symbol, so you know what a paid call returns
- /api/v1/feedback: Missing a route, a symbol or a field? Tell us: POST here (free), read by a human
- /api/v1/credits: Prepaid credits for MCP clients without a wallet: packs, top-up and balance
- /api/v1/alerts: Webhook events, filters, the pack and how to verify signatures
- /status: Live data freshness per chain and source
- /transparency: Operator, data sources, prices and billing policy
- /pricing: Price of every route, also as JSON
Paid endpoints
Order flow and signals
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/intelligence/snapshot/ETHUSD | $0.001 | Cheapest live read of one asset: price, change, buy pressure, signal and confidence |
GET /api/v1/intelligence/ETHUSD | $0.005 | Full signal of one asset: buy/sell pressure, momentum, anomaly vs its own baseline, large trades and the on-chain cost of a $1k/$10k/$50k order |
GET /api/v1/intelligence/summary | $0.01 | Market overview in one call: breadth, regime and top movers |
GET /api/v1/intelligence | $0.01 | Ranked signals for every covered asset |
GET /api/v1/intelligence/top-momentum | $0.005 | Strongest short-term movers |
GET /api/v1/intelligence/top-activity | $0.005 | Where trading concentrates versus each asset's baseline |
GET /api/v1/intelligence/buying | $0.005 | Assets under aggressive buying |
GET /api/v1/intelligence/selling | $0.005 | Assets under aggressive selling |
GET /api/v1/intelligence/unusual | $0.01 | Statistical anomalies in trade count or volume |
GET /api/v1/intelligence/events | $0.01 | Accumulation, breakout, distribution and capitulation events |
GET /api/v1/intelligence/regime | $0.005 | Is the market bullish, bearish or mixed right now? |
GET /api/v1/intelligence/compare?symbols=ETHUSD,BTCUSD,NVDA | $0.01 | Several assets side by side |
GET /api/v1/intelligence/candles/ETHUSD?interval=5m | $0.005 | OHLCV candles with aggressive buy/sell volume, buy pressure and VWAP |
GET /api/v1/intelligence/equities | $0.005 | US stock sentiment around the clock: 24/7 flow of tokenized stocks and ETFs, labelled overnight, pre-market, after hours or weekend |
GET /api/v1/intelligence/smart-money/ETHUSD | $0.02 | What the most profitable DEX wallets of an asset are doing now |
GET /api/v1/intelligence/wallet/0xb21e8ec81ce0cca1b1dcda68bf6bc22015005942 | $0.01 | Should I copy this wallet? Its PnL, win rate, holding style, open positions and PnL percentile among all tracked DEX wallets, with a label |
GET /api/v1/intelligence/premium | $0.01 | Arbitrage view: price gap of tokenized stocks between Robinhood Chain/EVM pools and Solana xStocks pools |
GET /api/v1/intelligence/premium/NVDA?hours=72 | $0.01 | Premium history of one tokenized stock with statistics per US market session |
GET /api/v1/markets/technical/ETHUSD?interval=15m | $0.01 | RSI, MACD, Bollinger, SMA, ATR and VWAP with signals and an overall bias |
Before buying a token
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/intelligence/token-price/{address}?chain=base | $0.001 | What is it worth? Live USD price of any token from a simulated buy and sale on chain, with round-trip cost and fully diluted value |
GET /api/v1/intelligence/token-traders/{address}?chain=base | $0.01 | Who is buying it? The top buyers and sellers of the last hour, per signing wallet, with labels from tracked PnL |
GET /api/v1/intelligence/token-verdict/{address}?chain=base | $0.01 | Is it safe to buy? The short answer: LOW_RISK, CAUTION or HIGH_RISK, one sentence, can it be sold, tax, liquidity and the top three risks |
GET /api/v1/intelligence/token-risk/{address}?chain=base | $0.02 | Can I sell it after I buy it? Honeypot sell/buy simulation, owner and proxy, mint/blacklist/pause/fee functions, liquidity, LP burn and tax on Base, Ethereum, Arbitrum, Optimism and Polygon; mint/freeze authority and Token-2022 traps on Solana; a 0-100 safety score |
GET /api/v1/intelligence/quote?chain=base&sell=USDC&buy=WETH&amount=1000 | $0.005 | What will I get? The best on-chain route right now across Uniswap v2/v3/v4 and Aerodrome (direct or via WETH) on five chains, with price impact, minimum received at your slippage and alternatives |
GET /api/v1/intelligence/new-tokens?chain=base&minutes=60 | $0.02 | What just launched? Tokens whose first pool against ETH/WETH/USDC was created in the last hour on Base or Ethereum (Uniswap v2/v3/v4, Aerodrome), each already risk-checked: liquidity, sell simulation, v4 hook powers and a verdict |
GET /api/v1/intelligence/token/{address}?chain=base | $0.01 | Who is buying it? Live DEX flow of any ERC-20 on Base, Ethereum, Arbitrum, Optimism or Polygon: buy/sell volume, buy pressure, price change, largest trade, trader concentration and a verdict |
Derivatives and market risk
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/intelligence/positioning/XAUUSD | $0.01 | Is the trade crowded? Perp open interest, funding and crowding for crypto, stocks, ETFs and commodities next to spot flow |
GET /api/v1/markets/funding-carry | $0.01 | Where is holding a hedged perp paid? Hyperliquid markets ranked by the size and steadiness of their funding, the side that collects it, spot for the hedge and cross-venue spreads |
GET /api/v1/markets/funding-rates | $0.001 | Perp funding and open interest on Hyperliquid, GMX v2 and gTrade |
GET /api/v1/markets/risk | $0.01 | Should I reduce risk? A 0-100 risk-on/risk-off score with its components |
GET /api/v1/markets/yields?asset=USDC | $0.002 | Where does my idle USDC or ETH earn the most? Supply and borrow APY, utilization and size of every Aave v3, Spark and Compound v3 market, read on chain every 10 minutes |
GET /api/v1/markets/stablecoins | $0.005 | Is my stablecoin still worth a dollar? Peg of USDT, DAI, USDS, USDe, PYUSD, GHO, crvUSD, RLUSD, USD1, FDUSD and USDC from DEX prices, depth and Chainlink, every 5 minutes |
GET /api/v1/markets/stablecoin-flows | $0.005 | Fresh money in or out of crypto: net USDC/USDT issuance for 24h and 7d per chain |
GET /api/v1/markets/gas | $0.001 | Cheapest chain to transact on: gas fees and transfer/swap cost per EVM chain |
US stocks: SEC filings
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/fundamentals/AAPL | $0.005 | SEC XBRL financials (growth, margins, balance sheet), latest filing and a fundamental signal |
GET /api/v1/insiders/TSLA?days=90 | $0.005 | Are insiders buying? Form 4 purchases and sales, 10b5-1 plans and a cluster-buying signal |
GET /api/v1/insiders/batch?symbols=TSLA,NVDA,AAPL | $0.03 | Insider signals for a whole watchlist (up to 10 tickers) in one call |
GET /api/v1/fundamentals/batch?symbols=AAPL,MSFT,NVDA | $0.03 | Compare the fundamentals of up to 10 companies in one call |
GET /api/v1/earnings/AAPL | $0.01 | Next earnings date, last quarters' revenue and EPS, growth vs its own trend |
GET /api/v1/explain/NVDA | $0.02 | Why is it moving? Every source turned into ranked drivers and one sentence |
GET /api/v1/sec/form-144/NVDA?days=90 | $0.01 | Insider sales announced before they happen (Form 144) |
GET /api/v1/sec/ownership/AAPL | $0.01 | Holders above 5% from Schedule 13D/13G, with an activist flag |
GET /api/v1/sec/dividends/MSFT | $0.01 | Dividends per share, growth and trailing yield |
GET /api/v1/sec/fails-to-deliver/GME | $0.01 | Hard to borrow? Daily fails-to-deliver and the Reg SHO threshold pattern (squeeze risk) |
GET /api/v1/sec/fails-to-deliver | $0.01 | The largest fails-to-deliver on the latest settlement date |
Europe
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/eu/short-positions | $0.01 | Most shorted European stocks from AMF disclosures |
GET /api/v1/eu/short-positions/FR0000131906 | $0.01 | Which funds are short one European issuer, with weekly history |
GET /api/v1/eu/fundamentals/RENAULT | $0.005 | IFRS fundamentals from ESEF annual reports |
GET /api/v1/eu/fx | $0.001 | ECB euro reference exchange rates for about 30 currencies |
GET /api/v1/eu/rates | $0.01 | Euro yield curves, ECB key rates and sovereign spreads vs the Bund |
GET /api/v1/eu/macro | $0.01 | EU inflation and unemployment per country |
US rates and on-chain yield
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/rates/curve | $0.01 | Treasury yield curve, slopes, inversion, breakeven inflation, SOFR and euro STR |
GET /api/v1/rates/defi-spread | $0.01 | Where cash earns more: Aave USDC rates on five chains vs the 3-month T-bill |
GET /api/v1/rates/tokenized-treasuries | $0.01 | On-chain treasury fund supply (BUIDL, USDY, OUSG, USTB, USYC) as a risk gauge |
GET /api/v1/rates/auctions | $0.01 | Upcoming and recent Treasury auctions with demand metrics |
GET /api/v1/rates/bank-credit | $0.01 | US bank lending and deposits by loan type with growth and momentum (Fed H.8) |
GET /api/v1/rates/liquidity | $0.01 | Net dollar liquidity (Fed balance sheet - TGA - reverse repo): trend and percentile, the macro tide for crypto and equities |
Macro calendar
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/cot | $0.01 | Where futures speculators are crowded: CFTC Commitments of Traders for 24 markets with a 3-year COT index |
GET /api/v1/cot/gold?weeks=26 | $0.01 | One market's positioning history: gold, WTI, S&P 500, Treasuries, EUR, JPY, bitcoin, ether... |
GET /api/v1/markets/oil-inventories | $0.01 | Weekly US oil stocks (crude, Cushing, SPR, gasoline, distillate) vs the 5-year average, production and refinery runs (EIA) |
GET /api/v1/calendar?days=14&importance=high | $0.005 | When not to trade: the next CPI, jobs report, PCE, GDP, FOMC and ECB decisions in UTC with importance, from the official calendars; decisions also flag high-impact events within 24 hours |
News
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/news | $0.005 | Market headlines and SEC 8-K events, classified by event type, direction and materiality |
GET /api/v1/news/symbol?symbol=NVDA | $0.003 | Headlines and filings for one ticker |
GET /api/v1/news/policy?topic=tariffs | $0.01 | US policy news that moves markets: tariffs, the Fed, sanctions, crypto policy and every new executive order, with exposed sectors and symbols |
History and research
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/datasets/ETHUSD?date=2026-09-23&format=csv | $0.02 | One UTC day of candles with buy/sell volume split per venue, JSON or CSV, for backtests |
GET /api/v1/intelligence/query?symbols=BTCUSD,ETHUSD&from=...&to=... | $0.05 | Several signals for several symbols over a historical range |
GET /api/v1/intelligence/backtest | $0.05 | Walk-forward backtest of the signals |
GET /api/v1/intelligence/track-record?days=30 | $0.01 | Detailed hit rate and calibration of every signal (the summary is free) |
Analytics primitives
| Call | USD | Use it for |
|---|---|---|
POST /api/v1/analytics/weighted-mean | $0.01 | Average your own values by importance: sum(value*weight)/sum(weight), exact decimal math; numbers you supply, nothing fetched |
POST /api/v1/analytics/weighted-median | $0.01 | Outlier-resistant weighted central value with a documented, deterministic definition; numbers you supply, nothing fetched |
POST /api/v1/analytics/weighted-score | $0.01 | Combine factor scores (momentum, fundamentals, risk...) into one 0-100 composite with each factor's contribution; numbers you supply, nothing fetched |
POST /api/v1/analytics/zscore | $0.01 | How unusual is a value versus its history: mean, standard deviation (sample or population) and z; numbers you supply, nothing fetched |
POST /api/v1/analytics/percentile | $0.01 | Rank a value against a dataset: 0-100 percentile rank with counts below, equal and above; numbers you supply, nothing fetched |
POST /api/v1/analytics/correlation | $0.01 | Do two series move together: Pearson or Spearman r, r-squared and direction; numbers you supply, nothing fetched |
POST /api/v1/analytics/anomaly-score | $0.01 | Flag outliers: 0-100 anomaly score, z-score, severity NORMAL..EXTREME and direction; numbers you supply, nothing fetched |
POST /api/v1/analytics/confidence | $0.01 | Turn evidence quality (sample size, freshness, agreement...) into one auditable 0-100 confidence; numbers you supply, nothing fetched |
Decision support
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/decision/lite/ETHUSD?side=buy | $0.05 | Quick yes/no before a trade: action (STRONG_BUY..STRONG_SELL), conviction, GO / GO_SMALL / WAIT / NO_GO for your side and the stance of each of 8 pillars; a rule-based aggregation of the data, its live hit rate is free at /api/v1/decision/track-record |
GET /api/v1/decision?symbol=ETHUSD&side=buy | $1.00 | Every dataset combined into one action with conviction, the evidence per pillar, a volatility-sized trade plan (stop, targets, position size) and what would change the view; no symbol = market-wide stance. Check the free track record before relying on it |
POST /api/v1/decision/batch | $3.00 | Choosing between assets: full decisions for up to 5 symbols in parallel, ranked from most bullish to most bearish |
GET /api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy | $0.005 | Timing check right before an order: FAVORABLE / CAUTION / UNFAVORABLE with the checks behind it and on-chain slippage |
GET /api/v1/intelligence/opportunities?objective=unusual_buying&window=15m | $0.03 | Finding trades: name a goal (unusual buying, breakout, crowded positioning, smart-money accumulation...) and get ranked symbols with evidence for and against, risks and the live hit rate |
POST /api/v1/intelligence/opportunities | $0.03 | The same scan with constraints in a JSON body (symbols, minimum liquidity, confidence, windows) |
GET /api/v1/report/NVDA | $0.03 | Everything about one symbol in one call: snapshot, pre-trade verdict, technicals, positioning, smart money, news and SEC data |
POST /api/v1/portfolio/check | $0.25 | Is my portfolio sane? Up to 15 positions and 5 tokens: concentration, correlations, volatility and a one-day 95% VaR from hourly on-chain data, the decision for each symbol, token risk, macro events in the next 24h and flags with what to fix |
Watch without polling
| Call | USD | Use it for |
|---|---|---|
POST /api/v1/alerts/subscriptions | $0.50 | Stop polling: a 7-day pack of up to 200 HMAC-signed pushes to your HTTPS webhook when a decision flips, flow turns unusual, perp funding goes extreme, a stablecoin leaves its peg, material news lands or a watched token's risk changes; missed events can be fetched later |
MCP
| Call | USD | Use it for |
|---|---|---|
POST /mcp | $0.01 | MCP server with 82 tools: initialize, tools/list and 6 tools (samples, feedback, alert management) are free; each paid tool costs the same as its route |
POST /api/v1/credits/buy/20 | $20.0 | No wallet per call? Buy prepaid credit once ($5, $20 = $22, $50 = $60) and use the API key in any MCP client |
More routes
| Call | USD | Use it for |
|---|---|---|
GET /api/v1/markets/prediction-markets/movers | $0.005 | Prediction market movers |
GET /api/v1/rates/treasury-yield-curve | $0.01 | Treasury yield curve: US Treasury yields from 1 month to 30 |
GET /api/v1/markets/prediction-markets | $0.005 | Prediction markets and odds, live from Hyperliquid |
GET /api/v1/markets/stablecoin-peg | $0.005 | Stablecoin peg and depeg monitor |
GET /api/v1/rates/fed-rate-odds | $0.005 | Fed rate odds: FOMC rate cut, hold or hike probability for the |
GET /api/v1/markets/defi-yields | $0.002 | DeFi yields now: best supply and borrow APY of every Aave v3 |
GET /api/v1/markets/usdc-yield | $0.002 | USDC yield, best lending rates now |
GET /api/v1/markets/gas-price | $0.001 | Gas price now on every EVM chain |
GET /api/v1/news/crypto-news | $0.005 | Crypto news, latest headlines |
GET /api/v1/sec/filings | $0.005 | SEC filings, latest 8-K material events |
POST /mcp/core | $0.01 | Use when the MCP client should load few tools |
GET /api/v1/intelligence/whale-activity/{address} | $0.01 | Whale activity in a token |
GET /api/v1/intelligence/honeypot-check/{address} | $0.02 | Honeypot check for any token |
GET /api/v1/intelligence/wallet-profile/{address} | $0.01 | Wallet profile of any crypto trader |
GET /api/v1/intelligence/order-flow/{symbol} | $0.005 | Order flow of a crypto or tokenized stock |
GET /api/v1/intelligence/rug-check/{address} | $0.01 | Rug check for any token: is this token a rug pull or scam? |
GET /api/v1/sec/insider-trades/{symbol} | $0.005 | Insider trades of a US stock from SEC Form 4 |
How to call
The first request returns HTTP 402 with the payment requirements in the payment-required header. An x402 client pays the quoted amount and repeats the request with the payment header.
curl -i "https://api.marketintelligenceapi.com/api/v1/intelligence/ETHUSD?window=5m"
# HTTP 402, payment-required: base64 JSON with accepts[] (USDC and EURC on several networks)
Prefer an API key? Monthly plans from $0 (1,000 units) to $149 (500,000 units), paid by card: see the plans or start with a free key.
For agents and tools
- /openapi.json: OpenAPI 3.1 with x402 payment info per operation
- /.well-known/x402 and /.well-known/x402-resources: x402 discovery
- /llms.txt and /llms-full.txt: guides for language models
https://api.marketintelligenceapi.com/mcp: MCP server (streamable HTTP, JSON-RPC)- /.well-known/security.txt: security contact
Data
- On-chain trades: executed swaps from public DEX pools (Uniswap v2/v3/v4, Aerodrome) on Base, Ethereum, Arbitrum, Optimism, Polygon and Robinhood Chain, with the exact aggressor side; tokenized US stocks on Solana DEX pools (Raydium, Orca, Meteora) as a separate venue (
solana_dex). - Derivatives: Hyperliquid perps (funding, open interest), GMX v2 and gTrade; CFTC Commitments of Traders.
- Filings: SEC EDGAR (XBRL, Form 4, Form 144, 13D/13G, 8-K, fails-to-deliver) and ESEF annual reports; AMF short positions.
- Rates and macro: US Treasury, Federal Reserve, ECB and Eurostat releases, EIA oil inventories, official release calendars.
- News: GDELT headline metadata (cited), SEC 8-K events and Federal Register presidential documents.
Signals and decisions are informational, derived from observed data; not investment advice. Their measured hit rates are published and can be below 50%. Tokenized-stock prices are on-chain trade prices, not official exchange quotes.