API-Referenz Übersicht

Vollständige Referenz für die SharpAPI v1 REST API. Alle Endpoints geben JSON zurück und folgen einheitlichen Konventionen für Authentifizierung, Filterung, Paginierung und Fehlerbehandlung.

Basis-URLPermalink for this section

https://api.sharpapi.io/api/v1

OpenAPI-SpezifikationPermalink for this section

Die vollständige OpenAPI 3.1-Spezifikation steht zum Import in Tools wie Postman, Insomnia oder Code-Generatoren zur Verfügung:

• OpenAPI-Spezifikation herunterladen (JSON)

Request-FormatPermalink for this section

• Alle Anfragen verwenden HTTPS
• Authentifizierung über X-API-Key-Header, Authorization: Bearer-Header oder api_key-Query-Parameter
• Request-Bodies (sofern zutreffend) verwenden JSON mit Content-Type: application/json
• Alle Feldnamen sind in snake_case

Endpoint-ÜbersichtPermalink for this section

SharpAPI bietet 35 Routen über 7 Namespaces hinweg, zuzüglich Referenz- und Health-Endpoints.

OddsPermalink for this section

EventsPermalink for this section

OpportunitiesPermalink for this section

SplitsPermalink for this section

StreamingPermalink for this section

AccountPermalink for this section

Referenzdaten (öffentlich)Permalink for this section

EnterprisePermalink for this section

HealthPermalink for this section

Response-FormatPermalink for this section

Zwei Formen auf oberster Ebene — beide stellen data an den Anfang und updated_at ans Ende, mit einem optionalen pagination-Block dazwischen. Es gibt kein success-Feld; der HTTP-Statuscode ist die Quelle der Wahrheit. Siehe Response Conventions für das vollständige Regelwerk.

Paginierte Listen-AntwortPermalink for this section

{
  "data": [
    {
      "id": "draftkings_33483153_moneyline_PHO",
      "sportsbook": "draftkings",
      "sport": "basketball",
      "home_team": "PHI 76ers",
      "away_team": "PHO Suns",
      "market_type": "moneyline",
      "selection": "PHO Suns",
      "odds_american": -150,
      "odds_decimal": 1.667,
      "odds_probability": 0.60,
      "is_live": false
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 3095,
    "has_more": true,
    "next_offset": 50,
    "next_cursor": "eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0"
  },
  "updated_at": "2026-01-26T02:10:37.846Z"
}

Antwort für einzelne RessourcePermalink for this section

Wird für Einzelressourcen (/account, /events/:eventId) und nicht-paginierte Referenz-Endpoints verwendet. Kein pagination-Block.

{
  "data": {
    "id": "evt_abc123",
    "sport": "nba",
    "home_team": "PHI 76ers",
    "away_team": "PHO Suns",
    "start_time": "2026-01-26T19:00:00Z"
  },
  "updated_at": "2026-01-26T02:10:37.846Z"
}

Fehler-EnvelopePermalink for this section

Alle Fehler folgen einem einheitlichen Format:

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Upgrade your plan or wait 45 seconds.",
    "docs": "https://docs.sharpapi.io/en/authentication#rate-limits"
  }
}

Standard-Response-HeaderPermalink for this section

Jede API-Antwort enthält diese Header:

Tier-VergleichPermalink for this section

FilterungPermalink for this section

Alle Listen-Endpoints unterstützen Filterung über Query-Parameter. Filter verwenden singuläre Parameternamen und akzeptieren kommagetrennte Werte für Mehrfachauswahl.

Filter-ParameterPermalink for this section

Veraltete AliasePermalink for this section

Ältere Schreibweisen von zwei Filtern werden weiterhin akzeptiert: event für event_id und live für is_live. Sie liefern dieselben Zeilen, es geht also nichts kaputt — die Antwort enthält jedoch Deprecation: true und einen Warning-Header, und diese Namen können in einer künftigen Version entfallen. Verwenden Sie in neuem Code die kanonischen Namen aus der Tabelle oben. Ein Termin für die Abschaltung ist nicht festgelegt und wird nicht ohne Vorankündigung erfolgen.

BeispielePermalink for this section

# Multiple sportsbooks (comma-separated)
curl "https://api.sharpapi.io/api/v1/odds?sportsbook=draftkings,fanduel" \
  -H "X-API-Key: YOUR_KEY"
 
# Combine filters
curl "https://api.sharpapi.io/api/v1/odds?league=nba,nhl&sportsbook=pinnacle&is_live=true" \
  -H "X-API-Key: YOUR_KEY"
 
# Paginate through results
curl "https://api.sharpapi.io/api/v1/odds?limit=25&offset=50" \
  -H "X-API-Key: YOUR_KEY"

Odds-FormatePermalink for this section

Alle Odds werden als flache Felder auf jedem Odds-Objekt zurückgegeben:

{
  "odds_american": -110,
  "odds_decimal": 1.909,
  "odds_probability": 0.5238
}

FehlercodesPermalink for this section

Die kanonische Liste der von der API ausgegebenen Fehlercodes. Der String in error.code ist der stabile Vertrag — prüfen Sie diesen anstelle des prosaischen message-Felds.

HTTP-FehlercodesPermalink for this section

In REST-Antworten ausgegeben.

WebSocket-Frame-FehlercodesPermalink for this section

Werden ausschließlich innerhalb von {"type": "error", "code": "..."}-Frames auf einer offenen WebSocket-Verbindung ausgegeben. Sie beschreiben Client-Protokoll-Fehler und entsprechen keinem HTTP-Status.