{"uid":"cap_eGyCAxQywSbMioCQuvwYg","slug":"api-quantoracle-dev-a781a685","name":"QuantOracle Trade Evaluate","description":"QuantOracle: /v1/trade/evaluate","url":"https://api.quantoracle.dev/v1/trade/evaluate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","title":"TradeEvaluateIn","required":["entry_price","stop_loss","take_profit","account_size","prices"],"properties":{"adv":{"type":"number","title":"Adv","default":5000000,"description":"Average daily volume in USD"},"prices":{"type":"array","items":{"type":"number"},"title":"Prices","minItems":14,"description":"Recent price history for signals"},"returns":{"anyOf":[{"type":"array","items":{"type":"number"}},{"type":"null"}],"title":"Returns","description":"Historical returns for Kelly (optional)"},"stop_loss":{"type":"number","title":"Stop Loss","description":"Stop loss price","exclusiveMinimum":0},"spread_bps":{"type":"number","title":"Spread Bps","default":5,"description":"Bid-ask spread in basis points"},"entry_price":{"type":"number","title":"Entry Price","description":"Planned entry price","exclusiveMinimum":0},"take_profit":{"type":"number","title":"Take Profit","description":"Take profit price","exclusiveMinimum":0},"account_size":{"type":"number","title":"Account Size","description":"Total account value","exclusiveMinimum":0},"risk_per_trade":{"type":"number","title":"Risk Per Trade","default":0.02,"description":"Max risk per trade as fraction"},"commission_per_share":{"type":"number","title":"Commission Per Share","default":0.005,"description":"Commission per share"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"spot":175,"prices":[168,169,170,171,172,173,174,175,176,177,178,179,180,181],"stop_loss":170,"entry_price":175,"market_data":[{"strike":170,"expiry_days":7,"implied_vol":0.18},{"strike":172,"expiry_days":7,"implied_vol":0.19},{"strike":174,"expiry_days":7,"implied_vol":0.2},{"strike":175,"expiry_days":7,"implied_vol":0.21},{"strike":176,"expiry_days":7,"implied_vol":0.2},{"strike":178,"expiry_days":7,"implied_vol":0.19},{"strike":180,"expiry_days":7,"implied_vol":0.18},{"strike":170,"expiry_days":30,"implied_vol":0.17},{"strike":172,"expiry_days":30,"implied_vol":0.18},{"strike":174,"expiry_days":30,"implied_vol":0.19},{"strike":175,"expiry_days":30,"implied_vol":0.2},{"strike":176,"expiry_days":30,"implied_vol":0.19},{"strike":178,"expiry_days":30,"implied_vol":0.18},{"strike":180,"expiry_days":30,"implied_vol":0.17}],"take_profit":182,"account_size":100000,"interpolation":"linear"},"response":{"ms":19.71,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"costs":{"impact":8.28,"spread":17.5,"commission":2,"round_trip":55.57,"pct_of_position":0.0794},"kelly":null,"regime":{"vol_regime":"NORMAL","realized_vol":0.0019},"signals":{"rsi":99.01,"sma":174.5,"trend":"BULLISH","signals":["RSI_OVERBOUGHT","ABOVE_SMA"],"aligned_with_trade":true},"verdict":"UNFAVORABLE","position":{"value":70000,"shares":400,"max_loss":2000,"max_profit":2800,"pct_account":0.7,"risk_per_share":5},"direction":"LONG","risk_reward":1.4}},"exampleRequest":{"spot":175,"prices":[168,169,170,171,172,173,174,175,176,177,178,179,180,181],"stop_loss":170,"entry_price":175,"market_data":[{"strike":170,"expiry_days":7,"implied_vol":0.18},{"strike":172,"expiry_days":7,"implied_vol":0.19},{"strike":174,"expiry_days":7,"implied_vol":0.2},{"strike":175,"expiry_days":7,"implied_vol":0.21},{"strike":176,"expiry_days":7,"implied_vol":0.2},{"strike":178,"expiry_days":7,"implied_vol":0.19},{"strike":180,"expiry_days":7,"implied_vol":0.18},{"strike":170,"expiry_days":30,"implied_vol":0.17},{"strike":172,"expiry_days":30,"implied_vol":0.18},{"strike":174,"expiry_days":30,"implied_vol":0.19},{"strike":175,"expiry_days":30,"implied_vol":0.2},{"strike":176,"expiry_days":30,"implied_vol":0.19},{"strike":178,"expiry_days":30,"implied_vol":0.18},{"strike":180,"expiry_days":30,"implied_vol":0.17}],"take_profit":182,"account_size":100000,"interpolation":"linear"},"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zKY8NPlns8CDYxsonrPjA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates a trade signal or proposed trade for quantitative merit, risk-adjusted return potential, and execution viability","exampleAgentPrompt":"Can you evaluate this trade for me using QuantOracle — I'm looking at going long AAPL at $195.50 with a position size of 100 shares, targeting $210 with a stop at $188, and I want to know if the signal holds up quantitatively?","exampleUseCases":null,"resultDescription":"Returns a quantitative evaluation of the proposed trade including a signal quality score, risk-adjusted return metrics, and a recommendation on whether the trade setup meets statistical thresholds for execution viability.","failureModes":["Missing required trade parameters (symbol, direction, entry price) returns 400 Bad Request","Invalid asset symbol or unsupported instrument returns 422 Unprocessable Entity","Malformed position sizing or price inputs return validation errors","Insufficient account balance or payment failure returns 402 Payment Required","Service unavailability or timeout returns 503 with retry guidance"],"whenToPreferThis":"Use this endpoint when an agent needs to quantitatively score or validate a specific trade idea before execution, especially when evaluating signal quality, risk-reward ratio, and statistical edge. Prefer this over portfolio/health or risk/full-analysis when the user has a concrete trade in mind and wants a focused go/no-go evaluation rather than a broad portfolio-level assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:29.567Z","isFirstParty":false}