One Capital Club · Documentación técnica

Documentación de endpoints de la API

Referencia práctica para tener a mano todos los endpoints de la API: cómo llamarlos, qué parámetros esperan, qué devuelven y en qué casos tiene sentido usarlos dentro de OCC, The Lounge, n8n o integraciones internas.

Reglas generales

Salvo / y /health, el resto de endpoints esperan la clave por query string usando apikey. Las rutas del archivo están pensadas como llamadas GET.

https://api.elitelia.cloud/endpoint?param=valor&apikey=TU_API_KEY

Resumen rápido

Precio rápido /price
Ficha de activo /profile / /summary
Gráficos y series /time_series / /download
Screening /screen / /equity-screen

Índice

Usa este índice para saltar directamente al bloque que necesites.

BásicosRoot y healthcheck Precios y cotizaciónPrice, quote, smart price Perfil y fichaTicker, profile, summary Métricas y análisisMetrics UI y full Históricos y seriesTime series y download Multi-tickerWatchlists y tablas BúsquedaSearch y resolve Mercado, sector e industriaMarket, sector, industry ScreeningPredefinido y custom

Endpoints básicos

Rutas simples para comprobar que el servicio está vivo o mostrar una portada mínima de la API.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/ GET Ninguno 
curl https://api.elitelia.cloud/
 HTML simple con “One Capital Club API”, “Servicio activo” y aviso de acceso restringido. Check visual rápido o pequeña página de presentación.
/health GET Ninguno 
curl https://api.elitelia.cloud/health
 
{
  "status": "ok"
}
 Healthcheck para monitorización, Traefik, Docker o uptime checks.
Volver arriba

Precios y cotización

Endpoints pensados para sacar el precio, la cotización del día o resolver una búsqueda textual con el menor rozamiento posible.

/price · precio simple
Endpoint Método Parámetros Ejemplo Qué devuelve Errores Uso
/price GET ticker opcional (por defecto AAPL)
apikey obligatorio		 
curl "https://api.elitelia.cloud/price?ticker=MSFT&apikey=TU_API_KEY"
 
{
  "ticker": "MSFT",
  "price": 421.33
}
 401 si la API key es incorrecta
404 si no hay datos		 Precio rápido y limpio, ideal para KPIs o comprobaciones puntuales.
/quote · cotización estilo market data
Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/quote GET ticker obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/quote?ticker=AAPL&apikey=TU_API_KEY"
 
{
  "ticker": "AAPL",
  "base_symbol": "AAPL",
  "c": 182.54,
  "d": 1.12,
  "dp": 0.62,
  "h": 183.10,
  "l": 180.80,
  "o": 181.00,
  "pc": 181.42,
  "t": 1774567890
}
 Widgets de mercado, radar, tarjetas de seguimiento o bloques de variación diaria.
/price-smart · búsqueda por texto + precio
Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/price-smart GET q obligatorio
max_results opcional, por defecto 5
apikey obligatorio		 
curl "https://api.elitelia.cloud/price-smart?q=microsoft&apikey=TU_API_KEY"
 
{
  "query": "microsoft",
  "resolved_symbol": "MSFT",
  "resolved_name": "Microsoft Corporation",
  "exchange": "NMS",
  "quoteType": "EQUITY",
  "price": 421.33
}
 Muy útil para UX, búsquedas humanas y formularios donde el usuario no conoce el ticker.
Volver arriba

Perfil y ficha de activo

Rutas para obtener una vista completa, una ficha más limpia o un resumen compacto de un activo.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/ticker GET ticker opcional, por defecto AAPL
apikey obligatorio		 
curl "https://api.elitelia.cloud/ticker?ticker=NVDA&apikey=TU_API_KEY"
 Bloque bastante bruto con info, fast_info y calendar. Debug, exploración o cuando quieres ver prácticamente todo lo que da yfinance.
/profile GET ticker obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/profile?ticker=GOOGL&apikey=TU_API_KEY"
 
{
  "ticker": "GOOGL",
  "name": "Alphabet Inc.",
  "country": "United States",
  "currency": "USD",
  "exchange": "NMS",
  "industry": "Internet Content & Information",
  "finnhubIndustry": "Communication Services",
  "ipo": "2004-08-19",
  "marketCapitalization": 2100000000000,
  "shareOutstanding": 12345678900,
  "weburl": "https://abc.xyz",
  "logo": null,
  "phone": "650-253-0000",
  "base_symbol": "GOOGL"
}
 Fichas de empresa, encabezados de activo, context blocks o tarjetas informativas.
/summary GET ticker obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/summary?ticker=AMZN&apikey=TU_API_KEY"
 Resumen financiero compacto: precio, variación diaria, sector, industria, múltiplos, ROE, market cap, beta, volumen y posición en rango anual. Vista rápida, ficha compacta o tarjeta de resumen antes de entrar al análisis completo.
Volver arriba

Métricas y análisis

Endpoints pensados para mostrar múltiplos, ratio, rango anual y datos que ya vienen más listos para interfaz o análisis.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/metrics-ui GET ticker obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/metrics-ui?ticker=TSLA&apikey=TU_API_KEY"
 Bloque ui con sector, industria, PE, forward PE, PB, ROE, dividendo, market cap, precio, cambio del día, rango 52 semanas, posición en rango, beta y volumen medio. Incluye campos reservados como since_entry y vs_sp500, aunque ahora salgan en null. Tarjetas del Lounge, paneles resumidos, fichas premium o bloques tipo “snapshot”.
/metrics-full GET ticker obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/metrics-full?ticker=META&apikey=TU_API_KEY"
 Devuelve metric con 52W high/low, PE, PB, beta, market cap y dividend yield, además de series anuales de revenue y netIncome. Gráficos fundamentales, comparativas anuales y research más profundo.
Volver arriba

Históricos y series temporales

Pensados para gráficos, exportaciones o cualquier bloque donde necesites velas, OHLC o tablas de histórico.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/time_series GET ticker obligatorio
interval opcional: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 1day, 1week, 1month
period opcional, por defecto 1y
outputsize opcional, por defecto 100
apikey obligatorio		 
curl "https://api.elitelia.cloud/time_series?ticker=SPY&interval=1day&period=6mo&outputsize=30&apikey=TU_API_KEY"
 Formato tipo market data con meta, values y status. Las filas incluyen datetime, open, high, low, close y volume. Charts OHLC, gráficos de velas, histórico diario o intradía.
/download GET symbols opcional, por defecto AAPL,MSFT
period opcional, por defecto 1mo
interval opcional, por defecto 1d
group_by opcional, por defecto column
auto_adjust opcional, por defecto false
apikey obligatorio		 
curl "https://api.elitelia.cloud/download?symbols=AAPL,MSFT&period=6mo&interval=1d&group_by=column&auto_adjust=true&apikey=TU_API_KEY"
 Tabla histórica lista para consumir con la configuración usada y un bloque de filas. Exportación, análisis tabular, construcción propia de gráficos o pipelines de datos.
Volver arriba

Consulta múltiple de tickers

Ideal para watchlists, listados y bloques donde necesitas varios activos de golpe sin disparar muchas llamadas.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/tickers GET symbols opcional, por defecto AAPL,MSFT
apikey obligatorio		 
curl "https://api.elitelia.cloud/tickers?symbols=AAPL,MSFT,NVDA&apikey=TU_API_KEY"
 Objeto con una clave por ticker. Cada ticker incluye normalmente symbol, shortName, longName, currentPrice, historyPrice, marketCap, sector, industry, quoteType y currency. Watchlists, paneles comparativos, bloques de favoritos y listas de ideas.
Volver arriba

Búsqueda y resolución

Endpoints pensados para descubrir activos, autocompletado o flujos donde el usuario escribe un nombre en vez de un ticker.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/search GET q obligatorio
max_results opcional, por defecto 8
news_count opcional, por defecto 8
apikey obligatorio		 
curl "https://api.elitelia.cloud/search?q=tesla&max_results=5&news_count=3&apikey=TU_API_KEY"
 Bloques como quotes, news, lists, research y nav. Exploración general, buscador interno, discovery y combinaciones con noticias.
/resolve GET q obligatorio
max_results opcional, por defecto 8
apikey obligatorio		 
curl "https://api.elitelia.cloud/resolve?q=alphabet&apikey=TU_API_KEY"
 La mejor coincidencia en best_match y un bloque de resultados candidatos. Autocomplete, resolución de activo antes de llamar a otros endpoints o UX sin fricción.
Volver arriba

Mercado, sector e industria

Rutas para contexto macro, vistas sectoriales e información por industria que luego puedes usar para enriquecer análisis o filtros.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/market GET market opcional, por defecto us
apikey obligatorio		 
curl "https://api.elitelia.cloud/market?market=us&apikey=TU_API_KEY"
 Información general del mercado: estado, resumen, tiempo y zona horaria, según lo que devuelva Yahoo Finance para ese mercado. Dashboard general, contexto de sesión o bloques tipo “mercado abierto / cerrado”.
/sector GET key obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/sector?key=technology&apikey=TU_API_KEY"
 Nombre, símbolo, overview, top companies, top ETFs, top mutual funds e industrias del sector solicitado. Páginas sectoriales, filtros premium, research top-down o enriquecimiento de fichas.
/industry GET key obligatorio
apikey obligatorio		 
curl "https://api.elitelia.cloud/industry?key=software-infrastructure&apikey=TU_API_KEY"
 Nombre, sector asociado, overview y bloques como top performing companies o top growth companies. Análisis más vertical, páginas por industria o categorización de ideas.
Volver arriba

Screening

Endpoints orientados a encontrar ideas de inversión, ya sea a partir de screens ya definidos por Yahoo o combinando filtros más flexibles.

Endpoint Método Parámetros Ejemplo Qué devuelve Uso
/screen GET predefined obligatorio
size opcional, por defecto 25
offset opcional, por defecto 0
apikey obligatorio		 
curl "https://api.elitelia.cloud/screen?predefined=day_gainers&size=10&offset=0&apikey=TU_API_KEY"
 Resultado del screen predefinido ya pasado por limpieza para que sea más fácil de consumir. Listas rápidas de gainers, losers u otros screens ya preparados por Yahoo Finance.
/equity-screen GET Al menos uno de estos filtros: region, sector, exchange, peer_group
size opcional, por defecto 25
offset opcional, por defecto 0
apikey obligatorio		 
curl "https://api.elitelia.cloud/equity-screen?region=us&sector=technology&size=20&apikey=TU_API_KEY"
 Screen custom basado en filtros. Si no pasas ningún filtro válido, devuelve un error indicando que debe
Consejo práctico: para OCC y The Lounge, lo más útil suele ser combinar /metrics-ui para la ficha visual, /quote para la parte de mercado y /time_series para el gráfico. Para discovery o nuevas ideas, /screen y /equity-screen son los que más juego dan.
Volver arriba