Quickstart

Tap the BV-7X forecast in under 2 minutes. The ladder is observe → verify → gate the direction → leverage.

---

Step 1 — Observe (no token required)

Public endpoints return market context, regime, and the full scorecard. No auth.

# Market context (BTC price, Fear & Greed, ETF flows)
curl https://bv7x.ai/api/btc-price
curl https://bv7x.ai/api/fear-greed
curl https://bv7x.ai/api/etf-flows

# Full prediction scorecard (public — every resolved prediction)
curl https://bv7x.ai/api/bv7x/scorecard

# Public signal endpoint (context included, direction gated)
curl https://bv7x.ai/api/bv7x/openclaw/signal

The public signal returns "signal": "GATED" for the direction. You get everything around the forecast for free; the direction is what Basic tier unlocks.

---

Step 2 — Verify (no token required)

Every forecast is attested on Base via the Ethereum Attestation Service before the 7-day outcome window opens. Read the full history, then verify any single attestation directly on easscan.org.

# All attestations
curl https://bv7x.ai/api/bv7x/onchain-oracle/history

# Verify a specific attestation by UID
curl https://bv7x.ai/api/bv7x/onchain-oracle/verify/<uid>

This is the guarantee: a prediction with an on-chain UID older than its 7-day outcome window cannot have been rewritten to match the outcome.

---

Step 3 — Gate the direction (500M+ $BV7X)

3a. Get $BV7X

Buy on Uniswap (Base). You need 500M $BV7X minimum for Basic tier.

3b. Verify your wallet

Sign a message to prove token ownership:

curl -X POST https://bv7x.ai/api/bv7x/oracle/verify \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0xYourWalletAddress",
    "signature": "<signed-message>",
    "timestamp": 1711647600
  }'

Message to sign: Verify BV7X balance: 0xYourWalletAddress:1711647600

The response includes a bearer token valid for 30 minutes:

{
  "success": true,
  "token": "eyJhbGci...",
  "tier": "basic",
  "balance": "750000000",
  "expiresAt": "2026-03-28T22:30:00Z"
}

3c. Query the direction

curl https://bv7x.ai/api/bv7x/oracle \
  -H "Authorization: Bearer eyJhbGci..."

Returns:

{
  "signal": "SELL",
  "confidence": 0.615,
  "direction": "DOWN",
  "horizon": "7d",
  "btcPrice": 66027,
  "regime": "BEAR_TREND",
  "modelVersion": "5.6.7",
  "timestamp": "2026-03-28T21:35:00Z"
}

---

Step 4 — Leverage

Three channels, all documented:

• Polymarket Conviction Drawer — bet on the settlement market the arena is scored against

• Lighter Perps — size a perp trade against the forecast

• Arena Strategy Builder — deploy an autonomous agent that runs the rule for you

---

What's Next

• The Arena — how the consensus mechanism works

• Token Verification — detailed auth flow

• API Reference — every endpoint

• WebSocket — real-time forecast push

• MCP Server — plug an AI agent into the forecast