# VYTREL Control Market State

> VYTREL Control Market State is a paid API for AI agents from vytrel-control.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Fetches real-time BTC-USD spot market state including bid/ask, price regime, trend direction, confidence, and 24h statistics from Coinbase Exchange public REST data.

## Facts

- Endpoint: GET https://vytrel-control.vercel.app/api/market-state?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vytrel-control-market-state-acfd6487
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X4RATawTLZoJ9R0lEd2I0

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 vytrel-control-market-state-acfd6487
```

Example prompt: What's the current BTC-USD market state right now — give me the bid, ask, regime, direction, and confidence score?

## When to prefer this

Choose this endpoint when you need a single, structured, machine-payable snapshot of BTC-USD market state including regime classification, trend direction, and confidence — not just a raw price tick. It is ideal for agents that need to gate decisions on market conditions (e.g. only trade if regime is TREND and confidence > 0.9) rather than simply displaying a price. Prefer over generic price feeds when you need the full regime/direction/strength/consistency bundle in one call.

## Known failure modes

- Upstream Coinbase Exchange REST API unavailable — returns error or stale data
- High latency from Vercel cold start may increase latency_ms beyond stated 200ms
- x402 payment not settled — request blocked before data is returned
- BTC-USD product data temporarily unavailable — ok field may be false
- Stale freshness_seconds if upstream cache is delayed

## How this service works

Machine-payable URL observations and Base wallet reads, with x402 settlement receipts.

## Output

Returns a JSON object with BTC-USD spot price, bid, ask, spread in basis points, market regime (e.g. RANGE), directional signal (LONG/SHORT), confidence score (0–1), strength, 24h open/high/low/volume, 30d volume, 24h change percent, range position, consistency check result, source attribution, latency in ms, freshness in seconds, and an interpretation disclaimer.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "ask": 85000.01,
  "bid": 84999.99,
  "price": 85000,
  "regime": "RANGE",
  "schema": "vytrel.market-state.v2",
  "source": "Coinbase Exchange public REST market data",
  "symbol": "BTCUSDT",
  "low_24h": 84000,
  "evidence": [],
  "high_24h": 86000,
  "open_24h": 84500,
  "strength": 0.118343,
  "direction": "LONG",
  "confidence": 1,
  "latency_ms": 200,
  "product_id": "BTC-USD",
  "spread_bps": 0.0024,
  "volume_24h": 4500,
  "volume_30d": 176000,
  "consistency": "PASS",
  "observed_at": "2026-10-06T16:00:00.000Z",
  "change_24h_pct": 0.591716,
  "interpretation": "Mechanical spot-price state only; not a trading recommendation.",
  "range_position": 0.5,
  "freshness_seconds": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vytrel-control-market-state-acfd6487/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vytrel-control.vercel.app](https://www.zero.xyz/host/vytrel-control.vercel.app/llms.txt)