> 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/reference/endpoints.md).

# 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](/use-the-signal/read-the-forecast/token-verification.md)). 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](/use-the-signal/reference/data-types.md) -- response schema definitions
* [Quickstart](/use-the-signal/quickstart.md) -- get started in 2 minutes