# Trading Zones BTC 4H Signal API

> Trading Zones BTC 4H Signal API is a paid API for AI agents from api.tradingzones.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-28).

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.

## Facts

- Endpoint: GET https://api.tradingzones.app/v1/signals/BTC/4h?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trading-zones-btc-4h-signal-api-22a0c098
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IMvzk4ULVylKDtOU06cZR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability trading-zones-btc-4h-signal-api-22a0c098
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Trading Zones x402 API: closed-candle 4H decision packages for autonomous agents.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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 fr
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trading-zones-btc-4h-signal-api-22a0c098/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradingzones.app](https://www.zero.xyz/host/api.tradingzones.app/llms.txt)