> 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/examples/curl.md).

# cURL

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

***

## Public Endpoints (No Auth)

### Current BTC Price

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

### Fear & Greed Index

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

### ETF Flows

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

### Public Signal (Direction Gated)

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

### Prediction Scorecard

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

### On-Chain Attestation History

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

### Latest Attestation

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

### Verify an Attestation

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

### Attestation Stats

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

### Macro Correlations

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

***

## Authenticated Endpoints

### Step 1: Verify Wallet

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

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

### Premium Oracle

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

### Market Regime

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

### Copy-Trade Intent (Premium Tier)

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

***

## Webhook Registration

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

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

### Delete a Webhook

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

***

## Agent Endpoints

### Agent Identity

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

### Agent Reputation

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

### Agent Card

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

***

## Next

* [Python Example](/use-the-signal/examples/python.md) -- full auth flow in Python
* [Node.js Example](/use-the-signal/examples/nodejs.md) -- full auth flow in Node.js