Build on the ledger

GET /api/bets/history

Returns all tracked bets (open and settled) whose event_date falls within the specified UTC window. Tracked bets carry a virtual stake and P&L.

Required Query Parameters

Example Request

curl -s \
  -H "x-api-key: $PROPHETAI_API_KEY" \
  "https://prophetai.club/api/bets/history?start_utc=2026-04-01T00:00:00Z&end_utc=2026-04-30T23:59:59Z"

Response Envelope

{
  "data": [ <Bet>, <Bet>, ... ],
  "count": 35,
  "filter": {
    "field": "event_date",
    "start_utc": "2026-04-01T00:00:00.000Z",
    "end_utc": "2026-04-30T23:59:59.000Z"
  }
}

Bet Object Schema

Example Bet Object

{
  "id": 37,
  "bet_id": "PROP-037",
  "run_id": "prophetai-20260429-082005-54197",
  "sport": "ice-hockey",
  "league": "USA - NHL",
  "event_name": "Pittsburgh Penguins at Philadelphia Flyers (Game 6)",
  "event_id": 70558128,
  "event_date": "2026-04-29T23:30:00Z",
  "selection": "Philadelphia Flyers to Win",
  "bet_side": "home",
  "market": "ML",
  "odds_at_pick": 1.83,
  "best_odds": 1.83,
  "best_bookmaker": "Bet365",
  "all_odds": { "Bet365": "1.85", "William Hill": "1.83", "Paddy Power": "1.83", "Ladbrokes": "1.80", "BetVictor": "1.80" },
  "expected_value": 0.065,
  "confidence": "HIGH",
  "confidence_pct": 80,
  "virtual_stake": 10,
  "rationale": "Flyers lead this series 3-2 and come HOME for G6...",
  "status": "won",
  "pnl": 8.3,
  "created_at": "2026-04-29T07:22:58Z",
  "settled_at": "2026-05-05T09:32:41Z",
  "settlement_src": "sofascore + ai-settler",
  "settlement_detail": "Team A won 2-0 [AI-settled, confidence=0.95]",
  "series_info": "Game 6",
  "betfair_market_id": null,
  "betfair_selection_id": null
}

GET /api/tips

Returns tips — informational picks with no virtual staking or P&L. Tips are outcome-tracked (won/lost) but do not affect bankroll. All query parameters are optional; omitting all returns the full set.

Optional Query Parameters

Date filters only apply when both start_utc and end_utc are provided. All filters combine freely. Use acca_id to retrieve just the legs belonging to a specific accumulator.

Example Requests

# All tips (no filters)
curl -s -H "x-api-key: $PROPHETAI_API_KEY" \
  "https://prophetai.club/api/tips"

# Tennis tips that won
curl -s -H "x-api-key: $PROPHETAI_API_KEY" \
  "https://prophetai.club/api/tips?sport=tennis&status=won"

# Tips for a specific date range
curl -s -H "x-api-key: $PROPHETAI_API_KEY" \
  "https://prophetai.club/api/tips?start_utc=2026-04-01T00:00:00Z&end_utc=2026-04-30T23:59:59Z"

# Legs of a specific ACCA
curl -s -H "x-api-key: $PROPHETAI_API_KEY" \
  "https://prophetai.club/api/tips?acca_id=ACCA-054"

Response Envelope

{
  "data": [ <Tip>, <Tip>, ... ],
  "count": 230,
  "filters": {                        // only present when filters are applied
    "sport": "tennis",
    "status": "won"
  }
}

Tip Object Schema

Example Tip Object

{
  "id": 228,
  "tip_id": "TIP-228",
  "run_id": "prophetai-20260429-082005-54197",
  "sport": "horse-racing",
  "league": "Pontefract",
  "event_name": "Pontefract 29th Apr - 1m2f NHC EBF Novice Stakes",
  "event_id": 0,
  "event_date": "2026-04-29T13:13:00Z",
  "selection": "Infraad",
  "bet_side": null,
  "market": "WIN",
  "odds_at_post": 1.97,
  "confidence": null,
  "confidence_pct": null,
  "best_bookmaker": "Betfair Exchange",
  "rationale": "Haggas-Marquand combo firing this spring...",
  "acca_id": "ACCA-054",
  "status": "won",
  "settled_at": "2026-04-29T16:17:42Z",
  "settlement_detail": "WINNER — Betfair market 1.257448466",
  "created_at": "2026-04-29T07:23:17Z",
  "betfair_market_id": "1.257448466",
  "betfair_selection_id": 90262117
}