Skip to Content
Referencia de la APIInformación de la cuenta

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ónEnlace permanente a esta sección

Requiere API key. Disponible en todos los niveles.

Ejemplos de solicitudesEnlace permanente a esta sección

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

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

{ "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": 1 } }, "updated_at": "2026-02-08T14:44:32.123Z" }

Cabeceras de respuestaEnlace permanente a esta sección

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

Respuestas de errorEnlace permanente a esta sección

401 Unauthorized

Si no se envía ninguna clave se devuelve missing_api_key; una clave inválida devuelve invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication" } }

Campos de respuestaEnlace permanente a esta sección

Objeto dataEnlace permanente a esta sección

CampoTipoDescripción
key_idstringIdentificador de la API key utilizada en esta solicitud
tierstringNivel de suscripción: free, hobby, pro, sharp o enterprise
rate_limitobjectLímite de tasa y acceso a sportsbooks — ver abajo
featuresstring[]Capacidades habilitadas en tu nivel — ver abajo
streamingobjectDisponibilidad de streaming SSE/WebSocket — ver abajo

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

Objeto rate_limitEnlace permanente a esta sección

CampoTipoDescripción
requests_per_minutenumberNúmero máximo de solicitudes a la API permitidas por minuto en tu nivel
max_booksnumberNúmero máximo de sportsbooks accesibles en tu nivel (999 indica ilimitado)

Array featuresEnlace permanente a esta sección

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

ValorDescripción
oddsEndpoints de cuotas en vivo
scheduleEndpoints de eventos/calendario
evDetección de oportunidades +EV
arbitrageDetección de arbitraje
middlesDetección de middles
low_holdDetección de oportunidades low-hold
historyEndpoints de cuotas históricas
futuresMercados de futuros
closing_lineEndpoints de valor de línea de cierre
splitsDistribución de apuestas públicas

Objeto streamingEnlace permanente a esta sección

CampoTipoDescripción
enabledbooleanIndica si el streaming SSE/WebSocket está disponible (por nivel o add-on)
max_connectionsnumberNúmero máximo de conexiones de streaming concurrentes (0 si el streaming no está habilitado)

Casos de usoEnlace permanente a esta sección

Comprobar el acceso a funciones antes de hacer solicitudesEnlace permanente a esta sección

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 relacionadosEnlace permanente a esta sección

Last updated on