GEXfocus API
Stream principal
Entrega NDF, precio, FEP, premium, umbrales, exposiciones agregadas y niveles estructurales en mensajes sucesivos.
Dashboard API Trading
Referencia tecnica y gestion de API key
Guia de uso para conectar GEXfocus Trading API. Mantiene la API key en el mismo contexto que la documentacion para facilitar implementacion, pruebas y mantenimiento.
API key
Clave actual
Validando API key...
Resumen operativo
Autenticacion, cobertura y formatos
Base URL, tickers permitidos y reglas de autenticacion. Estos datos aplican a los endpoints descritos abajo.
Base URL
https://apitrading.gexfocus.app
REST auth
Header x-api-key: TU_API_KEY.
WebSocket auth
Parametro key en la URL.
Tickers
qqq, spy, ndx, spx, aapl, msft, amzn, googl, meta, nvda, tsla.
Documentación PDF
Referencia técnica en PDF.
Referencia técnica en inglés con endpoints, payloads, límites y ejemplos.
Live stream
WebSocket NDF
Usa el stream para interfaces o procesos que necesitan granularidad real. Mantener la conexion abierta suele ser mejor que hacer polling REST.
Autenticacion o ticker invalido
Si la key no es valida, esta revocada o el ticker no pertenece a la cobertura, el servidor cierra la conexion con policy violation.
REST latest
Snapshots y mapas actuales
Todos los endpoints REST privados usan x-api-key. Los mapas por strike comparten una estructura consistente para facilitar heatmaps y tablas.
| Metodo | Endpoint | Uso | Notas |
|---|---|---|---|
| GET | /trading/greeks/last/{ticker} | Respuesta unificada con GEX, Delta, Vanna y Charm. | Permite repetir greeks: ?greeks=gex&greeks=delta. |
| GET | /trading/gex/last/{ticker} | Mapa Gamma Exposure por strike. | Incluye spot, net_exposure, max_strike y bars. |
| GET | /trading/delta/last/{ticker} | Mapa Delta Exposure por strike. | Util para cruzar DEX con NDF y premium. |
| GET | /trading/vanna/last/{ticker} | Mapa Vanna Exposure por strike. | Lectura complementaria para sensibilidad a volatilidad. |
| GET | /trading/charm/last/{ticker} | Mapa Charm Exposure por strike. | Seguimiento de decay direccional intradia. |
| GET | /trading/mapa_gamma/last/{ticker} | Matriz multi-expiracion. | Incluye expirations, strikes, matrix, vanna_matrix y charm_matrix. |
Historicos
Replay, investigacion y auditoria
Los historicos permiten reconstruir sesiones, alimentar notebooks o crear series temporales reducidas con every y summary.
| Metodo | Endpoint | Parametros | Uso recomendado |
|---|---|---|---|
| GET | /trading/history/ndf | ticker, date, limit, every | Serie intradia de NDF, precio, FEP, premium, DEX y umbrales. |
| GET | /trading/history/ndf/sessions | ticker | Lista sesiones disponibles para NDF. |
| GET | /trading/history/greeks/{greek} | ticker, date o start/end, limit, every, summary | Snapshots historicos de GEX, Delta, Vanna o Charm. |
| GET | /trading/history/greeks/{greek}/sessions | ticker | Sesiones disponibles por greek. |
Rangos y densidad
limit acepta hasta 20000 en NDF. every permite muestrear 1 de cada N registros. En historicos de greeks, los rangos con start/end tienen limite operativo de 5 dias; usa summary=true cuando no necesites barras por strike.
Payloads
Campos principales
La respuesta puede incluir valores null cuando un dato no esta disponible en ese snapshot. No lo interpretes automaticamente como cero.
Stream NDF
ticker, ts, ndf, price, fep, threshold_long, threshold_short, buy_premium, sell_premium, net_premium.
Premium 0DTE
net_call_premium_0dte, net_put_premium_0dte, call_buy_premium_0dte, call_sell_premium_0dte, put_buy_premium_0dte, put_sell_premium_0dte.
Exposiciones
gex_total, gex_calls, gex_puts, vanna_exposure, charm_exposure, delta_exposure.
Niveles
gamma_flip, max_gamma_strike, call_wall_gamma, put_wall_gamma.
Mapas por strike
Envelope: ticker, ts, ts_iso, session_date, spot, net_exposure, max_strike, bars.
Barra por strike
strike, calls, puts, total, gross. Esta estructura sirve para tablas, histogramas y heatmaps propios.
Ejemplos
Conexiones base
Reemplaza TU_API_KEY por tu clave activa. En produccion, maneja reconexion WS y timeouts REST.
Python WebSocket
import asyncio
import json
import websockets
API_KEY = "TU_API_KEY"
TICKER = "spy"
URL = f"wss://apitrading.gexfocus.app/trading/ws/ndf?key={API_KEY}&ticker={TICKER}"
async def main():
async with websockets.connect(URL) as ws:
async for msg in ws:
data = json.loads(msg)
print(data["ticker"], data["price"], data["ndf"], data.get("gex_total"))
asyncio.run(main())
Python REST
import requests
API_KEY = "TU_API_KEY"
BASE = "https://apitrading.gexfocus.app/trading"
resp = requests.get(
f"{BASE}/greeks/last/spx",
headers={"x-api-key": API_KEY},
timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(data["ticker"], data["gex"]["net_exposure"])
Historico NDF
curl "https://apitrading.gexfocus.app/trading/history/ndf?ticker=qqq&date=2026-05-19&limit=2000&every=1" \ -H "x-api-key: TU_API_KEY"
Serie liviana de GEX
curl "https://apitrading.gexfocus.app/trading/history/greeks/gex?ticker=spx&start=2026-05-18&end=2026-05-19&every=100&limit=20&summary=true" \ -H "x-api-key: TU_API_KEY"
Errores y operacion
Codigos esperados
La API esta pensada para integraciones tecnicas: maneja errores explicitamente, reintenta con backoff y separa WS live de REST historico.
| Codigo | Causa frecuente | Accion |
|---|---|---|
| 400 | Ticker, greek, fecha o parametro invalido. | Validar valores antes de llamar. |
| 401 | API key ausente, invalida o revocada. | Revisar header x-api-key o generar una key nueva. |
| 429 | Limite de uso alcanzado. | Reducir frecuencia o solicitar evaluacion de volumen. |
| 503 | Base de datos o proveedor temporalmente no disponible. | Reintentar con backoff. |
| WS 1008 | Autenticacion o ticker invalido. | Validar key y ticker antes de reconectar. |
Buenas practicas
Manten el WebSocket abierto para datos en vivo. Usa REST para snapshots, matrices e historicos. En dashboards avanzados puedes cruzar NDF con GEX, DEX, Vanna y Charm para construir heatmaps, indicadores y alertas propias.