# QuantX402 Basic Market Signal API

> QuantX402 Basic Market Signal API is a paid API for AI agents from quantx402.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns a blended directional market signal (direction, confidence, expected price range) for BTC-USD or ETH-USD, combining Kronos forecasts with market data, volatility, prediction-market odds, and sentiment.

## Facts

- Endpoint: GET https://quantx402.app/api/v1/basic?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quantx402-basic-market-signal-api-8aad21fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s0YSIGLoYqGLfRn6quFWp

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 quantx402-basic-market-signal-api-8aad21fb
```

Example prompt: What's the current market signal for BTC-USD — direction, confidence level, and expected price range for the next 24 hours?

## When to prefer this

Choose this endpoint when you need a fast, pay-per-call (no subscription) blended crypto market signal that combines forecasting, sentiment, volatility, and prediction-market odds in a single JSON call. Prefer it over raw price feeds when you want an interpreted directional signal with confidence and range, not just a spot price. Best for AI agents that need actionable trading context without building their own signal pipeline.

## Known failure modes

- Unsupported symbol (only BTC-USD and ETH-USD currently live) returns an error or empty result
- Payment failure via x402 protocol blocks access
- Stale or uncalibrated band (band_calibrated: false) indicates the range estimate may be less reliable
- Rate limiting if wallet address not provided and free trial already used
- Network timeout if upstream market data sources are unavailable

## How this service works

Market signal engine for AI agents and traders: Kronos forecasts blended with market data, volatility ranges, prediction-market odds and sentiment into one JSON fact list. Crypto live; stocks, forex rolling out. Pay per call via x402.

## Output

A JSON object containing: the market symbol, a directional forecast (UP or DOWN), a confidence rating (e.g. LOW/MEDIUM/HIGH), an expected price range array [low, high], the forecast horizon end timestamp, an as-of timestamp, and whether the band is calibrated. Covers BTC-USD and ETH-USD in real time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "enum": [
        "BTC-USD",
        "ETH-USD",
        "SOL-USD",
        "XRP-USD",
        "BNB-USD",
        "DOGE-USD",
        "ADA-USD",
        "AVAX-USD",
        "LINK-USD",
        "SUI-USD"
       ],
       "type": "string",
       "description": "Crypto pair (BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD, ADA-USD, AVAX-USD, LINK-USD, SUI-USD)"
      },
      "wallet": {
       "type": "string",
       "description": "Optional: your agent's wallet address (or send it in the X-Wallet header) so the one free trial call is tied to your wallet"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-11T22:00:00Z",
  "symbol": "BTC-USD",
  "product": "basic",
  "_example": "EXAMPLE output for illustration only (captured/synthetic values); not live or current data. Not financial advice.",
  "direction": "UP",
  "confidence": "MEDIUM",
  "horizon_end": "2026-10-12T22:00:00Z",
  "expected_range": [
   83500,
   84900
  ],
  "band_calibrated": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quantx402-basic-market-signal-api-8aad21fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quantx402.app](https://www.zero.xyz/host/quantx402.app/llms.txt)