{"uid":"cap_ljw5oN43gruHfKPQ2kL3A","slug":"market-intelligence-api-pre-trade-intelligence-a8ac84f2","name":"Market Intelligence API – Pre-Trade Intelligence","description":"Pre-trade check: should I buy or sell this now? Returns a verdict (FAVORABLE, CAUTION, UNFAVORABLE) with a score and its checks - order flow, momentum, volatility, adverse market events, market regime, news or material filings from the last 24h, plus on-chain slippage of a $1k/$10k/$50k order and a liquidity score. Use right before placing a trade.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/pre-trade?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["symbol"],"properties":{"side":{"enum":["buy","sell"],"type":"string","default":"buy","description":"Intended trade direction."},"symbol":{"type":"string","description":"Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA."},"window":{"type":"string","default":"5m","description":"Signal window (1m, 5m, 15m, 1h, 4h, 24h)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"side":"BUY","score":80,"checks":[{"check":"order_flow","detail":"Buy pressure is 61.3% of aggressor volume","status":"PASS"}],"symbol":"ETHUSD","window":"5m","reasons":["Unusual activity (anomaly 74/100): expect wider moves","Market regime is BEARISH"],"verdict":"CAUTION","snapshot":{"price":2668.42,"signal":"BUYING_ACTIVITY","buyPressure":61.3,"momentumScore":64.2},"disclaimer":"Informational market signal derived from observed trade flow; not investment advice."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NFWJuzRQoCjPu8FVS3zEi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a FAVORABLE/CAUTION/UNFAVORABLE verdict with score and detailed checks (order flow, momentum, volatility, market regime, news, on-chain slippage) before placing a trade on a given symbol.","exampleAgentPrompt":"I want to buy ETHUSD right now — can you check if conditions are favorable, including order flow, momentum, volatility, and any recent news, and give me a verdict with a score?","exampleUseCases":[{"title":"Crypto trade timing check","prompt":"I'm about to buy $10k of ETHUSD — run a pre-trade check and tell me if conditions are FAVORABLE or if there's any reason to wait, including order flow and slippage estimates."},{"title":"Stock momentum validation before sell","prompt":"I'm thinking of selling my TSLA position right now — is the momentum and market regime aligned for a SELL, or are there any adverse news or volatility warnings I should know about first?"},{"title":"Liquidity and slippage check before large order","prompt":"Before I place a $50k BUY order on BTCUSD, can you check the on-chain slippage, liquidity score, and current buy pressure so I know what kind of market impact to expect?"}],"resultDescription":"A JSON object containing: a verdict (FAVORABLE, CAUTION, or UNFAVORABLE), a composite score (0-100), a list of named checks (order_flow, momentum, volatility, market regime, news/filings) each with PASS/FAIL status and detail, a price snapshot with buy pressure and momentum score, on-chain slippage estimates for $1k/$10k/$50k order sizes, a liquidity score, and a disclaimer noting the signal is informational only.","failureModes":["Unsupported symbol returns an error or empty result","Missing required symbol or side parameter causes a 400 Bad Request","Payment not provided or insufficient triggers a 402 Payment Required response","Market data temporarily unavailable leads to degraded or partial checks","Extreme low-liquidity conditions may result in unreliable slippage estimates"],"whenToPreferThis":"Use this endpoint immediately before placing a trade when you need a holistic, multi-factor go/no-go signal that combines order flow, momentum, volatility, market regime, news context, and on-chain slippage into a single verdict. It is specifically designed for pre-trade decision support across both crypto and 24/7 tokenized US stocks, making it superior to endpoints that cover only one factor (e.g. news-only or technicals-only).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:46:47.715Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-pre-trade-intelligence-a8ac84f2"}