Market Intelligence API

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.

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.

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.

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.

FREE: how the decision engine has done: hit rate and average move after its BUY and SELL calls by horizon (1h, 4h, 24h) over the last days, optionally for one symbol. Judge it before paying for get_decision.

FREE: the dataset catalog: which symbols, dates and candle resolutions can be bought with get_dataset (one UTC day of candles with the buy/sell split per venue, JSON or CSV).

Takes no parameters.

FREE: the prepaid credit of the API key sent in X-API-Key (balance, spent, calls), and the credit packs on sale. Without a key: the packs only.

Takes no parameters.

FREE: status of a USDC gift link by its key address (OPEN with amount, fee and expiry; EXPIRED; CLOSED; NOT_FOUND), or without a key the gift contract, chain, fee and limits.

FREE: is the service healthy right now: freshness of every data source, live symbols and the last updates, as on /status.

Takes no parameters.

FREE: who runs this service, data sources and their licences, what is stored, payment terms and contacts, as on /transparency.

Takes no parameters.

FREE: send USDC by link, step 1 of 2. Returns a gift link and the EIP-712 USDC authorization (typedData) for your wallet to sign; the same kind of signature as an x402 payment, no gas. The recipient opens the link and claims to any wallet or exchange address. Fee 1% on top, kept only when claimed; an unclaimed gift goes back to the sender. Then call fund_gift_link.

FREE: send USDC by link, step 2 of 2. Pass the giftKey from prepare_gift_link and your wallet's signature of its typedData; our relayer submits it (gas paid by us) and the money moves from your wallet into the gift contract. The link works once mined.

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.

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.

Takes no parameters.

FREE: which data sources cover each symbol (spot on-chain DEX flow, perp venues), so you know what a paid call will return.

Takes no parameters.

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.

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.

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.

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.

Use when the user asks "is this token safe?", "is it a rug or a honeypot?", "check this CA" or "can I sell it?". 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, the top three risks, a oneLiner to quote and a share card. 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.

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.

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.

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

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.

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.

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.

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.

Takes no parameters.

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

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.

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.

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.

Takes no parameters.

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.

Takes no parameters.

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.

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.

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.

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.

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.

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

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.

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.

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.

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

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.

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.

Takes no parameters.

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

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

SEC Form 144 notices of proposed insider sales of a US-listed company: planned sale value, sellers and their relationship, approximate sale dates.

SEC Schedule 13D (activist) and 13G (passive) filings of holders above 5% of a US-listed company, with holder names and percent of class.

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

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.

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.

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.

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.

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

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.

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

Takes no parameters.

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.

Takes no parameters.

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

Takes no parameters.

Most shorted stocks supervised by the French AMF (mostly Euronext Paris): disclosed net short interest, 30-day change, number of funds short.

Disclosed net short positions of one European issuer (ISIN or name): funds short, percent of capital, weekly history and a signal.

IFRS fundamentals of a European listed company from its ESEF annual report: revenue, profit, cash flow, balance sheet, growth, margins, ROE and a score.

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.

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.

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.

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

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

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

Takes no parameters.

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.

Takes no parameters.

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.

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.

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.

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-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 the latest trade-derived intelligence for one symbol. Use for the raw signals of one symbol; get_snapshot is cheaper for headline numbers.

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

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

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.

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 statistically unusual trade activity using anomaly score and a minimum trade count. Ranks by anomaly score; for plain volume use get_top_activity.

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

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

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

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 SEC EDGAR-derived fundamental intelligence for a US equity, including growth, margins, balance-sheet ratios, latest filing context and a deterministic fundamental signal. For a crypto pair (BTCUSD): perp price, volume, open interest, funding and CME positioning. For several tickers at once use get_fundamentals_batch.

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.

FREE: manage an alert subscription bought with subscribe_alerts. action=status (state, deliveries left, expiry), events (the last 14 days with payloads, since= to catch up), test (send a test delivery), resume (re-activate a suspended one, optionally at a new url) or cancel (no refund).

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.

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.