# MarketSignal AI

Real-time market intelligence, publisher-attributed crypto and stock news, trading signals and SEC EDGAR-derived stock fundamentals for AI agents.

Turn raw market activity into structured market intelligence.

## Best use

Use this API when an AI agent needs current market intelligence rather than only raw prices.

Supported intelligence includes:

- market intelligence
- symbol market intelligence
- market summary
- market momentum
- market activity
- buying pressure
- selling pressure
- buy-side trade flow
- sell-side trade flow
- market signals
- signal strength
- unusual trading activity
- market anomalies
- market events
- market regime
- crypto market news
- US stock market news
- ticker-specific market news
- headline sentiment
- SEC stock fundamentals
- historical signal backtesting

## Data source

Trade-derived intelligence is aggregated from trade flow across multiple trading venues for covered symbols.

Fundamental intelligence is derived from SEC EDGAR submissions and standardized XBRL company facts.

News intelligence combines open news metadata and regulatory filing events. Results retain source attribution
and article URLs; this API does not redistribute full article content.

Quote, order-book, options and other data are not advertised unless separately ingested.

## Pricing

Prices are USDC per successful request and are configurable through the
MI_X402_PRICE_* environment variables.

- GET https://api.marketintelligenceapi.com/api/v1/news?category=crypto&limit=20 — crypto and US stock market news, 0.003 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/news/symbol?symbol=NVDA&limit=20 — ticker-specific market news, 0.003 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence?window=5m&limit=20 — market intelligence, 0.01 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/{symbol}?window=5m — symbol market intelligence, 0.005 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/query?symbols=BTCUSD,ETHUSD,SOLUSD&from=2026-09-15T12:00:00Z&to=2026-09-15T13:00:00Z&signals=momentum,activity,buying,selling,anomaly,regime — historical multi-signal query, 0.05 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/summary?window=5m — market summary, 0.01 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/top-momentum?window=5m&limit=10 — market momentum, 0.005 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/top-activity?window=5m&limit=10 — market activity, 0.005 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/unusual?window=5m&limit=10&minAnomaly=70&minTrades=3 — unusual trading activity, 0.01 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/events?window=5m&limit=10 — market events, 0.01 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/buying?window=5m&limit=10&minBuyPressure=60 — buying pressure, 0.005 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/selling?window=5m&limit=10&maxBuyPressure=40 — selling pressure, 0.005 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/compare?symbols=BTCUSD,ETHUSD,SOLUSD&window=5m — compare market signals, 0.01 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/regime?window=5m — market regime, 0.005 USDC/call
- GET or POST /api/v1/intelligence/opportunities?objective=unusual_buying&window=15m — goal-driven opportunity scan (see below)
- GET /api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy — pre-trade verdict: is now a good moment to buy or sell?
- GET /api/v1/intelligence/equities?window=5m — 24/7 tokenized US equity flow with US market session
- GET /api/v1/intelligence/token/{address}?chain=base — live DEX trade flow and verdict for any token address
- GET /api/v1/intelligence/token-risk/{address}?chain=base — token due diligence: sell simulation, admin functions, liquidity, LP burn, tax
- GET /api/v1/intelligence/premium — tokenized stock price gap between Robinhood Chain/EVM pools and Solana; /premium/{symbol}?hours=24 for history
- GET /api/v1/datasets/{symbol}?date=YYYY-MM-DD&format=csv — one day of candles with buy/sell split per venue (catalog free at /api/v1/datasets)
- GET /api/v1/insiders/{symbol}?days=90 — insider trades from SEC Form 4 with a signal
- GET /api/v1/rates/curve — Treasury par and real curve, slopes, inversion flags, SOFR, EFFR, euro STR
- GET /api/v1/rates/defi-spread — Aave v3 USDC rates vs the 3-month T-bill
- GET /api/v1/rates/tokenized-treasuries — BUIDL, USDY, OUSG, USTB, USYC supply and net issuance
- GET /api/v1/rates/auctions?days=14 — Treasury auctions with high yield and bid-to-cover
- GET /api/v1/intelligence/smart-money/{symbol} — most profitable DEX wallets (addresses only), PnL, win rate and the smart-money net flow
- GET /api/v1/intelligence/positioning/{symbol} — perp open interest long/short, funding and a crowding flag (TSLA, SPY, QQQ, XAUUSD, WTIUSD, ...); free symbol coverage map: /coverage
- GET /api/v1/intelligence/track-record?days=30&window=5m — live hit rate and calibration of the signals (free summary: /track-record)
- GET /api/v1/intelligence/candles/{symbol}?interval=5m — OHLCV candles with buy/sell volume split
- GET https://api.marketintelligenceapi.com/api/v1/intelligence/backtest?window=5m&minConfidence=60&minBaselineSamples=10 — signal backtesting, 0.05 USDC/call
- GET https://api.marketintelligenceapi.com/api/v1/fundamentals/{symbol} — SEC stock fundamentals, 0.005 USDC/call
- POST https://api.marketintelligenceapi.com/mcp — MCP market intelligence, 0.01 USDC/call

## Goal-driven opportunity scan (start here)

One call instead of chaining screeners: name what you look for, get ranked symbols
with the evidence for and against, risk factors, data quality, the live hit rate of
the signal and the next calls to make. GET with query parameters or POST JSON to
/api/v1/intelligence/opportunities (alias /api/v1/agent/opportunities), MCP tool
find_opportunities. Invalid requests get a 400 listing the accepted values (not charged).

Objectives:
- unusual_buying: buy pressure >= minBuyPressure and volume >= minVolumeMultiple x baseline
- unusual_selling: the same on the sell side
- breakout / breakdown: momentum >= 65 (<= 35) with the price moving that way, confirmed by an event or volume
- crowded_positioning: perp open interest 65 or more on one side; direction is against the crowd
- smart_money_accumulation / smart_money_distribution: most profitable tracked wallets net buying / selling (2 days)

Constraints (all optional): universe (symbols), assetClass (crypto, us_equity, perp_only),
window (1m, 5m, 15m; default 5m), minBuyPressure (50-100, default 60), minVolumeMultiple
(default 1.5), minVolumeUsd, minConfidence (default 50), minIndependentSources (1-3),
include (metrics, evidence, risk_factors, data_quality, track_record, market_context), maxResults (1-50).

Independent sources are counted by data source, not by metric: spot_dex_flow (buy pressure,
momentum, volume and events all come from the same swaps, so they count once),
perp_positioning and smart_money. Evidence with direction ACTIVITY is unusual volume.

POST example:
{"objective": "unusual_buying", "universe": ["BTCUSD", "ETHUSD", "NVDA"],
 "constraints": {"window": "15m", "minBuyPressure": 65, "minVolumeUsd": 100000, "minIndependentSources": 2},
 "maxResults": 10}

Each result: rank, symbol, direction, score (0-100), confirmingSources, metrics,
supportingEvidence and conflictingEvidence (source, type, direction, observedValue, unit,
detail), riskFactors (type, severity, detail), dataQuality, signalTrackRecord1h and
nextCalls. An empty result list is a valid answer when data is fresh: filteredOut counts why
symbols were excluded. 404 (not charged) only when there is no fresh data at all.

## Historical multi-signal queries

Use GET /api/v1/intelligence/query when an agent needs multiple symbols,
multiple intelligence signals, or a historical time range in one request.

Query parameters:
- symbols: comma-separated symbols, up to 20
- from: ISO-8601 UTC start time
- to: ISO-8601 UTC end time
- signals: optional comma-separated list of momentum, activity, buying, selling, anomaly, regime

Example:
https://api.marketintelligenceapi.com/api/v1/intelligence/query?symbols=BTCUSD,ETHUSD,SOLUSD&from=2026-09-15T12:00:00Z&to=2026-09-15T13:00:00Z&signals=momentum,activity,buying,selling,anomaly,regime

Historical bucket resolution is selected automatically:
- recent data: 1m
- 7-30 days: 5m
- 30-180 days: 15m
- older data: 1h

The response contains a window object, selected resolution, data source and one
result object per symbol. If signals is omitted, all supported signals are returned.

## Supported windows

1m, 5m, 15m

## Payment

HTTP 402 + x402 v2. Supported payment networks: eip155:8453, eip155:137, eip155:42161, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.

## MCP tools

get_market_intelligence,
get_market_summary,
get_symbol_intelligence,
get_top_momentum,
get_top_activity,
find_market_events,
find_unusual_activity,
find_strong_buying,
find_strong_selling,
compare_symbols,
get_market_regime,
pre_trade_check,
get_tokenized_equities,
get_market_news,
get_fundamental_intelligence,
backtest_signals.