On-Chain Oracle

The on-chain oracle API provides access to EAS attestation records. All endpoints are public.

---

Endpoints

Method	Path	Description
GET	/api/bv7x/onchain-oracle/latest	Most recent attestation
GET	/api/bv7x/onchain-oracle/history	Full attestation history
GET	/api/bv7x/onchain-oracle/verify/:uid	Verify a specific attestation by UID
GET	/api/bv7x/onchain-oracle/stats	Attestation statistics

Authentication: None (all public)

---

GET /api/bv7x/onchain-oracle/latest

Returns the most recent prediction attestation.

{
  "uid": "0xabc123...",
  "date": "2026-03-28",
  "signal": "SELL",
  "direction": "DOWN",
  "confidence": 0.615,
  "btcPrice": 66027,
  "modelVersion": "5.6.7",
  "txHash": "0xdef456...",
  "timestamp": "2026-03-28T21:38:00Z",
  "type": "prediction"
}

---

GET /api/bv7x/onchain-oracle/history

Returns all attestations ordered by date (newest first).

{
  "attestations": [
    {
      "uid": "0xabc123...",
      "date": "2026-03-28",
      "type": "prediction",
      "signal": "SELL",
      "direction": "DOWN",
      "confidence": 0.615,
      "btcPrice": 66027,
      "txHash": "0xdef456..."
    },
    {
      "uid": "0x789abc...",
      "date": "2026-03-21",
      "type": "resolution",
      "signal": "BUY",
      "direction": "UP",
      "outcome": "WIN",
      "btcAtSignal": 64500,
      "btcAtResolution": 67200,
      "txHash": "0xghi789..."
    }
  ],
  "total": 284
}

Attestations have two types:

• prediction -- created at signal time (before outcome is known)

• resolution -- created when the 7-day outcome resolves

---

GET /api/bv7x/onchain-oracle/verify/:uid

Verify a single attestation by its UID. Returns the full attestation data plus on-chain verification status.

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

{
  "uid": "0xabc123...",
  "verified": true,
  "onChain": true,
  "date": "2026-03-28",
  "type": "prediction",
  "signal": "SELL",
  "direction": "DOWN",
  "confidence": 0.615,
  "btcPrice": 66027,
  "attester": "0xd8B71d23e1a8da9867497C0E757A1143B94C3e1e",
  "txHash": "0xdef456...",
  "easscanUrl": "https://base.easscan.org/attestation/view/0xabc123..."
}

---

GET /api/bv7x/onchain-oracle/stats

Aggregate statistics across all attestations.

{
  "totalAttestations": 284,
  "predictions": 142,
  "resolutions": 142,
  "firstAttestation": "2025-10-01",
  "latestAttestation": "2026-03-28",
  "chain": "Base",
  "attester": "0xd8B71d23e1a8da9867497C0E757A1143B94C3e1e"
}

---

Next

• Verify a Prediction -- step-by-step verification guide

• EAS Attestations -- how the attestation system works