Inicio rápido

Empieza a usar SharpAPI en 2 minutos.

URL base


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

Utiliza siempre api.sharpapi.io —no sharpapi.io— para las solicitudes a la API.

Obtén tu clave de API

Regístrate - Crea una cuenta gratuita en sharpapi.io/sign-up
Obtén tu clave - Copia tu clave de API desde el panel de control. Comienza con sk_live_
Realiza tu primera llamada - Utiliza los ejemplos siguientes para obtener cuotas en directo

Tu primera llamada a la API

cURL


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

JavaScript


const response = await fetch('https://api.sharpapi.io/api/v1/odds', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});
 
const { data, meta } = await response.json();
console.log(`Found ${meta.count} odds`);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/odds',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
 
data = response.json()
print(f"Found {data['meta']['count']} odds")

TypeScript


import { SharpApiClient } from '@sharpapi/client';
 
const client = new SharpApiClient('YOUR_API_KEY');
const { data, meta } = await client.getOdds();
 
console.log(`Found ${meta.count} odds`);

Ejemplo de respuesta


{
  "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
    }
  ],
  "meta": {
    "count": 1,
    "total": 3095,
    "books_available": ["draftkings", "fanduel"],
    "books_returned": ["draftkings"],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": true,
      "next_offset": 50
    },
    "updated_at": "2026-01-26T02:10:37.846Z",
    "filters": {}
  }
}

Filtra tus resultados

Añade parámetros de consulta para acotar los resultados:


# Obtener cuotas de la NBA solo de DraftKings
curl "https://api.sharpapi.io/api/v1/odds?league=nba&sportsbook=draftkings" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Obtener solo eventos en directo
curl "https://api.sharpapi.io/api/v1/odds?live=true" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Obtener solo los mercados principales (moneyline, spread, total)
curl "https://api.sharpapi.io/api/v1/odds?market=moneyline,spread,total" \
  -H "X-API-Key: YOUR_API_KEY"

Encuentra apuestas de valor

Una vez que tengas una suscripción Pro, podrás encontrar oportunidades +EV:


curl "https://api.sharpapi.io/api/v1/opportunities/ev?min_ev=3.0" \
  -H "X-API-Key: YOUR_API_KEY"

Respuesta:


{
  "data": [
    {
      "opportunity_id": "opp_x1y2z3",
      "event_name": "PHO Suns @ PHI 76ers",
      "sportsbook": "draftkings",
      "selection": "PHO Suns -3.5",
      "odds": {
        "american": -105,
        "decimal": 1.952,
        "odds_probability": 0.512
      },
      "sharp_odds": {
        "american": -115,
        "decimal": 1.870,
        "odds_probability": 0.535
      },
      "ev_percentage": 4.35,
      "kelly_percent": 2.18
    }
  ],
  "meta": {
    "count": 12,
    "total": 12,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T02:10:37.846Z",
    "filters": {
      "min_ev": 3.0
    }
  }
}

Streaming en tiempo real

Para obtener las actualizaciones más rápidas, utiliza el streaming SSE (requiere el complemento WebSocket):


const eventSource = new EventSource(
  'https://api.sharpapi.io/api/v1/stream?channel=all&api_key=YOUR_KEY'
);
 
eventSource.addEventListener('connected', (e) => {
  const { stream_id } = JSON.parse(e.data);
  console.log('Stream connected:', stream_id);
});
 
eventSource.addEventListener('snapshot', (e) => {
  const { odds } = JSON.parse(e.data);
  console.log('Initial snapshot:', odds.length, 'odds');
});
 
eventSource.addEventListener('odds:update', (e) => {
  const update = JSON.parse(e.data);
  console.log('Update from:', update.sportsbook);
});
 
eventSource.addEventListener('ev:detected', (e) => {
  const opp = JSON.parse(e.data);
  console.log(`+EV found: ${opp.selection} at ${opp.ev_percentage}% EV`);
});

Próximos pasos

Obtén apuestas +EV - Encuentra oportunidades de valor esperado positivo
Encuentra arbitrajes - Detecta oportunidades de beneficio sin riesgo (aprende cómo funcionan los arbitrajes)
Mercados Low Hold - Encuentra las líneas más ajustadas entre casas
Streaming en directo - Actualizaciones en tiempo real mediante SSE
SDK de TypeScript - Seguridad de tipos completa y streaming integrado
SDK de Python - Modelos Pydantic y compatibilidad con async
Límites de tasa - Entiende los límites de uso
Precios - Compara planes y funcionalidades

Problemas comunes

Error: 401 Unauthorized

Asegúrate de utilizar la clave de API correcta y de que esté correctamente formateada en la cabecera.

Error: 429 Rate Limited

Has superado tu límite de tasa. Espera al tiempo de restablecimiento indicado en X-RateLimit-Reset o actualiza tu plan.

Error: 403 Tier Restricted

Este endpoint requiere un nivel superior. Consulta la página de Precios para ver las funcionalidades de cada nivel.