Skip to main content
BetEdge API

Versioned access to published BetEdge data

The external API gives Elite customers self-serve access to published predictions, tracked games, and verified performance summary data. Access is billed through the Elite plan and currently includes 2,500 requests per month.

Authentication

Use `Authorization: Bearer be_live_...` on every request. Keys are managed from the in-app developer dashboard and shown only once at creation.

Versioning

All supported endpoints live under `/api/v1`. Additive fields may appear without a new version; breaking changes will ship under a new versioned path.

Packaging

Elite includes the current external API package. Overages are blocked instead of billed automatically, so monthly usage stays predictable.

Endpoints

GET/api/v1/predictions

List published predictions with sport, market, and confidence filters.

GET/api/v1/predictions/{predictionId}

Fetch a single published prediction with settlement and verification metadata.

GET/api/v1/games

List tracked games with sportsbook and prediction counts.

GET/api/v1/track-record/summary

Return win/loss, units, and ROI summary for published predictions.

Example Request

Filter published predictions by sport and confidence.

curl "https://betedges.com/api/v1/predictions?sport=nfl&minConfidence=70&limit=10" \
  -H "Authorization: Bearer be_live_..."

Example Response

Published predictions include settlement and verification metadata.

{
  "data": [
    {
      "id": "pred_123",
      "sport": "nfl",
      "market": "spread",
      "predictedOutcome": "Bills -3.5",
      "confidence": 74,
      "result": "win",
      "verificationUrl": "/api/public/verify/pred_123"
    }
  ],
  "pagination": { "nextCursor": null, "hasMore": false }
}