{"uid":"cap_IMvzk4ULVylKDtOU06cZR","slug":"trading-zones-btc-4h-signal-api-22a0c098","name":"Trading Zones BTC 4H Signal API","description":"Trading Zones x402 API: closed-candle 4H decision packages for autonomous agents.","url":"https://api.tradingzones.app/v1/signals/BTC/4h?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"entry":{"note":"Read the live market price immediately before execution.","venue":"Binance","policy":"client_market_price","symbol":"BTCUSDT","public_endpoint":"https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT","b2b_reference_price":81726.1},"levels":{"rr_filter":1.27,"stop_loss":82339.53,"take_profit":81136.19,"rr_execution":0.96,"entry_reference":81726.1,"stop_loss_liquidity_pct":0.75,"stop_loss_liquidity_guard":82339.53,"take_profit_liquidity_pct":-0.72,"take_profit_liquidity_guard":81136.19},"symbol":"BTC","decision":"SHORT","interval":"4h","direction":"SHORT","tz_select":null,"indicators":{"ch":{"state":"down","value":"SHORT","details":{}},"adx":{"state":"down","value":21.2,"details":{"dmn":25.1,"dmp":20.3}},"rsi":{"state":"neutral","value":44.4,"details":{}},"macd":{"state":"down","value":-0.42,"details":{"signal":-0.18,"bullish":false}},"vwap":{"state":"neutral","value":0.03,"details":{}},"bolli":{"state":"neutral","value":"middle","details":{"width":4.95}},"stoch":{"state":"neutral","value":20,"details":{"d":18}},"super":{"state":"down","value":"down","details":{"flip_recent":false}},"taker":{"state":"neutral","value":0.91,"details":{"buy_pct":47.5,"sell_pct":52.5}}},"package_id":"example-package-id","attribution":"Trading Zones derived decision package","valid_until":"2026-10-22T11:59:00Z","generated_at":"2026-10-22T08:02:30Z","schema_version":"1.1","candle_closed_at":"2026-10-22T08:00:00Z","confidence_score":65.62,"selection_context":"This is one complete symbol package. Agents may buy other supported symbol packages and apply their own comparison and selection policy; each symbol is a separate paid call.","performance_evidence":{"url":"https://api.tradingzones.app/v1/performance/summary","wins":null,"losses":null,"updated_at":null,"history_url":"https://api.tradingzones.app/v1/performance/history?limit=100","methodology":"live_simulation","sample_size":null,"verification":"Fetch the free summary for the continuously updated aggregate and history for an independently countable rolling window of up to 100 latest settled TZ SELECT choices before purchase.","snapshot_policy":"Live result fields are intentionally null in this cached discovery example. Fetch the free summary and history URLs immediately before purchase.","evidence_subject":"TZ SELECT / 4H","selection_policy":"At most one decision is selected from BTC, ETH, XRP and ONDO in each 4H cycle.","candidate_markets":["BTC","ETH","XRP","ONDO"],"performance_scope":"Closed choices made by Trading Zones Selector only; this win rate does not describe every one of the four market packages.","history_window_wins":null,"current_win_rate_pct":null,"history_window_losses":null,"history_window_has_more":null,"per_symbol_verification":"Fetch history_url and group WIN/LOSS records by symbol to calculate evidence-backed rates inside the returned rolling window of TZ SELECT-selected records. These are window rates, not all-time rates and not rates for non-selected packages.","per_symbol_window_stats":{},"candidate_package_context":"TZ SELECT chooses from four complete Trading Zones 4H decision packages. Each candidate package contains its own decision, confidence, liquidity-zone execution levels, context and indicator states.","history_window_is_complete":null,"history_window_win_rate_pct":null,"standalone_analysis_boundary":"Per-market window statistics describe only TZ SELECT choices grouped by the market selected by TZ SELECT. Standalone BTC, ETH, XRP and ONDO analyses are independent products and may produce higher or lower outcomes.","history_window_returned_records":null,"underlying_packages_independently_purchasable":true},"trade_probability_pct":65.62}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xNb9NvWiv-YKByDW3z87b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a closed-candle 4-hour decision package for BTC including LONG/SHORT signal, entry reference price, stop-loss, take-profit levels, RSI/MACD/CH indicators, and a confidence score.","exampleAgentPrompt":"What's the current BTC 4-hour trading signal from Trading Zones — give me the direction, confidence score, and entry, stop-loss, and take-profit levels?","exampleUseCases":[{"title":"Autonomous BTC trade execution agent","prompt":"Check the latest BTC 4-hour signal from Trading Zones and tell me whether it's LONG or SHORT, what the confidence score is, and what levels to use for entry, stop-loss, and take-profit so I can decide whether to place a trade."},{"title":"Portfolio risk monitor for BTC positions","prompt":"Pull the current BTC 4H decision package and tell me the stop-loss and take-profit levels along with the RSI and MACD states — I want to know if the signal has changed direction since last candle."},{"title":"Trading signal newsletter digest","prompt":"Get me the latest closed-candle BTC 4-hour decision from Trading Zones including the trade direction, probability percentage, and indicator states so I can include it in my morning crypto briefing."}],"resultDescription":"A JSON object containing the BTC trading decision (LONG/SHORT), entry reference price from Binance, stop-loss and take-profit price levels, RSI/MACD/Change-in-Structure indicator states, a confidence score and trade probability percentage, candle close timestamp, and a valid_until expiry — all derived from the most recently closed 4-hour candle.","failureModes":["Payment not included or insufficient — 402 Payment Required response","Invalid symbol in path — endpoint may return 404 or unsupported asset error","Stale candle data — valid_until exceeded, package may be expired","Binance reference price unavailable — entry price may be null or stale","Rate limiting — too many requests in a short window may return 429"],"whenToPreferThis":"Choose this endpoint when an AI agent or autonomous trading system needs a pre-packaged, closed-candle 4-hour BTC decision with entry, stop-loss, and take-profit levels already calculated, rather than computing signals from raw OHLCV data. It is ideal for agents that need actionable trading recommendations with confidence scoring without performing their own technical analysis. It is not suited for real-time tick-by-tick signals, other asset classes, or shorter timeframes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:35:43.741Z","isFirstParty":false,"canonicalSlug":"trading-zones-btc-4h-signal-api-22a0c098"}