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

{
  "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

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

---

Next

• Copy-Trading Guide -- building a copy-trading agent

• WebSocket -- real-time signal push for faster execution