> For the complete documentation index, see [llms.txt](https://docs.bv7x.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bv7x.ai/use-the-signal/quickstart.md).

# 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.

```bash
# 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.

```bash
# 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)](https://app.uniswap.org/swap?chain=base\&outputCurrency=0xd88fd4a11255e51f64f78b4a7d74456325c2d8dc). You need **500M $BV7X** minimum for Basic tier.

### 3b. Verify your wallet

Sign a message to prove token ownership:

```bash
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:

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

### 3c. Query the direction

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

Returns:

```json
{
  "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](/use-the-signal/trade-the-forecast/polymarket.md) — bet on the settlement market the arena is scored against
* [Lighter Perps](/use-the-signal/trade-the-forecast/lighter.md) — size a perp trade against the forecast
* [Arena Strategy Builder](/use-the-signal/trade-the-forecast/strategy-builder.md) — deploy an autonomous agent that runs the rule for you

***

## What's Next

* [The Arena](/how-it-works/arena.md) — how the consensus mechanism works
* [Token Verification](/use-the-signal/read-the-forecast/token-verification.md) — detailed auth flow
* [API Reference](/use-the-signal/read-the-forecast/signal.md) — every endpoint
* [WebSocket](/use-the-signal/read-the-forecast/websocket.md) — real-time forecast push
* [MCP Server](/agentic-commerce/mcp-server.md) — plug an AI agent into the forecast