> 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/trade-the-forecast/copy-trade.md).

# Copy-Trade

Returns a structured trade intent that agents and bots can use to replicate BV-7X trades. Requires Premium tier authentication.

***

## Endpoint

```
GET /api/bv7x/copy-trade/next
Authorization: Bearer <token>
```

**Authentication**: Premium tier (1B+ $BV7X)

***

## Response

```json
{
  "trade": {
    "direction": "SELL",
    "confidence": 0.615,
    "horizon": "7d",
    "btcPrice": 66027,
    "regime": "BEAR_TREND",
    "sizing": {
      "kellyFraction": 0.046,
      "suggestedSize": "4.6%",
      "maxLeverage": "3x"
    },
    "polymarket": {
      "market": "Will BTC be above $66,000 on April 4?",
      "tokenId": "0xabc...",
      "side": "NO",
      "currentOdds": 0.42
    },
    "trackRecord": {
      "accuracy30d": 0.68,
      "accuracyAllTime": 0.627,
      "currentStreak": 3
    }
  },
  "validUntil": "2026-03-29T21:35:00Z",
  "timestamp": "2026-03-28T21:37:00Z"
}
```

***

## Fields

### Trade Object

| Field        | Type   | Description                                    |
| ------------ | ------ | ---------------------------------------------- |
| `direction`  | string | `SELL` (short/bearish) or `BUY` (long/bullish) |
| `confidence` | number | Model confidence (0.50--0.99)                  |
| `horizon`    | string | Prediction timeframe                           |
| `btcPrice`   | number | BTC/USD at signal time                         |
| `regime`     | string | Current market regime                          |

### Sizing

| Field           | Type   | Description                                                    |
| --------------- | ------ | -------------------------------------------------------------- |
| `kellyFraction` | number | Optimal position size as fraction of capital (Kelly criterion) |
| `suggestedSize` | string | Human-readable position size                                   |
| `maxLeverage`   | string | Maximum suggested leverage                                     |

### Polymarket

| Field         | Type   | Description                       |
| ------------- | ------ | --------------------------------- |
| `market`      | string | Polymarket market title           |
| `tokenId`     | string | Token ID for programmatic trading |
| `side`        | string | `YES` or `NO`                     |
| `currentOdds` | number | Current market odds               |

### Track Record

| Field             | Type   | Description                     |
| ----------------- | ------ | ------------------------------- |
| `accuracy30d`     | number | Rolling 30-day accuracy         |
| `accuracyAllTime` | number | All-time out-of-sample accuracy |
| `currentStreak`   | number | Consecutive correct predictions |

***

## Usage Notes

* The trade intent is updated once daily after signal computation (\~21:37 UTC)
* `validUntil` indicates when the next signal will replace this one
* Position sizing uses Kelly criterion based on historical edge -- adjust to your risk tolerance
* The Polymarket fields are provided for agents that want to mirror the oracle's prediction market bets

***

## Error Responses

| Status | Reason                                          |
| ------ | ----------------------------------------------- |
| 401    | Missing or expired bearer token                 |
| 403    | Token balance below 1B $BV7X (Premium required) |
| 404    | No active trade intent available                |

***

## Example

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

***

## Next

* [Copy-Trading Guide](/agentic-commerce/copy-trading.md) -- building a copy-trading agent
* [WebSocket](/use-the-signal/read-the-forecast/websocket.md) -- real-time signal push for faster execution