Información de la cuenta

Recupera los detalles de tu cuenta, información del nivel, límites de tasa y funciones habilitadas.


GET /api/v1/account

Este endpoint reemplaza al antiguo endpoint /me. El formato de respuesta se ha actualizado para utilizar el sobre estándar v1.

AutenticaciónPermalink for this section

Requiere API key. Disponible en todos los niveles.

Ejemplos de solicitudesPermalink 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']}")

RespuestaPermalink for this section

Éxito (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"
}

Cabeceras de respuestaPermalink for this section


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

Respuestas de errorPermalink for this section

401 Unauthorized


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

Campos de respuestaPermalink for this section

Objeto `data`Permalink for this section

Campo	Tipo	Descripción
`key_id`	string	Identificador de la API key utilizada en esta solicitud
`tier`	string	Nivel de suscripción: `free`, `hobby`, `pro`, `sharp` o `enterprise`
`rate_limit`	object	Límite de tasa y acceso a sportsbooks — ver abajo
`features`	string[]	Capacidades habilitadas en tu nivel — ver abajo
`streaming`	object	Disponibilidad de streaming SSE/WebSocket — ver abajo

Un campo updated_at de nivel superior (timestamp ISO 8601) acompaña a data.

Objeto `rate_limit`Permalink for this section

Campo	Tipo	Descripción
`requests_per_minute`	number	Número máximo de solicitudes a la API permitidas por minuto en tu nivel
`max_books`	number	Número máximo de sportsbooks accesibles en tu nivel (`999` indica ilimitado)

Array `features`Permalink for this section

Array de tokens de capacidad habilitados en tu nivel. Valores posibles:

Valor	Descripción
`odds`	Endpoints de cuotas en vivo
`schedule`	Endpoints de eventos/calendario
`ev`	Detección de oportunidades +EV
`arbitrage`	Detección de arbitraje
`middles`	Detección de middles
`low_hold`	Detección de oportunidades low-hold
`history`	Endpoints de cuotas históricas
`futures`	Mercados de futuros
`closing_line`	Endpoints de valor de línea de cierre
`splits`	Distribución de apuestas públicas

Objeto `streaming`Permalink for this section

Campo	Tipo	Descripción
`enabled`	boolean	Indica si el streaming SSE/WebSocket está disponible (por nivel, add-on o prueba)
`max_connections`	number	Número máximo de conexiones de streaming concurrentes (`0` si el streaming no está habilitado)

Casos de usoPermalink for this section

Comprobar el acceso a funciones antes de hacer solicitudesPermalink 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());
}

Endpoints relacionadosPermalink for this section

Estadísticas de uso - Uso detallado de solicitudes y streaming
Gestión de API keys - Crea, rota y elimina API keys
Autenticación - Cómo autenticar solicitudes
Precios - Compara las funciones y límites de cada nivel