Pre Trade Check

Ask n0brains First — graded pre-trade CONDITIONS ASSESSMENT for a proposed trade. Body: {asset, side (long/short), entry?, stop?, target?, leverage?, horizon_hours? (default 24)}. Returns grade A..F, flags (crowding, event risk inside horizon, liquidation-distance vs realized vol, stop-vs-noise, proven-edge conflicts, TA extension), supporting factors, and falsifiers to watch. Every check is logged and resolved at its horizon; cross-grade performance stays withheld until the weekly truth gate clears. Free tier: FREE_CHECKS_PER_DAY checks/day; Pro unlimited (within rate limits). Analytical, not advice.

post/check

Request

  • Base URL: https://api.n0brains.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.n0brains.com/check
  • Auth: none declared

Headers

Idempotency-Keystring

Printable, at most 128 characters.

Client-minted, one key per user-initiated submission. The same (user, key) always maps to ONE engine run: a completed key replays its original response verbatim — byte-identical to the first, with no replay marker of any kind, so a retry transparently succeeds and never needs recovering from /checks/history. Replay is served even once the daily quota is exhausted, because the original submission already paid for it. Sameness is judged over asset, side, entry, stop, target, leverage and horizon_hours only. Replay TTL 24h; an in-flight key is held under a 120s lease. Omitting the header is fully supported and behaves exactly as before.

Request body

assetstring required

Asset symbol, e.g. BTC / NVDA / GOLD. maxLength 10 is documentation of the route's own check: overlength is the route's BUSINESS-SEMANTIC typed 400 (never an automatic schema 422 — this schema is doc-only and never bound to the handler).

sidestring required

long/buy/bullish or short/sell/bearish.

entrynumber nullable

Intended entry price.

stopnumber nullable

Stop price.

targetnumber nullable

Target price.

leveragenumber nullable

Position leverage; must be > 0 when given (0 or negative is a 400 VALIDATION_ERROR).

horizon_hoursinteger nullable

Assessment horizon in hours (default 24).

chartboolean nullable

When true, a branded PNG chart is attached as chart_png_b64 (web surface; mobile should omit). Boolean or absent ONLY — any other JSON type is a typed 422.

Response

Graded assessment (typed; additive-only — ignore unknown fields). A replay of an earlier submission under the same key is byte-identical to the original response and carries no replay marker.

assetstring required
side'bullish' | 'bearish' required
entrynumber nullable
spotnumber nullable
stopnumber nullable
targetnumber nullable
leveragenumber nullable
horizon_hoursinteger required
venue_tickerstring nullable
price_notestring nullable
grade'A' | 'B' | 'C' | 'D' | 'F' required
scorenumber required

Calibrated win probability 0..1 (equals scoring.applied.p_cal; 0.0 on fatal geometry).

verdictstring required
falsifiersstring[] required
uncheckedstring[] required
regimestring nullable
state_directionstring nullable
realized_daily_vol_pctnumber nullable
asset_classstring nullable
hip3_marketstring nullable
engine_versionstring required
receiptsstring nullable

Proof provenance reference (n0brains.com/proof). Mobile v1 does not render it as an external link.

notestring nullable
server_timestampinteger required
free_checks_remaining_todayinteger nullable
chart_png_b64string nullable
measurement_recordedboolean nullable

Changes

No recorded changes to this operation across all 1 revision of this API.