All Endpoints

Complete reference of BV-7X API endpoints.

---

Public Endpoints

No authentication required.

Method	Path	Description
GET	/api/btc-price	Current BTC/USD price
GET	/api/fear-greed	Crypto Fear & Greed Index
GET	/api/etf-flows	Bitcoin ETF flow data (7d, 30d)
GET	/api/macro-correlation	Macro indicator correlations with BTC
GET	/api/bv7x/openclaw/signal	Public signal (direction gated)
GET	/api/bv7x/scorecard	Full prediction history with outcomes
GET	/api/bv7x/onchain-oracle/latest	Most recent on-chain attestation
GET	/api/bv7x/onchain-oracle/history	All attestation history
GET	/api/bv7x/onchain-oracle/verify/:uid	Verify a specific attestation
GET	/api/bv7x/onchain-oracle/stats	Attestation statistics
GET	/api/bv7x/agent/identity	ERC-8004 agent identity
GET	/api/bv7x/agent/reputation	ERC-8004 reputation summary
GET	/.well-known/agent-card.json	A2A agent card
GET	/.well-known/openapi.json	OpenAPI 3.1 specification

---

Basic Tier (500M+ $BV7X)

Requires bearer token from wallet verification.

Method	Path	Description
POST	/api/bv7x/oracle/verify	Verify wallet and get bearer token
GET	/api/bv7x/oracle	Full oracle signal with direction
GET	/api/bv7x/regime	Current market regime
GET	/api/bv7x/webhooks	List registered webhooks
POST	/api/bv7x/webhooks/register	Register a webhook
DELETE	/api/bv7x/webhooks/:id	Delete a webhook
POST	/api/bv7x/a2a/tasks/send	A2A task request
WSS	/ws/signal	WebSocket signal feed

---

Premium Tier (1B+ $BV7X)

Requires bearer token with Premium balance.

Method	Path	Description
GET	/api/bv7x/oracle/premium	Premium signal with attribution
GET	/api/bv7x/copy-trade/next	Structured trade intent

---

Commerce

Method	Path	Auth	Description
POST	/api/bv7x/commerce/purchase	USDC payment	x402 one-time purchase

---

Authentication

All authenticated endpoints use bearer tokens:

Authorization: Bearer <token>

Tokens are obtained via POST /api/bv7x/oracle/verify (see Token Verification). Tokens expire after 30 minutes.

---

Rate Limits

• Public endpoints: moderate rate limits for abuse prevention

• Authenticated endpoints: higher limits per wallet

• WebSocket: connection limits per wallet address

---

Base URL

https://bv7x.ai

All paths are relative to this base URL.

---

Next

• Data Types -- response schema definitions

• Quickstart -- get started in 2 minutes