🦞Oracle API Reference

REST endpoints for signals, diagnostics, market data, and commerce.

Oracle API Reference

BV-7X is an agentic price oracle in the OpenClaw + Virtuals universe. This API sells its intelligence to humans and agents. All public endpoints are accessible at https://bv7x.ai.

Authentication & rate limits

• Public endpoints No authentication. Rate-limited per IP.

• Admin endpoints HTTP Basic Auth. Internal use only.

• x402 endpoints Pay-per-request via the x402 protocol. Payments settle on-chain on Base.

Signal endpoints

Core signal data. This is the primary output of the BV-7X oracle.

• GET /api/bv7x/openclaw/signal Primary signal. Includes direction, confidence, regime, market context, model version.

• GET /api/bv7x/signal Legacy signal endpoint.

• GET /api/bv7x/scorecard Prediction scorecard. Includes accuracy, streak, recent predictions.

• GET /api/bv7x/widget Lightweight widget. Signal + confidence only.

• GET /api/bv7x/daily-brief Daily market brief. Generated at 3am UTC.

Example: GET /api/bv7x/openclaw/signal

{
  "signal": "BUY",
  "confidence": 0.62,
  "regime": "accumulation",
  "timestamp": "2026-02-21T22:00:00Z",
  "model_version": "5.3.0",
  "categories": {
    "trend": { "signal": "BULLISH", "score": 0.71 },
    "momentum": { "signal": "NEUTRAL", "score": 0.48 },
    "flow": { "signal": "BULLISH", "score": 0.65 },
    "value": { "signal": "BULLISH", "score": 0.58 }
  },
  "market_context": {
    "btc_price": 97500,
    "fear_greed": 45,
    "etf_flow_7d": 285000000
  }
}

Example: GET /api/bv7x/scorecard

{
  "accuracy": {
    "total": 0.610,
    "buy": 0.566,
    "sell": 0.638
  },
  "streak": {
    "current": 3,
    "type": "win"
  },
  "recent_predictions": [
    {
      "date": "2026-02-21",
      "signal": "BUY",
      "confidence": 0.62,
      "outcome": "pending"
    }
  ],
  "model_version": "5.3.0"
}

x402 paid endpoints

Pay-per-request oracle access using x402.

• GET /oracle Price: $0.001. Basic signal. Direction + confidence.

• GET /oracle/premium Price: $0.01. Premium. Full category breakdown + scorecard data.

How x402 works

1. Send a GET request.

2. Receive a 402 Payment Required response. It includes payment instructions.

3. Complete the on-chain payment on Base.

4. Re-send the request with the X-402-Payment header. Include your payment proof.

5. Receive the oracle data.

Agent wallet that receives payments:

• 0x4665bd3a9C1aecE814EE5606524be968355688bb (Base Sepolia)

Discovery endpoint:

• /.well-known/x402.json

Self-test & diagnostics

BV-7X runs automated quality checks. Results are published publicly.

Endpoints:

• GET /api/self-test/status Current self-test status and last run times.

• GET /api/self-test/walk-forward Walk-forward validation. 19 folds. 180-day OOS holdout per fold.

• GET /api/self-test/contamination Contamination audit. Pre/post ETF era split and regime breakdown.

• GET /api/self-test/stability Threshold stability. ±10% / ±20% perturbation. Output: STABLE, MODERATE, or OVERFIT.

• GET /api/self-test/polymarket-comparison Polymarket vs BV-7X accuracy comparison.

Cron schedule

• Outcome check: every 6 hours. Resolves pending predictions against actual price.

• Daily backtest: 3am UTC. Full walk-forward backtest with grid search.

• Weekly diagnostics: Sunday 3pm UTC. Self-report + contamination audit + stability test.

Crowd vs Oracle

Tracks BV-7X signals against prediction market crowds.

• GET /api/bv7x/crowd-vs-oracle Polymarket crowd vs BV-7X weekly head-to-head tracker.

• GET /api/bv7x/crowd-accuracy Crowd accuracy metrics.

• GET /api/bv7x/prediction-markets All tracked prediction markets.

The comparison uses Polymarket weekly BTC markets with real money volume ($5K–$25K per strike). The closest at-the-money strike is compared against BV-7X’s signal. Results are tracked and displayed on the testnet dashboard.

Market data

General market intelligence endpoints.

• GET /api/btc-price Current BTC price + 24h change.

• GET /api/fear-greed Crypto Fear & Greed Index.

• GET /api/etf-flows Bitcoin ETF inflow/outflow data.

• GET /api/etf-analytics ETF analytics and trends.

• GET /api/derivatives-summary Derivatives market summary.

• GET /api/economic-indicators Macro economic indicators.

• GET /api/interest-rates Interest rate data.

• GET /api/macro-correlation Macro-to-BTC correlation analysis.

• GET /api/liquidation-heatmap Liquidation price heatmap.

• GET /api/sth-pnl-ratio Short-term holder P&L ratio.

Staking & referrals

• GET /api/bv7x/clawstake/status Staking pool status.

• GET /api/bv7x/clawstake/markets Active staking markets.

• GET /api/bv7x/prestake/leaderboard Pre-stake leaderboard + total committed.

• POST /api/bv7x/prestake/commit Submit a pre-stake commitment.

• GET /api/refs/leaderboard Top referrers.

• GET /api/refs/stats Global referral stats.

Commerce (ACP)

BV-7X is registered on Virtuals Protocol Agent Commerce Protocol (ACP). It is a seller agent. Other AI agents can purchase data programmatically.

• GET /api/bv7x/partner-stats ACP partner statistics.

ACP offerings:

• bv7x_bitcoin_signal — $1.00. Full signal with methodology breakdown.

• bv7x_market_context — $0.25. Market context snapshot (price, sentiment, flows).

• bv7x_crowd_vs_oracle — $0.50. Crowd vs oracle comparison data.

ACP Agent ID: 3979.

Additional endpoints

Revenue & info

• GET /api/bv7x/revenue Revenue tracking (fees collected).

• GET /api/bv7x/info BV-7X public info and metrics.

• GET /api/bv7x/verify/:wallet Verify $BV7X token balance for a wallet address.

Newsletter & ecosystem

• GET /api/claw/latest Latest 4claw newsletter issue.

• GET /api/claw/archive/:weekId Archived newsletter by week ID.

• GET /api/claw/ecosystem Ecosystem sentiment and trending topics.

System

• GET /api/status API health check.

• GET /api/cache/stats Cache performance statistics.