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

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&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.