cURL

Quick-reference cURL commands for the most common BV-7X API operations.

---

Public Endpoints (No Auth)

Current BTC Price

curl https://bv7x.ai/api/btc-price

Fear & Greed Index

curl https://bv7x.ai/api/fear-greed

ETF Flows

curl https://bv7x.ai/api/etf-flows

Public Signal (Direction Gated)

curl https://bv7x.ai/api/bv7x/openclaw/signal

Prediction Scorecard

curl https://bv7x.ai/api/bv7x/scorecard

On-Chain Attestation History

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

Latest Attestation

curl https://bv7x.ai/api/bv7x/onchain-oracle/latest

Verify an Attestation

curl https://bv7x.ai/api/bv7x/onchain-oracle/verify/0xabc123...

Attestation Stats

curl https://bv7x.ai/api/bv7x/onchain-oracle/stats

Macro Correlations

curl https://bv7x.ai/api/macro-correlation

---

Authenticated Endpoints

Step 1: Verify Wallet

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

Save the token from the response.

Step 2: Query Oracle (Basic Tier)

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

Premium Oracle

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

Market Regime

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

Copy-Trade Intent (Premium Tier)

curl https://bv7x.ai/api/bv7x/copy-trade/next \
  -H "Authorization: Bearer eyJhbGci..."

---

Webhook Registration

curl -X POST https://bv7x.ai/api/bv7x/webhooks/register \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["signal.new", "signal.resolved"],
    "secret": "your-webhook-secret"
  }'

List Webhooks

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

Delete a Webhook

curl -X DELETE https://bv7x.ai/api/bv7x/webhooks/wh_abc123 \
  -H "Authorization: Bearer eyJhbGci..."

---

Agent Endpoints

Agent Identity

curl https://bv7x.ai/api/bv7x/agent/identity

Agent Reputation

curl https://bv7x.ai/api/bv7x/agent/reputation

Agent Card

curl https://bv7x.ai/.well-known/agent-card.json

---

Next

• Python Example -- full auth flow in Python

• Node.js Example -- full auth flow in Node.js