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


## Full endpoint reference (generated from /openapi.json)

### GET /api/v1/news ($0.003 USDC per call, x402)
Crypto and US stock market news
Recent publisher-attributed market news for crypto and US stocks. Search current market headlines by category, ticker, company or keyword. Results include source attribution, article URL, publication time, extracted symbols and lightweight headline sentiment.
- category (query) one of ["crypto","stocks"]: Optional market category.
- query (query): Optional keyword, company name or ticker search.
- limit (query), default 20: Maximum news items to return.

### GET /api/v1/news/symbol ($0.003 USDC per call, x402)
Ticker-specific crypto and stock news
Recent publisher-attributed market-news headlines for one crypto or US stock ticker. Use this endpoint for company news, stock news, crypto asset news, symbol-specific headlines and news sentiment.
- symbol (query, required): Ticker or crypto symbol, for example NVDA, BTC or ETH.
- limit (query), default 20: Maximum news items to return.

### GET /api/v1/intelligence ($0.01 USDC per call, x402)
Market signals, trade flow and signal strength
Real-time market signals, trade flow and signal strength for crypto and US stocks. Use this endpoint for market signals, market intelligence, trade flow, buying pressure, selling pressure, signal strength, momentum, trading activity, acceleration, anomalies, and complete market snapshots.
- window (query), default 5m
- limit (query), default 20

### GET /api/v1/intelligence/{symbol} ($0.005 USDC per call, x402)
Symbol market intelligence
Real-time market intelligence for a specific crypto or US stock symbol. Analyze price movement, momentum, buying pressure, selling pressure, trade flow, trading activity, signal strength, and unusual market activity. Also returns on-chain liquidity (cost of a $1k/$10k/$50k market order, liquidity score), sources[] and as_of.
- symbol (path, required)
- window (query), default 5m

### GET /api/v1/intelligence/summary ($0.01 USDC per call, x402)
Market summary
Aggregated real-time market summary for crypto and US stocks. Get market breadth, regime, average buying pressure, price change, top momentum, top activity, top buying, top selling, market events, and data freshness.
- window (query), default 5m

### GET /api/v1/intelligence/top-momentum ($0.005 USDC per call, x402)
Market momentum
Real-time short-term momentum rankings for crypto and US stocks. Find momentum leaders, strongest price momentum, fastest-moving assets, accelerating symbols, and high-momentum signals.
- window (query), default 5m
- limit (query), default 10

### GET /api/v1/intelligence/top-activity ($0.005 USDC per call, x402)
Market activity
Real-time trading activity rankings for crypto and US stocks. Find the most actively traded assets, highest trade counts, trading volume, activity multiples, and significant trading activity.
- window (query), default 5m
- limit (query), default 10

### GET /api/v1/intelligence/unusual ($0.01 USDC per call, x402)
Unusual trading activity
Detect unusual and abnormal trading activity across crypto and US stocks. Find volume spikes, activity anomalies, unusual price movement, abnormal buying or selling pressure, trade anomalies, and statistically unusual market behavior.
- window (query), default 5m
- limit (query), default 10
- minAnomaly (query), default 70
- minTrades (query), default 3

### GET /api/v1/intelligence/events ($0.01 USDC per call, x402)
Market events
Real-time market events for crypto and US stocks. Find significant price moves, momentum changes, unusual activity, buying or selling events, trade-flow changes, and emerging market signals.
- window (query), default 5m
- limit (query), default 10

### GET /api/v1/intelligence/buying ($0.005 USDC per call, x402)
Buying pressure
Real-time buy-side trade flow rankings for crypto and US stocks. Find assets with the strongest buying pressure, aggressive buying, buyer dominance, positive buy-side imbalance, and bullish buying signals.
- window (query), default 5m
- limit (query), default 10
- minBuyPressure (query), default 60

### GET /api/v1/intelligence/selling ($0.005 USDC per call, x402)
Selling pressure
Real-time sell-side trade flow rankings for crypto and US stocks. Find assets with the strongest selling pressure, aggressive selling, seller dominance, negative buy-side imbalance, and bearish selling signals.
- window (query), default 5m
- limit (query), default 10
- maxBuyPressure (query), default 40

### GET /api/v1/intelligence/compare ($0.01 USDC per call, x402)
Compare market signals
Compare selected crypto and US stocks using momentum, price movement, buying pressure, selling pressure, trade flow, trading activity, anomalies, and signal strength.
- symbols (query, required)
- window (query), default 5m

### GET /api/v1/intelligence/regime ($0.005 USDC per call, x402)
Market regime
Current market regime across crypto and US stocks. Identify bullish, bearish, or mixed market conditions using market breadth, momentum, buying pressure, selling pressure, trading activity, trade flow, and market signals.
- window (query), default 5m

### GET /api/v1/intelligence/backtest ($0.05 USDC per call, x402)
Signal backtesting
Backtest and validate market intelligence signals using historical crypto and US stock data. Evaluate signal performance, forward returns, win rate, confidence, signal strength, maximum favorable excursion, maximum adverse excursion, and baseline performance.
- window (query) one of ["1m","5m","15m"], default 5m: Analysis window.
- minConfidence (query), default 60: Minimum signal confidence from 0 to 100.
- minBaselineSamples (query), default 10: Minimum historical baseline samples; service enforces a minimum of 2.
- start (query): ISO-8601 backtest start timestamp. Defaults to 24 hours before end.
- end (query): ISO-8601 backtest end timestamp. Defaults to now.
- symbols (query): Comma-separated crypto or US equity symbols. Empty means all available symbols.
- persist (query), default false: Whether to persist the backtest result.

### POST /mcp (free)
MCP market intelligence
MCP market intelligence tools for AI agents. Access aggregated market intelligence, symbol intelligence, momentum, activity, buying pressure, selling pressure, trade flow, signal strength, unusual activity, market regime, market events, SEC stock fundamentals, and signal backtesting through MCP JSON-RPC. initialize and tools/list are free; each tools/call is priced like the matching HTTP route ($0.003-$0.05), shown in the 402 response.

### GET /api/v1/fundamentals/{symbol} ($0.005 USDC per call, x402)
SEC fundamentals financial statements
SEC fundamentals, stock fundamentals and financial statements for US equities. Get company financials from SEC EDGAR including income statement, balance sheet, cash flow, revenue, net income, EPS, assets, liabilities, equity, revenue growth, earnings growth, profit margins, return on assets, debt-to-equity, cash-to-debt, SEC filings, 10-K, 10-Q, XBRL data and deterministic fundamental signals.
- symbol (path, required): US equity ticker, e.g. AAPL, MSFT, NVDA.

### GET /api/v1/intelligence/pre-trade ($0.005 USDC per call, x402)
Pre-trade check: is now a good moment to buy or sell?
Use right before placing a trade: "I want to buy (or sell) SYMBOL - is now a good moment?". Returns a verdict (FAVORABLE, CAUTION, UNFAVORABLE) with a 0-100 score and the checks behind it: order flow, momentum, volatility, adverse market events, market regime, and news or material SEC filings from the last 24h. Works for crypto (ETHUSD, BTCUSD, ...) and tokenized US equities (NVDA, TSLA, SPY, ...), 24/7. Includes on-chain slippage of a $1k/$10k/$50k order and a liquidity score.
- symbol (query, required): Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA.
- side (query) one of ["buy","sell"], default buy: Intended trade direction.
- window (query), default 5m: Signal window (1m, 5m, 15m, 1h, 4h, 24h).

### GET /api/v1/intelligence/equities ($0.005 USDC per call, x402)
24/7 US equity sentiment from tokenized stocks
Use to read US stock sentiment around the clock, including nights and weekends when exchanges are closed. Returns 24/7 trade flow of tokenized US equities and ETFs (NVDA, AAPL, TSLA, SPY, ...) traded on public blockchains, labelled with the current US market session, with breadth, average buy pressure and per-asset signals. Prices are on-chain trade prices, not official exchange quotes.
- window (query), default 5m
- limit (query), default 20

### GET /api/v1/intelligence/token/{address} ($0.01 USDC per call, x402)
Live DEX trade flow and verdict for any ERC-20 token
Send any token contract address (Base by default; chain=arbitrum or optimism), get its live DEX trade flow for the last hour: swaps, buy and sell volume in USD, buy pressure, price change, largest trade, trader concentration and a verdict (ACCUMULATION, DISTRIBUTION, BALANCED, ILLIQUID_OR_INACTIVE, NO_POOL). Read live from the chain; repeat requests within 45 s share one read (see timestamp).
- address (path, required): ERC-20 contract address.
- chain (query) one of ["base","arbitrum","optimism"], default base

### GET /api/v1/intelligence/candles/{symbol} ($0.005 USDC per call, x402)
OHLCV candles with buy/sell volume split
Send a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...), get OHLCV candles (1m, 5m, 15m or 1h) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count per candle, from on-chain trade flow. A free 15-minute delayed sample is at /api/v1/preview.
- symbol (path, required)
- interval (query) one of ["1m","5m","15m","1h"], default 1m
- limit (query), default 60

### GET /api/v1/preview (free)
Free delayed sample (no payment)
Free, 15-minute delayed, truncated sample of the paid candle data (last 6 closed 5m candles: close, volumeUsd, buyPressure) for a few symbols, so an agent can check data quality before paying. Links to the matching paid endpoints are included.
- symbol (query) one of ["ETHUSD","BTCUSD","TSLA"], default ETHUSD

### GET /status (free)
Data freshness (free)
Free freshness report: per-chain ingestion state (last successful poll, last ingested block, last trade, error counts), time of the latest trade, and per-source fetch state for news and filings. Use it to verify the data is live before paying.

### GET /transparency (free)
Operator, data source and billing disclosure (free)
Who runs the service, where the data comes from, current prices per route, and the billing policy (settled only after a successful 2xx answer).

### GET /.well-known/x402-resources (free)
Paid resource list (free)
Paid resources in the x402scan manifest form. Also served at /x402-resources.

### GET /.well-known/security.txt (free)
RFC 9116 security contact (free)

### GET /api/v1/intelligence/query ($0.05 USDC per call, x402)
Several signals for several symbols over a historical range
Use when an agent needs several signals for several symbols over a historical time range in one paid call. Returns momentum, activity, buying, selling, anomaly and regime per symbol for any from/to range; the data resolution (1m, 5m, 15m or 1h) is chosen automatically.
- symbols (query, required): Comma-separated symbols, up to 20.
- from (query, required): ISO-8601 UTC start.
- to (query, required): ISO-8601 UTC end, after from.
- signals (query): Subset of signals; all when omitted.

### GET /api/v1/intelligence/token-risk/{address} ($0.02 USDC per call, x402)
Token due diligence: honeypot, admin functions, liquidity, LP burn, tax
Use before buying any ERC-20 (Base by default; chain=arbitrum or optimism). Simulates a sell by a real recent buyer and a buy from the main pool with eth_call (honeypot check), reads the owner and EIP-1967 proxy, scans the bytecode for mint, blacklist, pause, fee, limit and trading-switch functions, measures liquidity in Uniswap v2/v3 and Aerodrome pools, the share of burned LP tokens and the buy tax observed in recent buys, adds the last hour of trade flow, and returns a verdict (LOW_RISK, CAUTION, HIGH_RISK) with a 0-100 safety score and every check (PASS, WARN, FAIL, UNKNOWN, INFO). Automated checks, not an audit. Cached 120 s.
- address (path, required): ERC-20 contract address.
- chain (query) one of ["base","arbitrum","optimism"], default base

### GET /api/v1/intelligence/premium ($0.01 USDC per call, x402)
Tokenized stock price gap between Robinhood Chain/EVM pools and Solana xStocks
Latest premium in basis points of the same tokenized US stock between the main on-chain pools (Robinhood Chain and EVM DEX) and Solana xStocks pools (Raydium, Orca, Meteora): volume-weighted prices of the last 15-minute bin with trades on both venues within the hour, both 1-hour volumes and the US market session. Sorted by absolute premium. Neither venue is a licensed NYSE/NASDAQ price.
- symbols (query): Comma-separated tickers, e.g. NVDA,TSLA; all paired stocks when omitted.

### GET /api/v1/intelligence/premium/{symbol} ($0.01 USDC per call, x402)
Premium history of one tokenized stock with statistics per US market session
Premium history of one tokenized US stock between Robinhood Chain/EVM pools and Solana xStocks pools: one point per 15m or 1h bin with trades on both venues, plus average, median, min, max and statistics per US market session (WEEKEND, OVERNIGHT, PRE_MARKET, REGULAR, AFTER_HOURS).
- symbol (path, required): Tokenized stock ticker, e.g. NVDA.
- hours (query), default 24
- interval (query) one of ["15m","1h"], default 15m

### GET /api/v1/datasets (free)
Free catalog of the trade-flow datasets
Which symbols, venues, dates and resolutions can be bought as datasets. Free.

### GET /api/v1/datasets/{symbol} ($0.02 USDC per call, x402)
One UTC day of trade-flow candles per venue, JSON or CSV
One UTC day of candles for a symbol, separately per venue (onchain_dex: Uniswap and Aerodrome pools on Base, Ethereum, Arbitrum, Optimism, Polygon and Robinhood Chain; solana_dex: tokenized stocks on Solana): OHLCV, aggressor buy and sell volume, buy pressure, VWAP and trade count. 1-minute data is kept 7 days, then 5m (30 days), 15m (180 days) and 1h; a finer interval than stored returns the stored resolution. format=csv returns a CSV file.
- symbol (path, required): Covered symbol, e.g. ETHUSD, BTCUSD, NVDA.
- date (query): UTC day (YYYY-MM-DD); yesterday when omitted.
- interval (query) one of ["1m","5m","15m","1h"], default 1m
- format (query) one of ["json","csv"], default json

### GET /api/v1/insiders/{symbol} ($0.01 USDC per call, x402)
Insider buying and selling from SEC Form 4
Insider transactions of a US-listed company from SEC Form 4 filings of the last days (1-365, the latest 40 filings are analyzed): open-market purchases and sales with value in USD, sales under 10b5-1 plans, grants, option exercises and tax withholding, per-insider totals, the latest 50 transactions with filing links, and a signal (CLUSTER_BUYING, NET_BUYING, PLANNED_SELLING, NET_SELLING, NO_OPEN_MARKET_ACTIVITY).
- symbol (path, required): US equity ticker, e.g. TSLA.
- days (query), default 90

### GET /track-record (free)
Free live track record of the signals
Hit rate (price moved in the signal's direction) of the 5m signals after 5m, 15m, 1h and 24h over the last 7, 30 and 90 days, calibration by confidence bucket, and an interim walk-forward backtest since the start of on-chain data (labelled as a backtest, not a live record). Free.

### GET /api/v1/intelligence/track-record ($0.005 USDC per call, x402)
Live signal track record: hit rate and calibration
Every published signal change is logged with its price, confidence and algorithm version; forward returns after 5m, 15m, 1h and 24h are filled as time passes. Returns hit rate and average return in the signal direction per horizon, per signal type and per confidence bucket, for any window, symbol and period, plus the latest signals with outcomes. Not charged (404) while nothing is logged for the query.
- days (query), default 30
- window (query) one of ["1m","5m","15m"], default 5m
- symbol (query): Optional symbol, e.g. ETHUSD.

### GET /coverage (free)
Free map of data sources per symbol
Which sources exist per symbol (spot DEX flow on-chain and on Solana, perpetual futures venues), so an agent knows what a paid call returns. Paid endpoints answer 404 (not charged) when a symbol has no data for them. Free.

### GET /api/v1/intelligence/positioning/{symbol} ($0.01 USDC per call, x402)
Perpetual futures positioning next to the spot flow
For a tokenized stock, ETF or commodity (TSLA, NVDA, SPY, QQQ, AMZN, NFLX, HOOD, gold XAUUSD, silver XAGUSD, oil WTIUSD and BRENTUSD, NATGASUSD, ...): open interest long and short per perp venue (GMX v2 synthetic markets, gTrade on Arbitrum and Base) read on chain every 5 minutes, funding (GMX: annualized, positive = longs pay; gTrade: the larger side pays), 1h and 24h change of total open interest and a positioning flag (CROWDED_LONG / CROWDED_SHORT at a 65% long or short share, THIN below $50k), next to the latest spot DEX flow when the symbol trades spot. Symbols covered by perps only get a partial answer with a coverage note; 404 (not charged) when neither exists.
- symbol (path, required): e.g. TSLA, SPY, XAUUSD, WTIUSD.

### GET /api/v1/intelligence/smart-money/{symbol} ($0.02 USDC per call, x402)
Most profitable DEX wallets of a symbol and their net flow
Wallets (public addresses only) trading a symbol in the DEX pools we ingest, ranked by realized plus unrealized PnL (average cost on what was bought while tracked, marked at the latest pool price), with win rate, average holding time, open position, and the net flow of the top-decile wallets vs all wallets over the last two UTC days. Wallet = recipient of organic swaps; arbitrage, MEV, two-sided bots and router-bound swaps are excluded; trades under $50 ignored. A reliable ranking needs 2-4 weeks of history. 404 (not charged) when no wallet trade is recorded for the symbol.
- symbol (path, required): e.g. ETHUSD, BTCUSD, NVDA.

### GET /api/v1/rates/curve ($0.005 USDC per call, x402)
Treasury yield curve, slopes, SOFR and euro STR
US Treasury daily par yield curve (1M-30Y) and real TIPS curve with the change vs the previous business day, 2s10s, 3m10y, 5s30s and 3m2y slopes with inversion flags, 10y breakeven inflation, and overnight rates: SOFR and EFFR (New York Fed; the response carries the notice its Terms of Use require) and euro STR (ECB). Sources: home.treasury.gov (public domain), markets.newyorkfed.org, ECB Data Portal.

### GET /api/v1/rates/defi-spread ($0.005 USDC per call, x402)
Aave USDC rates vs the 3-month T-bill
USDC supply and variable borrow APR on Aave v3 (Ethereum, Base, Arbitrum, Optimism, Polygon) read on chain, each against the 3-month Treasury bill, with the average spread and a signal (DEFI_PREMIUM, IN_LINE, TREASURY_PREMIUM at +-50 bp).

### GET /api/v1/rates/tokenized-treasuries ($0.01 USDC per call, x402)
On-chain treasury fund supply and net issuance
totalSupply of BlackRock BUIDL, Ondo USDY and OUSG, Superstate USTB and Hashnote USYC on Ethereum, snapshotted hourly on chain, with 24h and 7d change and an aggregate gauge (RISK_OFF_INFLOW / NEUTRAL / RISK_ON_OUTFLOW at +-0.5% per day). Token units; NAV per token differs by fund. 404 (not charged) before the first snapshot.

### GET /api/v1/rates/auctions ($0.005 USDC per call, x402)
Upcoming and recent Treasury auctions
US Treasury auctions of the last days (1-60) and those announced: security, term, offering amount, high yield or discount rate, bid-to-cover, indirect and primary-dealer shares, and the previous auction of the same security for comparison. Source: fiscaldata.treasury.gov (public domain).
- days (query), default 14

### GET /api/v1/intelligence/opportunities ($0.03 USDC per call, x402)
Goal-driven opportunity scan
Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.
- objective (query, required) one of ["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]: What to look for
- universe (query): Comma-separated symbols (max 100); omit for all covered symbols
- assetClass (query) one of ["crypto","us_equity","perp_only"]
- window (query) one of ["1m","5m","15m"], default 5m
- minBuyPressure (query), default 60: Pressure on the objective's side (sell pressure for selling objectives)
- minVolumeMultiple (query), default 1.5: Volume vs the symbol's own baseline
- minVolumeUsd (query), default 0: USD traded in the window
- minConfidence (query), default 50
- minIndependentSources (query), default 1: Distinct sources confirming the direction
- include (query): Comma-separated: metrics, evidence, risk_factors, data_quality, track_record, market_context (default all)
- maxResults (query), default 10

### POST /api/v1/intelligence/opportunities ($0.03 USDC per call, x402)
Goal-driven opportunity scan (JSON body)
Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.
JSON body example: {"objective":"unusual_buying","universe":["BTCUSD","ETHUSD","NVDA"],"constraints":{"window":"15m","minBuyPressure":65,"minVolumeUsd":100000,"minIndependentSources":2},"include":["metrics","evidence","risk_factors","data_quality","track_record","market_context"],"maxResults":10}

### GET /api/v1/agent/opportunities ($0.03 USDC per call, x402)
Goal-driven opportunity scan
Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.
- objective (query, required) one of ["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"]: What to look for
- universe (query): Comma-separated symbols (max 100); omit for all covered symbols
- assetClass (query) one of ["crypto","us_equity","perp_only"]
- window (query) one of ["1m","5m","15m"], default 5m
- minBuyPressure (query), default 60: Pressure on the objective's side (sell pressure for selling objectives)
- minVolumeMultiple (query), default 1.5: Volume vs the symbol's own baseline
- minVolumeUsd (query), default 0: USD traded in the window
- minConfidence (query), default 50
- minIndependentSources (query), default 1: Distinct sources confirming the direction
- include (query): Comma-separated: metrics, evidence, risk_factors, data_quality, track_record, market_context (default all)
- maxResults (query), default 10

### POST /api/v1/agent/opportunities ($0.03 USDC per call, x402)
Goal-driven opportunity scan (JSON body)
Goal-driven opportunity scan for agents. Name an objective and constraints; get ranked symbols with supporting and conflicting evidence grouped by independent source (spot_dex_flow, perp_positioning, smart_money), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Deterministic, no model in the loop. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning (direction against the crowd), smart_money_accumulation, smart_money_distribution. An empty result list is a valid answer when data is fresh (filteredOut says why); 404 (not charged) only without fresh data; 400 (not charged) lists accepted values.
JSON body example: {"objective":"unusual_buying","universe":["BTCUSD","ETHUSD","NVDA"],"constraints":{"window":"15m","minBuyPressure":65,"minVolumeUsd":100000,"minIndependentSources":2},"include":["metrics","evidence","risk_factors","data_quality","track_record","market_context"],"maxResults":10}