Kontoinformationen

Rufen Sie Ihre Kontodetails, Stufeninformationen, Rate Limits und aktivierten Funktionen ab.


GET /api/v1/account

Dieser Endpoint ersetzt den früheren /me Endpoint. Das Antwortformat wurde aktualisiert und verwendet nun den standardmäßigen v1-Envelope.

AuthentifizierungPermalink for this section

Erfordert einen API-Schlüssel. Verfügbar für alle Stufen.

BeispielanfragenPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/account" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/account',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
 
console.log(`Tier: ${data.tier}`);
console.log(`Rate limit: ${data.rate_limit.requests_per_minute} req/min`);
console.log(`Max books: ${data.rate_limit.max_books}`);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/account',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
account = response.json()['data']
 
print(f"Tier: {account['tier']}")
print(f"Features: {account['features']}")
print(f"Streaming: {account['streaming']['enabled']}")

AntwortPermalink for this section

Erfolg (200)Permalink for this section


{
  "data": {
    "key_id": "key_abc123def456",
    "tier": "pro",
    "rate_limit": {
      "requests_per_minute": 300,
      "max_books": 15
    },
    "features": [
      "odds",
      "schedule",
      "ev",
      "arbitrage",
      "middles",
      "low_hold",
      "closing_line",
      "splits"
    ],
    "streaming": {
      "enabled": true,
      "max_connections": 10
    }
  },
  "updated_at": "2026-02-08T14:44:32.123Z"
}

Antwort-HeaderPermalink for this section


X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1707401100
X-Data-Delay: 0
X-Request-Id: req_acct123xyz

FehlerantwortenPermalink for this section

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

AntwortfelderPermalink for this section

`data`-ObjektPermalink for this section

Feld	Typ	Beschreibung
`key_id`	string	Bezeichner für den in dieser Anfrage verwendeten API-Schlüssel
`tier`	string	Abonnementstufe: `free`, `hobby`, `pro`, `sharp` oder `enterprise`
`rate_limit`	object	Rate Limit und Sportsbook-Zugriff — siehe unten
`features`	string[]	Auf Ihrer Stufe aktivierte Funktionen — siehe unten
`streaming`	object	Verfügbarkeit von SSE-/WebSocket-Streaming — siehe unten

Ein updated_at-Feld auf oberster Ebene (ISO 8601-Zeitstempel) begleitet data.

`rate_limit`-ObjektPermalink for this section

Feld	Typ	Beschreibung
`requests_per_minute`	number	Maximal zulässige API-Anfragen pro Minute auf Ihrer Stufe
`max_books`	number	Maximale Anzahl der für Ihre Stufe zugänglichen Sportsbooks (`999` bedeutet unbegrenzt)

`features`-ArrayPermalink for this section

Array von Funktions-Tokens, die auf Ihrer Stufe aktiviert sind. Mögliche Werte:

Wert	Beschreibung
`odds`	Live-Odds-Endpoints
`schedule`	Event-/Spielplan-Endpoints
`ev`	+EV-Gelegenheitserkennung
`arbitrage`	Arbitrage-Erkennung
`middles`	Middles-Erkennung
`low_hold`	Low-Hold-Gelegenheitserkennung
`history`	Historische Odds-Endpoints
`futures`	Futures-Märkte
`closing_line`	Closing-Line-Value-Endpoints
`splits`	Öffentliche Wett-Splits

`streaming`-ObjektPermalink for this section

Feld	Typ	Beschreibung
`enabled`	boolean	Ob SSE-/WebSocket-Streaming verfügbar ist (über Stufe, Add-on oder Testversion)
`max_connections`	number	Maximale Anzahl gleichzeitiger Streaming-Verbindungen (`0` wenn Streaming nicht aktiviert ist)

AnwendungsfällePermalink for this section

Überprüfen des Funktionszugriffs vor dem Senden von AnfragenPermalink for this section


const { data: account } = await fetch(
  'https://api.sharpapi.io/api/v1/account',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
).then(r => r.json());
 
if (!account.features.includes('ev')) {
  console.log('Upgrade to Pro tier for +EV detection');
} else {
  // Proceed with EV endpoint
  const evData = await fetch(
    'https://api.sharpapi.io/api/v1/opportunities/ev',
    { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
  ).then(r => r.json());
}