Developer API · v1

BetEdge picks, as JSON.

Free public endpoint exposing today's top AI-detected edges. No key, no rate-limit for normal use. CDN-cached for 5 minutes — please don't hammer it.

No authentication

GET request, anonymous, CORS-open. Perfect for a quick dashboard widget or weekend Discord bot.

Pinnacle-anchored

Same fair-value math as our UI. Every pick carries the bookmaker odds, Pinnacle fair odds, and computed edge%.

Stable shape

Fields documented below are guaranteed for the life of v1. Additions are non-breaking; removals would force /v2.

JSON, indented

Pretty-printed by default. Cache headers set sane (s-maxage=300, stale-while-revalidate=600).

Endpoint

GET https://betedge.tips/api/public/picks/todayTry it →

Query params:

limit — 1 to 50 (default 20)
sport — one of soccer, basketball, americanfootball, icehockey, baseball, tennis, esports, mma, boxing, rugbyunion, cricket

Example response

{
  "generatedAt": "2026-05-16T19:32:18.421Z",
  "count": 2,
  "picks": [
    {
      "id": "d2f3e1c9-0a8b-4b2a-9b6d-7c1234567890",
      "match": {
        "home": "Como",
        "away": "Parma",
        "league": "Serie A",
        "sport": "soccer",
        "kickoff": "2026-05-17T18:45:00.000Z"
      },
      "market": "h2h",
      "selection": "Parma",
      "bookmaker": {
        "name": "Tipico",
        "slug": "tipico"
      },
      "odds": {
        "book": 12,
        "pinnacleFair": 10.67
      },
      "edgePctPostTax": 0.1246,
      "kellyFraction": 0.0084,
      "tier": "big_edge",
      "publishedAt": "2026-05-16T14:01:32.118Z"
    },
    {
      "id": "a7d8e2c3-1b4f-4c8e-9a3b-0123456789ab",
      "match": {
        "home": "Barcelona",
        "away": "Real Betis",
        "league": "La Liga",
        "sport": "soccer",
        "kickoff": "2026-05-17T19:00:00.000Z"
      },
      "market": "h2h",
      "selection": "Barcelona",
      "bookmaker": {
        "name": "Bet365",
        "slug": "bet365"
      },
      "odds": {
        "book": 1.45,
        "pinnacleFair": 1.33
      },
      "edgePctPostTax": 0.0858,
      "kellyFraction": 0.0312,
      "tier": "stark",
      "publishedAt": "2026-05-16T13:48:11.502Z"
    }
  ]
}

curl example

curl 'https://betedge.tips/api/public/picks/today?limit=5&sport=soccer' | jq

Fair use

The API is free for legitimate use — research, personal dashboards, Discord/Telegram bots, ML feature ingestion. The endpoint is CDN-cached for 5 minutes; please cache locally and avoid polling more than once per minute. Aggressive crawling will be throttled at the edge.

Need a private, higher-rate, signed feed (e.g., commercial integration)? Talk to us about enterprise →

Stability guarantees

Field additions — new fields may be added at any time. Always destructure what you need.
Field removals / renames — would force a /v2 endpoint. We'll announce 30 days ahead.
URL shape — committed. The path /api/public/picks/today is permanent.