Conecta Claude, ChatGPT o cualquier asistente compatible con MCP a tu cuenta de Tortuga Trades y pregúntale por tus operaciones, tu cartera, tus opciones, tus dividendos, tu diario o tu Watchlist, y por lo que comparte la comunidad. Solo lectura y sin claves que copiar.
18
herramientas, todas de solo lectura
OAuth
entras con tu cuenta de Tortuga, sin claves de API
60/min
y 2.000 consultas al día por usuario
30 días
de registro de cada consulta en tu panel
URL del servidorhttps://tortugatrades.app/mcp
Incluido en los planes de pago; la prueba gratuita no lo incluye. MCP sobre Streamable HTTP, con acceso OAuth 2.1.
MCP (Model Context Protocol) es el estándar abierto con el que Claude, ChatGPT y otros asistentes se conectan a servicios externos. El servidor MCP de Tortuga Trades pone tu cuenta a su alcance en 18 herramientas: tú preguntas con normalidad, la IA elige qué consultar, Tortuga le responde con tus datos y ella te lo explica.
Algunas preguntas que puedes hacerle:
«¿Cómo va mi cuenta este año?»«Enséñame las puts vendidas de este año.»«¿Qué estrategia me deja más dinero?»«¿Qué opciones me vencen pronto y cuánta theta cobro al día?»«¿Cuánto llevo cobrado en dividendos este año y qué me queda por cobrar?»«Resume lo que he escrito en mi diario desde junio.»
Funciona con cualquier plan de pago de Tortuga Trades. Ver planes.
Conexión y acceso
Sin claves: entras con tu cuenta
No hay claves de API que generar ni que guardar. Añades la URL del servidor en tu asistente y este te lleva a la pantalla de acceso de Tortuga: entras con tu cuenta, aceptas el permiso y listo. Tu IA recibe un permiso de solo lectura sobre tu cuenta, que se renueva solo y que puedes pausar cuando quieras desde Panel › IA › Actividad.
Para desarrolladores
Dato
Valor
URL del servidor
https://tortugatrades.app/mcp
Transporte
Streamable HTTP sin estado: cada petición es un POST con JSON-RPC 2.0 (GET responde 405).
Autorización
OAuth 2.1 con PKCE (S256). El token viaja en la cabecera Authorization: Bearer.
Pulsa «Conectar», entra con tu cuenta de Tortuga y acepta el permiso.
En un chat, activa «Tortuga Trades» en el menú de herramientas. Lo añades una vez y te sirve en la web, en la app de escritorio y en el móvil.
ChatGPT
Plus o superior
En chatgpt.com, abre Ajustes › Plugins (antes «Conectores») › Avanzado y activa el modo desarrollador.
Crea un conector con la URL https://tortugatrades.app/mcp y autenticación OAuth.
Entra con tu cuenta de Tortuga y acepta. Después funciona también en la app de escritorio y en el móvil.
Gemini
Por ahora, solo en EE. UU. y en inglés
En gemini.google.com, abre Settings › Connected Apps (o Personal Intelligence › Connected Apps) y, en «Custom apps», añade una app con la URL de arriba.
Entra con tu cuenta de Tortuga y acepta. Después funciona también en la app móvil de Gemini.
Google lo limita de momento a mayores de 18 años en EE. UU., con cuenta personal de Google, la actividad de Gemini activada y la app en inglés.
Claude Code
Terminal
Añade el servidor desde tu terminal con el comando de abajo.
Abre claude, escribe /mcp, elige «tortuga» y entra con tu cuenta de Tortuga.
Terminal
claude mcp add --transport http tortuga https://tortugatrades.app/mcp
Gemini CLI
Terminal
Añade el servidor desde tu terminal con el comando de abajo.
Abre gemini, escribe /mcp auth tortuga y entra con tu cuenta de Tortuga en el navegador que se abre.
Terminal
gemini mcp add --transport http --scope user tortuga https://tortugatrades.app/mcp
Cursor
~/.cursor/mcp.json
Pulsa «Añadir a Cursor» o pega el bloque en ~/.cursor/mcp.json (o en .cursor/mcp.json, solo para un proyecto).
Cursor te pedirá entrar con tu cuenta de Tortuga la primera vez que use una herramienta.
¿Usas otro asistente? Sirve cualquiera que admita servidores MCP remotos con OAuth: dale la URL del servidor y te llevará a la pantalla de acceso de Tortuga.
Privacidad y control
Tu IA lee; no toca nada
Solo lectura. Ninguna herramienta escribe, borra ni opera: tu IA puede leer tu cuenta, nunca cambiarla.
Tus datos y lo público, nada más. Tu IA ve tu cuenta y, de la comunidad, solo lo que tú ya ves en la web: las operaciones públicas de los demás traders (todas a la vez o perfil a perfil), las que comparten en el feed y el screener, con las mismas reglas (plan de pago, tu copy trade activo, bloqueos). Nunca datos privados de otros usuarios.
Como en la web. Tus ediciones manuales cuentan, y las operaciones que ocultaste no entran en resúmenes ni estadísticas.
Registro de actividad. Cada consulta queda 30 días en Panel › IA › Actividad: herramienta, argumentos, duración y resultado.
Pausa cuando quieras. En esa misma pantalla cortas el acceso de todas tus IAs en menos de un minuto, y lo reactivas igual.
Tu proveedor de IA. Las respuestas de las herramientas llegan a tu asistente (Anthropic, OpenAI…) para que te conteste; lo que haga con ellas depende de sus condiciones. Más en la política de privacidad.
Información, no asesoramiento. Lo que te diga tu IA no es asesoramiento de inversión.
Límites de uso
Límites por usuario
Límite
Valor
Consultas por minuto
60
Consultas al día
2.000
Tamaño de las listas
Cada página de list_trades y get_journal cabe en 40 KB; si get_trade_stats tiene más grupos de los que caben, se queda con los de más peso y lo indica con truncated.
Filas por página
50 por defecto y 200 como máximo (list_trades y get_journal).
Calendario por días
Hasta 366 días por consulta; para más, por semanas o meses.
Gráficos
Hasta 500 velas y 5 indicadores por consulta de get_chart (menos si no caben en 40 KB: se queda con las más recientes y lo indica con truncated).
Watchlist, comunidad y radar
Hasta 100 símbolos por página en get_watchlists, 100 operaciones en list_community_trades, 500 ejecuciones por página y ventanas de hasta 31 días en list_public_operations, 100 filas por lista en get_community_screener, 100 valores en get_market_radar y 50 filas por página en get_super_investors.
Tiempo por consulta
Unos 20 s; si se pasa, tu IA recibe un aviso para acotar el rango.
Si te pasas, la consulta no se hace y tu IA recibe un aviso con los segundos que faltan de verdad (código rate_limited en la tabla de errores).
Errores
Errores que tu IA sabe explicar
En MCP, el error de una herramienta no es un código HTTP: llega como un resultado normal marcado con isError y con un texto pensado para que tu IA te lo cuente tal cual. Cada uno queda en tu registro de Actividad con su código.
Código
Cuándo
Texto que recibe tu IA
beta
La conexión está en beta privada y tu cuenta aún no está dentro.
La conexión con IA de Tortuga Trades está en beta privada y todavía no está disponible para tu cuenta.
paid_only
Tu plan no es de pago: la prueba gratuita no incluye la conexión con IA.
Tu plan de Tortuga Trades no incluye la conexión con IA: está en los planes de pago. Suscríbete en https://tortugatrades.app/subscribe
paused
Has pausado el acceso de las IAs desde Panel › IA › Actividad.
Has pausado el acceso de las IAs a tu cuenta de Tortuga Trades. Reactívalo en https://tortugatrades.app/ai-insights?tab=actividad
rate_limited
Más de 60 consultas en un minuto o 2.000 en un día. El número de segundos es el que falta de verdad.
Has hecho muchas consultas seguidas. Espera 30 s y vuelve a intentarlo.
unknown_account
El número de cuenta no existe en tu Tortuga.
Esa cuenta no existe en tu Tortuga Trades. Consulta tus cuentas con get_context.
bad_input
Un argumento que la IA puede corregir sola: fechas al revés, una estrategia o un id que no existen, un rango demasiado largo…
«from» no puede ser posterior a «to».
timeout
La consulta tarda demasiado, casi siempre por un rango de fechas muy largo.
Tortuga Trades ha tardado demasiado en responder. Prueba con un rango de fechas más corto o vuelve a intentarlo.
backend_error
Tortuga no ha podido responder.
Tortuga Trades no responde ahora mismo. Inténtalo de nuevo en un minuto.
Resultado con error
{
"jsonrpc":"2.0",
"id":7,
"result": {
"content": [
{
"type":"text",
"text":"Has pausado el acceso de las IAs a tu cuenta de Tortuga Trades. Reactívalo en https://tortugatrades.app/ai-insights?tab=actividad"
}
],
"isError":true
}
}
Solo dos respuestas usan códigos HTTP: 401 cuando falta el acceso o ha caducado (tu asistente te pedirá entrar de nuevo) y 503 si el servicio está desactivado temporalmente.
Paginación
Listas por páginas
list_trades y get_journal devuelven como mucho limit filas. La respuesta dice cuántas hay en total (total), cuántas trae (returned) y, si quedan más, el cursor de la página siguiente (next_cursor, null en la última). truncated vale true si la página se cortó antes por tamaño.
Fechas. «Hoy» es el día en Europe/Madrid; las fechas van como AAAA-MM-DD y los instantes en ISO 8601, en UTC.
Divisas. Los importes van en la divisa base de la cuenta (currency): P&L, valor, caja y dividendos. El precio y la comisión de cada operación, en la divisa del instrumento (price_currency).
Rentabilidad. La calcula Tortuga con los datos de tu bróker y siempre viaja con su periodo (from y to): solo es «YTD» si empieza el 1 de enero.
Frescura. Los datos son los de tu última sincronización o importación, los mismos que ves en la web; get_context dice cuándo fue (last_sync).
Varias cuentas. Hasta 20 por usuario: account = 1 es la principal y get_context las lista todas.
Estrategias. Son las etiquetas del identificador de Tortuga (Short Put, Iron Condor, Bull Put Spread…) y aceptan alias en castellano, como «put vendida».
Formato. Cada respuesta llega a tu IA como texto JSON (content) y como structuredContent.
Referencia rápida
"today": "2026-09-25" // hoy, en Europe/Madrid
"date": "2026-07-10" // día de la operación
"last_sync": "2026-09-25T06:14:00.000Z" // instante, en UTC
"currency": "EUR" // divisa base: pnl, value, cash…
"price_currency": "USD" // divisa del instrumento: price, commission
"returns": { "from": "2026-01-01", "to": "2026-09-24", "is_ytd": true }
Herramientas
Las 18 herramientas
Esta tabla sale del registro del propio servidor: es exactamente lo que ve un asistente conectado. Todas son de solo lectura. Las respuestas de ejemplo de cada ficha las genera el código real del servidor sobre una cuenta inventada.
«¿Qué tiene Berkshire Hathaway en cartera y qué ha comprado o vendido el último trimestre?»
investorsymbolstatslimitoffset
* obligatorio. Las consultas cuentan para los límites por minuto y por día.
get
Mi cuenta en Tortuga
solo lectura
get_context
Llámala primero. Devuelve la fecha de hoy (Europe/Madrid) y las cuentas del usuario en Tortuga Trades: número, nombre, divisa base, última sincronización con el bróker, periodo con datos de rentabilidad y rango de fechas con operaciones. Úsala para saber qué cuenta consultar.
Argumentos
No lleva argumentos.
Tú preguntas
«¿Qué cuentas tengo en Tortuga y hasta qué fecha tengo datos?»
Resumen de una cuenta: patrimonio neto (NLV), caja, invertido, rentabilidad TWR con su periodo real y estadísticas de operaciones cerradas (número, % de acierto, P&L realizado, profit factor, media ganadora y perdedora, esperanza). Importes en la divisa base.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
Lista las ejecuciones de una cuenta con filtros (fechas, ticker, estrategia de Tortuga, tipo de instrumento, apertura/cierre, ganadoras/perdedoras) y paginación. Cada fila lleva su estrategia según el identificador de Tortuga y, en las recompras de opciones vendidas, el % de prima capturada (pct_premium_captured), como la tabla de Trades. P&L en divisa base; precio y comisión en la divisa del instrumento (price_currency).
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
from
fecha
Desde (incluido), AAAA-MM-DD.
to
fecha
Hasta (incluido), AAAA-MM-DD.
symbol
texto
Ticker o subyacente, p. ej. AAPL o SPY.
strategy
texto
Estrategia tal como la etiqueta Tortuga: «Iron Condor», «Short Put», «Bull Put Spread»… (acepta minúsculas y alias en castellano).
type
opción
Tipo de instrumento.Valores: stock, etf, fund, option, future, fx, other.
status
opción
closed = ejecución que cierra (tiene P&L realizado); open = ejecución de apertura.Valores: open, closed.
outcome
opción
win = P&L > 0; loss = P&L < 0.Valores: win, loss.
sort
opción
Orden: date_desc (más recientes primero), date_asc, pnl_desc (mayor P&L primero) o pnl_asc.Valores: date_desc, date_asc, pnl_desc, pnl_asc. Por defecto: "date_desc".
limit
entero
Filas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursor
texto
El next_cursor de la respuesta anterior, para pedir la página siguiente.
Más preguntas que la usan
«¿Cuáles han sido mis cinco peores operaciones?»«¿Qué compré en marzo?»
Listas recortadas a 3 elementos para leerlo mejor.
get
Detalle de operación
solo lectura
get_trade
Detalle de una ejecución por su id (campo id de list_trades): patas, estrategia, importe de la ejecución y % de prima capturada (pct_premium_captured, la cifra de la tabla de Trades; solo opciones vendidas), y la nota del diario si existe.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
idobligatorio
texto
El id de la fila en list_trades.
Tú preguntas
«¿Cuánta prima capturé con la put de KO que recompré en julio, y qué anoté en el diario?»
{
"account":1,
"accounts_available": [
1,
2
],
"currency":"EUR",
"strategy":"Short Put",
"combo_id":null,
"pct_premium_captured":87.27,
"trade": {
"symbol":"KO 260717P00068000",
"underlying":"KO",
"instrument":"option",
"right":"P",
"strike":68,
"expiry":"2026-07-17",
"dte":7,
"qty":1,
"signedQty":1,
"price":0.14,
"commission":-0.65,
"currency":"USD",
"currencyVouched":true,
"pnl":80.78,
"fxRateToBase":0.853,
"isClosed":true,
"openDate":"2026-07-10",
"closeDate":null,
"chartLegs": [
{
"right":"P",
"strike":68,
"expiry":"2026-07-17",
"qty":1
}
],
"strategyLabel":null,
"actionLabel":null,
"pctPremium":87.27,
"unrealizedPnl":null,
"displayName":null,
"typeColor":null,
"strategyColor":null,
"actionColor":null,
"groupKey":null,
"isNetClosed":false,
"positionMode":false,
"greeks":null,
"replay":null,
"premiumBase":11.94
},
"hidden":false,
"journal": {
"notes":"Recomprada con el 87 % de la prima capturada: quedaban 7 días y no compensaba el riesgo por lo poco que faltaba.",
"tags": [
"Rentas"
],
"mindset":"Feliz",
"rating":5,
"scores": {
"Calidad de ejecución":5
}
},
"warnings": []
}
get
Estadísticas por estrategia
solo lectura
get_trade_stats
Estadísticas agrupadas por estrategia, ticker, mes, día de la semana o tipo de instrumento: operaciones, ganadoras, perdedoras, % de acierto, P&L, media ganadora y perdedora, esperanza y profit factor. Una operación de varias patas cuenta una vez, como en Trades › Estrategias. No cuenta las operaciones ocultas.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
group_by
opción
Agrupar por strategy (estrategia de Tortuga), symbol (ticker), month (AAAA-MM), weekday (día de la semana) o type (tipo de instrumento).Valores: strategy, symbol, month, weekday, type. Por defecto: "strategy".
from
fecha
Desde (incluido), AAAA-MM-DD.
to
fecha
Hasta (incluido), AAAA-MM-DD.
symbol
texto
Ticker o subyacente, p. ej. AAPL o SPY.
strategy
texto
Estrategia tal como la etiqueta Tortuga: «Iron Condor», «Short Put», «Bull Put Spread»… (acepta minúsculas y alias en castellano).
type
opción
Tipo de instrumento.Valores: stock, etf, fund, option, future, fx, other.
Más preguntas que la usan
«¿Qué día de la semana opero peor?»«¿Cuál es mi porcentaje de acierto por ticker?»
{
"account":1,
"accounts_available": [
1,
2
],
"currency":"EUR",
"group_by":"strategy",
"totals": {
"operations":10,
"winners":3,
"losers":1,
"win_rate_pct":75,
"pnl":390.16,
"avg_win":182.66,
"avg_loss":-157.81,
"expectancy":39.02,
"profit_factor":3.47
},
"groups_total":2,
"truncated":false,
"groups": [
{
"key":"Long",
"operations":5,
"winners":1,
"losers":1,
"win_rate_pct":50,
"pnl":270.4,
"avg_win":428.21,
"avg_loss":-157.81,
"expectancy":54.08,
"profit_factor":2.71
},
{
"key":"Short Put",
"operations":5,
"winners":2,
"losers":0,
"win_rate_pct":100,
"pnl":119.76,
"avg_win":59.88,
"avg_loss":null,
"expectancy":23.95,
"profit_factor":null
}
],
"note":"Una operación de varias patas cuenta una vez. Las operaciones ocultas en la web no cuentan.",
"warnings": []
}
get
Calendario de P&L
solo lectura
get_pnl_calendar
P&L realizado de operaciones por día, semana, mes o año en un rango de fechas (por día, como mucho 366 días). No incluye dividendos ni intereses: están en get_dividends.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
granularity
opción
Una fila por day, week (de lunes a domingo; la fila lleva la fecha del lunes), month o year.Valores: day, week, month, year. Por defecto: "day".
{
"account":1,
"accounts_available": [
1,
2
],
"currency":"EUR",
"granularity":"month",
"from":"2026-01-01",
"to":"2026-09-30",
"periods": [
{
"period":"2026-06",
"pnl":428.21,
"trades":1
},
{
"period":"2026-07",
"pnl":80.78,
"trades":1
},
{
"period":"2026-08",
"pnl":-118.83,
"trades":2
}
],
"totals": {
"pnl":390.16,
"trades":4
},
"note":"P&L realizado de operaciones (las estrategias de varias patas cuentan el día en que se cierran). No incluye dividendos ni intereses: el Calendario de la web los suma si su casilla «Dividendos» está marcada (lo está por defecto); para compararlo, súmale get_dividends.",
"warnings": []
}
get
Cartera
solo lectura
get_portfolio
Posiciones abiertas según el último extracto del bróker (acciones, ETFs, opciones y otros) con coste, valor, P&L latente y peso; caja por divisa; P&L realizado por clase. Importes en divisa base salvo los precios, que van en la divisa del instrumento.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
class
opción
Qué posiciones: all, stock, etf, option, other o cash (solo la caja).Valores: all, stock, etf, option, other, cash. Por defecto: "all".
Más preguntas que la usan
«¿Cuánta caja tengo y en qué divisas?»
Tú preguntas
«¿Qué posiciones tengo abiertas y cuánto pesa cada una?»
{
"account":1,
"accounts_available": [
1,
2
],
"currency":"EUR",
"as_of":"2026-09-24",
"total_value":6504.57,
"positions": [
{
"symbol":"VWCE",
"name":"VANGUARD FTSE ALL-WORLD ACC",
"kind":"etf",
"strategy":null,
"side":"Long",
"qty":25,
"value":3490.5,
"unrealized_pnl":527.5,
"cost_basis":2963,
"avg_cost_native":118.52,
"mark_price_native":139.62,
"native_currency":"EUR",
"weight_pct":29.92,
"detail":null
},
{
"symbol":"KO",
"name":"COCA-COLA CO/THE",
"kind":"stock",
"strategy":null,
"side":"Long",
"qty":50,
"value":2979.1,
"unrealized_pnl":466.16,
"cost_basis":2512.94,
"avg_cost_native":58.92,
"mark_price_native":69.85,
"native_currency":"USD",
"weight_pct":25.54,
"detail":null
},
{
"symbol":"PFE 261120P00024000",
"name":"PFE 20NOV26 24 P",
"kind":"option",
"strategy":"Short Put",
"side":"Short",
"qty":1,
"value":34.97,
"unrealized_pnl":17.36,
"cost_basis":-52.33,
"avg_cost_native":0.6135,
"mark_price_native":0.41,
"native_currency":"USD",
"weight_pct":-0.3,
"detail":"24P · 20/11/26"
}
],
"cash": [
{
"currency":"EUR",
"amount":4180.22,
"amount_base":4180.22
},
{
"currency":"USD",
"amount":1232.4,
"amount_base":1051.24
}
],
"cash_total":5231.46,
"realized_by_class": {
"all":390.16,
"options":119.76,
"stocks":270.4,
"etfs":0
},
"options_summary": {
"positions":1,
"putsCommitted":2047.2,
"callsCommitted":0
},
"note":"Posiciones del último extracto del bróker (fecha en as_of). Los fondos de inversión dados de alta a mano (Cartera › Fondos) aún no se incluyen: sus operaciones salen en list_trades con type=fund.",
"warnings": []
}
get
Opciones abiertas
solo lectura
get_options
Opciones abiertas: estrategias detectadas por vencimiento, vencimientos próximos con su capital comprometido, capital comprometido por mes de vencimiento, griegas estimadas de cada pata abierta (delta, gamma y theta diaria en divisa base) y el análisis de opciones del año (% de acierto, captura de prima, resultado por estrategia).
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
Más preguntas que la usan
«¿Qué porcentaje de la prima llevo capturado?»
Tú preguntas
«¿Qué opciones me vencen pronto y cuánta theta cobro al día?»
{
"account":1,
"accounts_available": [
1,
2
],
"currency":"EUR",
"today":"2026-09-25",
"strategies": [],
"expirations": [
{
"date":"2026-11-20",
"dte":56,
"positions": [
{
"symbol":"PFE",
"detail":"1× 24P",
"side":"Short",
"qty":1,
"strike":24,
"right":"P",
"riskBase":2047.2
}
],
"riskBase":2047.2
}
],
"risk_by_expiry_month": [
{
"ym":"2026-11",
"contracts":1,
"riskBase":2047.2
}
],
"greeks": {
"legs": [
{
"symbol":"PFE 24P 20/11/26",
"underlying":"PFE",
"side":"SELL",
"contracts":1,
"expiry":"2026-11-20",
"strike":24,
"right":"P",
"strategy":"Short Put",
"pct_premium_captured":33.87,
"unrealized_native":21,
"price_currency":"USD",
"delta":0.227,
"gamma":-0.1021,
"theta_per_contract_base":0.61
}
],
"theta_per_day_total":0.61,
"note":"Griegas estimadas (Black-Scholes, misma librería que la web) con la IV del mercado; si falta un precio o la IV, salen null."
},
"year_analysis": {
"year":2026,
"kpis": {
"pnlBase":119.76,
"ops":2,
"winRatePct":100,
"avgCapturePct":86.4,
"avgPremiumCapturedBase":60.99,
"medianCloseDte":7
},
"by_strategy": [
{
"label":"Short Put",
"color":"#14B8A6",
"ops":2,
"pnlBase":119.76,
"avgPnlBase":59.88,
"avgCapturePct":86.4,
"sharePct":100
}
]
},
"warnings": []
}
get
Dividendos e intereses
solo lectura
get_dividends
Dividendos e intereses de un año: cobros por mes y por empresa (importes brutos en divisa base), intereses cobrados y pagados, próximos cobros previstos y estimación del resto del año.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
year
entero
Año; por defecto, el actual.De 2.000 a 2.100.
Tú preguntas
«¿Cuánto llevo cobrado en dividendos este año y qué me queda por cobrar?»
{
"year":2026,
"ccy":"EUR",
"total":49.64,
"interestTotal":21.49,
"projTotal":45.2,
"months": [
{
"m":1,
"total":0,
"projected":0,
"interest":0
},
{
"m":2,
"total":0,
"projected":0,
"interest":0
},
{
"m":3,
"total":0,
"projected":0,
"interest":0
}
],
"interest": [
{
"ccy":"EUR",
"received":21.49,
"paid":0,
"net":21.49
}
],
"payers": [
{
"symbol":"KO",
"total":45.2,
"count":2,
"avg":22.6,
"monthsActive":2,
"lastDate":"2026-07-01",
"nextPay":"2026-10-01"
},
{
"symbol":"AAPL",
"total":4.44,
"count":1,
"avg":4.44,
"monthsActive":1,
"lastDate":"2026-05-14",
"nextPay":null
}
],
"upcoming": [
{
"symbol":"KO",
"date":"2026-10-01",
"amount":22.6
},
{
"symbol":"KO",
"date":"2026-12-01",
"amount":22.6
}
],
"calendar": {
"actual": [
{
"d":"2026-04-01",
"total":22.6
},
{
"d":"2026-05-14",
"total":4.44
},
{
"d":"2026-07-01",
"total":22.6
}
],
"projected": [
{
"d":"2026-10-01",
"symbol":"KO",
"amount":22.6
},
{
"d":"2026-12-01",
"symbol":"KO",
"amount":22.6
}
]
},
"availableYears": [
2025,
2026
],
"account":1,
"accounts_available": [
1,
2
],
"note":"Importes en la divisa base al cambio de cada cobro. Los anunciados traen la fecha pero no siempre el importe; la estimación del resto del año usa los pagos del año anterior escalados a las acciones que tienes hoy."
}
Listas recortadas a 3 elementos para leerlo mejor.
get
Diario
solo lectura
get_journal
El diario de trading del usuario, en cuatro vistas (view): entries = entradas por pata (notas, etiquetas, mindset, valoración y puntuaciones); operations = operaciones con su revisión (notas en texto plano, etiquetas con polaridad error/buena práctica/neutra, emoción antes y después, disciplina, playbook con casillas y % de cumplimiento, P&L realizado en divisa base); days = notas diarias y semanales, resultado del día y operaciones no ejecutadas (no suman); overview = resumen del periodo con las cifras de Trades › Journal (revisadas, errores y su coste, resultado por etiqueta, polaridad, emoción y playbook) y el progreso de las metas del mes. Filtrable por fechas o por operación (trade_id = id de list_trades).
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
from
fecha
Desde (incluido), AAAA-MM-DD.
to
fecha
Hasta (incluido), AAAA-MM-DD.
view
opción
entries (por pata, por defecto), operations (operaciones revisadas), days (notas de día/semana y no ejecutadas) u overview (resumen del periodo, playbooks y metas).Valores: entries, operations, days, overview. Por defecto: "entries".
trade_id
texto
El id de una fila de list_trades: devuelve solo la entrada del diario de esa operación.
limit
entero
Filas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursor
texto
El next_cursor de la respuesta anterior, para pedir la página siguiente.
Más preguntas que la usan
«¿Qué errores me repito según mis notas?»«¿Cuánto me han costado mis errores este mes y cumplo mis playbooks? (view=overview)»
Tú preguntas
«Resume lo que he escrito en mi diario desde junio.»
{
"account":1,
"accounts_available": [
1,
2
],
"total":4,
"returned":4,
"next_cursor":null,
"truncated":false,
"entries": [
{
"key":"PFE 261120P00024000__2026-09-08__SELL",
"symbol":"PFE 261120P00024000",
"date":"2026-09-08",
"action":"SELL",
"notes":"Put a 73 días, delta 0,25, por debajo del soporte de agosto. Si me asignan, empiezo la rueda con PFE.",
"tags": [
"Rueda"
],
"mindset":"Neutral",
"rating":null,
"scores": {}
},
{
"key":"MSFT__2026-08-05__SELL",
"symbol":"MSFT",
"date":"2026-08-05",
"action":"SELL",
"notes":"Vendí tarde: el stop mental estaba en 480 y lo moví dos veces.",
"tags": [
"Salida tardía"
],
"mindset":"Ansioso",
"rating":2,
"scores": {
"Disciplina":2
}
},
{
"key":"KO 260717P00068000__2026-07-10__BUY",
"symbol":"KO 260717P00068000",
"date":"2026-07-10",
"action":"BUY",
"notes":"Recomprada con el 87 % de la prima capturada: quedaban 7 días y no compensaba el riesgo por lo poco que faltaba.",
"tags": [
"Rentas"
],
"mindset":"Feliz",
"rating":5,
"scores": {
"Calidad de ejecución":5
}
}
]
}
Listas recortadas a 3 elementos para leerlo mejor.
get
Watchlist
solo lectura
get_watchlists
Las listas de la sección Watchlist del usuario: Cartera (sus posiciones abiertas, derivadas del último extracto del bróker), Favoritos (la estrella), Comunidad (operaciones del feed marcadas con estrella), Radar (los valores con estrella del Market Radar) y sus listas propias. Devuelve todas las listas con su número de símbolos y, de UNA lista (por defecto la activa en la web), sus símbolos con la cotización actual (precio, cambio del día, cierre anterior y frescura: live/delayed/closed; `stale: true` si el proveedor está limitando y el precio es el último conocido, sin actualizar). En Cartera, cada fila lleva además la posición (cantidad, entrada y P&L latente del extracto). Si la lista tiene secciones (las del usuario o, en Cartera, Acciones/ETF/Opciones/Futuros/Cripto), devuelve sus nombres en orden y la sección de cada símbolo. Las claves con pista de plaza («REP:EUR») son las que acepta get_chart.
Argumentos
Argumento
Tipo
Descripción
account
entero
Número de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
list
texto
Id o nombre de la lista (sin distinguir mayúsculas), o portfolio / favorites / community / radar. Por defecto, la lista activa en la web.
quotes
sí / no
Incluir la cotización actual de cada símbolo de la lista elegida.Por defecto: true.
limit
entero
Símbolos por página (máx. 100).Por defecto: 50. De 1 a 100.
cursor
texto
El next_cursor de la respuesta anterior, para pedir la página siguiente.
Más preguntas que la usan
«¿Qué listas tengo en la Watchlist?»«¿Cuál de mis posiciones sube más hoy?»
Tú preguntas
«¿Cómo van hoy los valores de mi lista de favoritos?»
{
"account":1,
"accounts_available": [
1,
2
],
"active_list_id":"l1",
"lists": [
{
"id":"_portfolio",
"kind":"portfolio",
"name":"Cartera",
"count":0
},
{
"id":"_favorites",
"kind":"favorites",
"name":"Favoritos",
"count":2
},
{
"id":"l1",
"kind":"user",
"name":"Dividendos",
"count":2
}
],
"list": {
"id":"_favorites",
"kind":"favorites",
"name":"Favoritos",
"total":2,
"returned":2,
"next_cursor":null,
"symbols": [
{
"symbol":"AAPL",
"name":"Apple",
"quote": {
"price":227.52,
"change_pct":1.43,
"prev_close":224.31,
"state":"delayed",
"time":"2025-09-25T15:50:00.000Z",
"age_sec":900,
"delay_min":15
}
},
{
"symbol":"SPY",
"name":null,
"quote": {
"price":658.1,
"change_pct":-0.2,
"prev_close":659.4,
"state":"delayed",
"time":"2025-09-25T15:50:00.000Z",
"age_sec":900,
"delay_min":15
}
}
]
},
"is_default_list":false,
"note":"Cotizaciones en la unidad de /quotes (Londres en libras); las de la Watchlist con pista de plaza («REP:EUR») se cotizan en su plaza. Cartera sale del último extracto del bróker y de tus posiciones manuales, sin el PMC virtual de Subyacentes. Los dibujos e indicadores guardados del gráfico viven solo en tu navegador.",
"warnings": []
}
get
Gráfico
solo lectura
get_chart
Velas OHLCV de un símbolo, las mismas que pinta el gráfico de la Watchlist (misma resolución de plaza y divisa, mismas cachés): temporalidades 1m, 5m, 15m, 30m, 1h, 4h, D, W y M, las más recientes primero recortadas a limit. Opcionalmente calcula los indicadores del gráfico de Tortuga (SMA, EMA, WMA, Bollinger, VWAP, Donchian, Keltner, media de volumen, RSI, MACD, estocástico, ATR, CCI, Williams %R, ROC, OBV, MFI) con sus fórmulas y valores por defecto. Precios en la unidad de Yahoo (Londres en peniques, GBp). Los dibujos y plantillas del gráfico se guardan solo en el navegador del usuario: no están disponibles.
Argumentos
Argumento
Tipo
Descripción
symbolobligatorio
texto
Ticker de Yahoo o clave de la Watchlist con pista de plaza: AAPL, ^GSPC, BTC-USD, REP:EUR.
interval
opción
Temporalidad: 1m, 5m, 15m, 30m, 1h, 4h, D (diario), W (semanal) o M (mensual).Valores: 1m, 5m, 15m, 30m, 1h, 4h, D, W, M. Por defecto: "D".
limit
entero
Velas a devolver, las más recientes (máx. 500).Por defecto: 100. De 1 a 500.
indicators
array
Indicadores a calcular (máx. 5); sin parámetros, los valores por defecto del gráfico.Por defecto: [].
Más preguntas que la usan
«Dame las últimas 50 velas horarias de SPY con la SMA 20.»«¿Está Repsol por encima de su media de 200 sesiones?»
{
"symbol":"AAPL",
"ccy":null,
"interval":"D",
"intraday":false,
"stale":false,
"saved_layout":null,
"note":"Precios en la unidad de Yahoo (Londres en peniques). Los dibujos y plantillas del gráfico se guardan solo en el navegador del usuario.",
"bars_available":43,
"returned":5,
"truncated":false,
"bars": [
{
"time":"2026-08-24",
"open":216.2,
"high":217.4,
"low":213.87,
"close":214.97,
"volume":53500000
},
{
"time":"2026-08-25",
"open":214.97,
"high":216.17,
"low":213.18,
"close":214.28,
"volume":53750000
},
{
"time":"2026-08-26",
"open":214.28,
"high":215.48,
"low":213.15,
"close":214.25,
"volume":54000000
}
],
"indicators": [
{
"type":"rsi",
"params": {
"period":14
},
"series": {
"rsi": [
{
"time":"2026-08-24",
"value":55.95426
},
{
"time":"2026-08-25",
"value":53.866653
},
{
"time":"2026-08-26",
"value":53.772717
}
]
}
},
{
"type":"sma",
"params": {
"period":20
},
"series": {
"ma": [
{
"time":"2026-08-24",
"value":214.8545
},
{
"time":"2026-08-25",
"value":214.8245
},
{
"time":"2026-08-26",
"value":214.766
}
]
}
}
]
}
Listas recortadas a 3 elementos para leerlo mejor.
list
Operaciones públicas de la comunidad
solo lectura
list_public_operations
TODAS las operaciones públicas de los traders de la comunidad de Tortuga Trades en UNA llamada (no hace falta ir trader a trader): las ejecuciones que enseña la actividad de cada perfil del Ranking, de todos los traders con perfil público y copy trade activo a la vez, de un día (date: hoy/ayer/AAAA-MM-DD) o de un rango de hasta 31 días. Úsala para cualquier pregunta sobre lo que han operado o publicado los usuarios de Tortuga («¿qué opciones abrió ayer la comunidad?», «¿qué operaciones tienen mejor riesgo/beneficio?»). Filtros: tipo (opciones/acciones), subyacente, estrategia de Tortuga, apertura/cierre y traders. Agrupado por trader con su divisa: símbolo, strike, vencimiento, compra/venta, cantidad, precio, P&L realizado y delta sellada, más un resumen por subyacente, estrategia y trader. view=structures junta las aperturas en estrategias con sus patas, crédito o débito y pérdida máxima al vencimiento, para comparar riesgo/beneficio. Solo planes de pago y solo si el usuario tiene SU copy trade activo: si lo tiene apagado llega vacía con viewer_copy_trade_off=true, como en la web.
Argumentos
Argumento
Tipo
Descripción
date
texto
Un solo día: today, yesterday (Europe/Madrid) o AAAA-MM-DD. Alternativa a from/to.
from
fecha
Desde (incluido), AAAA-MM-DD. Ventana de como mucho 31 días; sin date ni from, los últimos 7 días.
to
fecha
Hasta (incluido), AAAA-MM-DD. Por defecto, el mismo día que from (o hoy).
kind
opción
all, options (solo opciones) o stock (acciones y demás instrumentos sin opción).Valores: all, options, stock. Por defecto: "all".
underlying
texto
Subyacente, p. ej. SPY o AAPL.
strategy
texto
Estrategia (o varias separadas por coma) tal como la etiqueta Tortuga: «Short Put», «Bull Put Spread», «Iron Condor»… (acepta alias en castellano). Un cierre casa si su trader abrió esa estrategia sobre el mismo subyacente en la ventana.
side
opción
open = ejecuciones de apertura; close = cierres (con P&L realizado).Valores: open, close.
traders
array
Limita a estos traders (nombre de usuario, sin @).
view
opción
executions (cada ejecución) o structures (aperturas agrupadas en estrategias con patas, crédito/débito y pérdida máxima: la vista para comparar riesgo/beneficio).Valores: executions, structures. Por defecto: "executions".
limit
entero
Ejecuciones por página (máx. 500); la respuesta se recorta además a ~40 KB y deja next_cursor.Por defecto: 200. De 1 a 500.
cursor
texto
El next_cursor de la respuesta anterior (con los MISMOS filtros), para pedir la página siguiente.
Más preguntas que la usan
«¿Qué ha operado la comunidad hoy sobre SPY?»«¿Qué puts vendidas abrieron los traders esta semana y a qué strikes?»
Tú preguntas
«¿Qué operaciones con opciones de las publicadas ayer por los usuarios de Tortuga tienen mejor R:R?»
{
"window": {
"from":"2026-09-24",
"to":"2026-09-24"
},
"filters": {
"kind":"options",
"side":"open"
},
"view":"structures",
"viewer_copy_trade_off":false,
"matched":3,
"returned":2,
"next_cursor":null,
"summary": {
"executions":3,
"opens":3,
"closes":0,
"open_structures":2,
"traders":2,
"by_underlying": [
{
"key":"SPY",
"count":2
},
{
"key":"KO",
"count":1
}
],
"by_strategy": [
{
"key":"Bull Put Spread",
"count":1
},
{
"key":"Short Put",
"count":1
}
],
"by_trader": [
{
"key":"tortuga_demo",
"count":2
},
{
"key":"otro_trader",
"count":1
}
]
},
"traders": [
{
"username":"tortuga_demo",
"display_name":"Tortuga Demo",
"currency":"EUR",
"structures": [
{
"id":"a1b2c3d4e5",
"underlying":"SPY",
"day":"2026-09-24",
"strategies": [
"Bull Put Spread"
],
"price_currency":"USD",
"executions":2,
"legs": [
{
"action":"BUY",
"right":"P",
"strike":630,
"expiry":"2026-10-31",
"qty":1,
"price":2.35
},
{
"action":"SELL",
"right":"P",
"strike":640,
"expiry":"2026-10-31",
"qty":1,
"price":4.1
}
],
"premium": {
"type":"credit",
"amount":175
},
"max_loss":825,
"max_loss_unbounded":false,
"width":10
}
]
},
{
"username":"otro_trader",
"display_name":"Otro Trader",
"currency":"USD",
"structures": [
{
"id":"f6e5d4c3b2",
"underlying":"KO",
"day":"2026-09-24",
"strategies": [
"Short Put"
],
"price_currency":"USD",
"executions":1,
"legs": [
{
"action":"SELL",
"right":"P",
"strike":66,
"expiry":"2026-10-31",
"qty":2,
"price":0.9
}
],
"premium": {
"type":"credit",
"amount":180
},
"max_loss":13020,
"max_loss_unbounded":false
}
]
}
],
"note":"Aperturas agrupadas como el identificador de estrategias de Tortuga (por trader, subyacente y día en opciones). premium y max_loss (pérdida máxima al vencimiento, sin asignación anticipada) van en price_currency por la posición entera, con contratos de 100; max_loss_unbounded = riesgo sin techo (calls cortas netas). Con acciones dentro no se calculan. summary cuenta TODO lo que casa en la ventana, no solo esta página."
}
list
Feed de operaciones compartidas
solo lectura
list_community_trades
El feed de Ranking › Trades: las operaciones que los traders PUBLICAN a mano o por autopublicación como tarjeta (no son todas sus ejecuciones: para eso, list_public_operations). Cada tarjeta lleva estrategia, patas con strike y vencimiento, apertura, cierre y P&L realizado en la divisa de la operación;, las más recientes primero, con filtros por subyacente, estrategia, tipo y trader, y paginación. Solo para planes de pago y solo si el usuario tiene SU copy trade activo: si lo tiene apagado, la lista llega vacía con viewer_copy_trade_off=true, como en la web.
Argumentos
Argumento
Tipo
Descripción
underlying
texto
Subyacente, p. ej. SPY.
strategy
texto
Estrategia (o varias separadas por coma) tal como la etiqueta Tortuga: «Short Put», «Iron Condor»…
kind
opción
stock (acciones), options (opciones) o futures.Valores: stock, options, futures.
traders
array
Nombres de usuario de los traders (sin @), como salen en author.username.
limit
entero
Operaciones por página (máx. 100).Por defecto: 25. De 1 a 100.
cursor
texto
El next_cursor de la respuesta anterior, para pedir la página siguiente.
Más preguntas que la usan
«¿Qué tarjetas hay en el feed sobre SPY?»«Enséñame las últimas operaciones que ha compartido @tortuga_demo.»
Tú preguntas
«¿Qué puts vendidas ha compartido la comunidad en el feed esta semana?»
{
"viewer_copy_trade_off":false,
"returned":2,
"next_cursor":null,
"trades": [
{
"id":912,
"author": {
"username":"tortuga_demo",
"display_name":"Tortuga Demo",
"user_id":"user_demo"
},
"underlying":"KO",
"strategy":"Short Put",
"currency":"USD",
"status":"open",
"opened_at":"2026-09-22T15:41:00Z",
"closed_at":null,
"legs": [
{
"right":"P",
"strike":66,
"expiry":"2026-10-17",
"qty":-1,
"price":0.95
}
],
"close_legs":null,
"realized_pnl":null,
"note":null,
"created_at":"2026-09-22T15:45:02Z"
},
{
"id":905,
"author": {
"username":"tortuga_demo",
"display_name":"Tortuga Demo",
"user_id":"user_demo"
},
"underlying":"XLF",
"strategy":"Short Put",
"currency":"USD",
"status":"closed",
"opened_at":"2026-08-28T14:02:00Z",
"closed_at":"2026-09-15T16:10:00Z",
"legs": [
{
"right":"P",
"strike":50,
"expiry":"2026-09-19",
"qty":-2,
"price":0.62
}
],
"close_legs": [
{
"price":0.08,
"qty":2
}
],
"realized_pnl":108,
"note":null,
"created_at":"2026-08-28T14:05:40Z"
}
],
"live": [],
"note":"Operaciones que sus autores comparten en Ranking › Trades. P&L en la divisa de la operación (currency). live = las operaciones en directo que la web enseña arriba del feed (solo en la primera página)."
}
get
Perfil de un trader
solo lectura
get_trader_profile
El perfil público de UN trader del Ranking, tal como lo ve el usuario en la web (para las operaciones de todos los traders a la vez, list_public_operations): estadísticas de la temporada, puntuación y puesto; su actividad (operaciones de la temporada: símbolo, fecha, compra/venta, cantidad, precio, P&L en la divisa base del trader y delta) si el trader tiene el copy trade activo, y su cartera viva solo si la comparte. Si el usuario tiene SU copy trade apagado, actividad y cartera llegan vacías con viewer_copy_trade_off=true, como en la web.
Argumentos
Argumento
Tipo
Descripción
usernameobligatorio
texto
Nombre de usuario del trader (sin @), como sale en author.username o en el Ranking.
include
opción
all (actividad y cartera), activity o positions.Valores: all, activity, positions. Por defecto: "all".
symbol
texto
Filtra la actividad por símbolo o subyacente.
from
fecha
Desde (incluido), AAAA-MM-DD.
to
fecha
Hasta (incluido), AAAA-MM-DD.
limit
entero
Filas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursor
texto
El next_cursor de la respuesta anterior, para pedir la página siguiente.
Más preguntas que la usan
«¿Qué cartera tiene @tortuga_demo?»
Tú preguntas
«¿Cómo le va a @tortuga_demo esta temporada y qué ha operado últimamente?»
{
"profile": {
"username":"tortuga_demo",
"display_name":"Tortuga Demo",
"base_currency":"EUR",
"rank":12,
"rank_delta":2,
"score":71.4,
"tier":"gold",
"twr":null,
"capital_return":null,
"stats": {
"trades":48,
"winRate":79.2,
"profitFactor":2.41,
"totalPnl":2314.5
},
"prev_username":"otro_trader",
"next_username":null
},
"activity": {
"hidden":false,
"viewer_copy_trade_off":false,
"total":2,
"returned":2,
"next_cursor":null,
"trades": [
{
"symbol":"KO 261017P00066000",
"trade_date":"2026-09-22",
"action":"SELL",
"quantity":-1,
"price":0.95,
"pnl":0,
"delta":-0.22
},
{
"symbol":"XLF 260919P00050000",
"trade_date":"2026-09-15",
"action":"BUY",
"quantity":2,
"price":0.08,
"pnl":92.1
}
]
},
"positions": {
"enabled":true,
"copy_trade_enabled":true,
"viewer_copy_trade_off":false,
"as_of":"2026-09-24",
"total":1,
"returned":1,
"positions": [
{
"symbol":"KO",
"description":"COCA-COLA CO",
"asset_class":"STK",
"currency":"USD",
"side":"Long",
"quantity":50,
"mark_price":68.9,
"position_value":3445,
"cost_basis_price":61.2,
"percent_of_nav":14.2,
"unrealized_pnl":385,
"as_of_date":"2026-09-24"
}
]
},
"viewer_copy_trade_off":false,
"note":"Perfil público del Ranking. Importes en la divisa base del trader (profile.base_currency); su cartera, en la divisa de cada posición. as_of = fecha del último extracto del bróker del trader."
}
get
Screener de la comunidad
solo lectura
get_community_screener
La pestaña Comunidad del Ranking: qué operan los traders de Tortuga en la última semana, mes o año — tickers, estrategias, sectores, DTE y delta de apertura, DTE y % de prima capturada al cierre — con cuántos traders hay detrás (los que no comparten cuentan como anónimos). Con detail_kind y detail_key da el detalle de UN ticker o estrategia: el cruce con la otra dimensión y las operaciones individuales de los traders que comparten (vacías si el usuario tiene SU copy trade apagado, con viewer_copy_trade_off=true).
Argumentos
Argumento
Tipo
Descripción
window
opción
Ventana: week, month o year.Valores: week, month, year. Por defecto: "week".
ticker
texto
Cruza todo con un ticker.
strategy
texto
Cruza todo con una estrategia (o varias separadas por coma).
sector
texto
Cruza todo con un sector.
detail_kind
opción
Detalle de un ticker o de una estrategia (requiere detail_key).Valores: ticker, strategy.
detail_key
texto
El ticker o la estrategia del detalle, como sale en la fila (key).
limit
entero
Filas por lista (máx. 100).Por defecto: 20. De 1 a 100.
Más preguntas que la usan
«¿A qué DTE abre la comunidad sus puts vendidas?»«¿Quién ha operado NVDA esta semana? (detalle)»
Tú preguntas
«¿Qué tickers y estrategias opera más la comunidad este mes?»
{
"window":"month",
"from":"2026-08-26",
"to":"2026-09-25",
"filters": {
"ticker":null,
"strategy":null,
"sector":null
},
"totals": {
"traders":23,
"tickers":88,
"fills":412,
"strategies":14,
"operations":197
},
"tickers": [
{
"key":"SPY",
"count":41,
"traders":9,
"anonymous":6,
"faces": [
"tortuga_demo"
]
}
],
"strategies": [
{
"key":"Short Put",
"count":63,
"traders":14,
"anonymous":9,
"faces": [
"tortuga_demo"
]
}
],
"sectors": [
{
"key":"Technology",
"count":37,
"traders":11,
"anonymous":8,
"faces": []
}
],
"open_dte": [
{
"key":"22–45",
"count":22,
"traders":7,
"anonymous":5,
"faces": []
}
],
"open_delta": [
{
"key":"0,10–0,20",
"count":18,
"traders":6,
"anonymous":4,
"faces": []
}
],
"close_dte": [],
"close_capture": [
{
"key":"50–75 %",
"count":12,
"traders":5,
"anonymous":3,
"faces": []
}
],
"note":"count = movimientos (o usos de la estrategia); traders = cuántos hay detrás; los que no comparten (copy trade apagado) cuentan como anonymous y nunca se identifican. faces = nombres de usuario de los que sí comparten."
}
get
Market Radar
solo lectura
get_market_radar
El Market Radar de Tortuga (Market Lab › Market Radar): el escaneo diario de opciones de ≈500 valores de EE. UU., el mismo para todos los usuarios. Por valor: IV30, IV Rank, IV Percentile, RV20, VRP (IV − RV), IV/HV, estructura temporal, skew, movimiento esperado a 30 días, RSI y tendencia, resultados, liquidez (nota 0-4, spread, volumen y actividad inusual, open interest y put/call), muros de puts y calls, max pain, la put de delta 0,30 con su rendimiento anualizado, el cuadrante IV Rank × VRP y la estrategia que propone el motor del radar. Filtra y ordena como la tabla de la web. Con symbol da la ficha de UN valor: todas las estrategias puntuadas con sus motivos, la idea de strikes de la estrategia propuesta, medias y soportes, y la IV de las últimas 30 sesiones.
Argumentos
Argumento
Tipo
Descripción
symbol
texto
Ficha de UN valor (p. ej. AAPL). Sin symbol, la lista filtrada.
zone
opción
Cuadrante: sell_premium (IV Rank ≥ 50 y VRP > 0), caution (IV Rank ≥ 50 y VRP ≤ 0), calendars (IV Rank < 50 y VRP > 0) o buy_options (IV Rank < 50 y VRP ≤ 0).Valores: sell_premium, caution, calendars, buy_options.
strategy
opción
Solo los valores cuya estrategia propuesta por el radar es esta.Valores: short_put, covered_call, bull_put_spread, bear_call_spread, iron_condor, short_strangle, short_straddle, calendar.
signal
opción
Semáforo de la mejor estrategia puntuada.Valores: favorable, neutral, avoid.
sector
texto
Sector GICS en inglés (Technology, Energy…) o ETF.
Estructura temporal de la IV.Valores: contango, flat, backwardation.
iv_rank_min
número
IV Rank mínimo (0-100).De 0 a 100.
iv_percentile_min
número
IV Percentile mínimo (0-100).De 0 a 100.
vrp_min
número
VRP mínimo en puntos porcentuales (IV30 − RV20).De -100 a 100.
exclude_earnings
sí / no
Quita los que presentan resultados antes del vencimiento objetivo.Por defecto: false.
liquid_only
sí / no
Solo buena liquidez (nota ≥ 3 de 4).Por defecto: false.
unusual_activity
sí / no
Solo actividad inusual: volumen de opciones de hoy ≥ 2× su media de 20 sesiones.Por defecto: false.
price_min
número
Precio mínimo del subyacente, USD.
price_max
número
Precio máximo del subyacente, USD.
sort
opción
Orden, de mayor a menor (los que no tienen el dato, al final).Valores: iv_rank, iv_percentile, vrp, iv30, iv_hv, score, option_volume, volume_ratio, change_pct, expected_move, put30_yield. Por defecto: "iv_rank".
limit
entero
Filas (máx. 100).Por defecto: 25. De 1 a 100.
Más preguntas que la usan
«¿Dónde está más cara la volatilidad implícita respecto a la realizada?»«¿Qué estrategia propone el radar para AMD y con qué strikes?»
Tú preguntas
«¿Qué valores del Market Radar están en zona de vender prima y sin resultados antes del vencimiento?»
{
"as_of":"2026-09-25",
"updated_at":"2026-09-25T15:05:00Z",
"market_open":true,
"universe":2,
"zones": {
"sell_premium": {
"count":1,
"rule":"IV Rank ≥ 50 y VRP > 0"
},
"caution": {
"count":0,
"rule":"IV Rank ≥ 50 y VRP ≤ 0"
},
"calendars": {
"count":1,
"rule":"IV Rank < 50 y VRP > 0"
},
"buy_options": {
"count":0,
"rule":"IV Rank < 50 y VRP ≤ 0"
}
},
"sort":"iv_rank",
"matched":1,
"returned":1,
"truncated":false,
"rows": [
{
"symbol":"AMD",
"sector":"Technology",
"price":162.4,
"change_pct":0.8,
"iv30_pct":48,
"iv_change_pp":null,
"iv_rank":71,
"iv_percentile":66,
"rv20_pct":36,
"vrp_pp":12,
"iv_hv":1.33,
"term_structure":"contango",
"skew25d_pp":4.1,
"expected_move_30d_pct":9.2,
"rsi14":52,
"trend":"bullish",
"earnings": {
"date":"2026-10-28",
"days_to":33,
"before_target_expiry":false
},
"zone":"sell_premium",
"top_strategy": {
"key":"ventaPut",
"name":"Venta de PUT",
"score":75,
"signal":"favorable"
},
"signal":"favorable",
"liquidity": {
"stars":4,
"spread_pct":2.4,
"option_volume":14000,
"volume_ratio_20":1.3,
"total_oi":125000,
"put_call_oi":0.79,
"put_call_volume":0.64
},
"levels": {
"put_wall":90,
"call_wall":110,
"max_pain":98
},
"put30": {
"strike":94,
"mid":1.62,
"delta":-0.3,
"annualized_yield_pct":17.4,
"expiry":"2026-10-31",
"dte":36
}
}
],
"note":"Market Radar de Tortuga: el mismo escaneo que la web (≈500 valores de EE. UU., cotizaciones de IBKR con retraso y open interest de CBOE del último día; el OI de más de 3 días se descarta). iv30/rv20 en %, vrp y skew en puntos porcentuales (IV30 − RV20), iv_rank e iv_percentile de 0 a 100. zone = cuadrante IV Rank × VRP; top_strategy = la estrategia que propone el motor del radar (null = esperar o poca liquidez). Es información, no es asesoramiento de inversión."
}
get
Super Investors
solo lectura
get_super_investors
Super Investors de Tortuga (Market Lab › Super Investors): las carteras 13F públicas de 50 gestores de renombre. Sin argumentos: la lista de gestores con valor de cartera, nº de posiciones y trimestre. Con stats=true: los rankings del grupo (los valores más poseídos, los de mayor valor agregado, las mayores apuestas en una sola cartera y lo que más compraron y vendieron el último trimestre). Con investor (slug o nombre, p. ej. «berkshire» o «Burry»): su cartera con el peso de cada posición en los últimos 6 trimestres y qué hizo el último (new, added, trimmed, exited, held). Con symbol: qué gestores tienen ese valor, cuánto pesa en su cartera y cómo han movido sus acciones trimestre a trimestre. OJO: los 13F llegan con ≈45 días de retraso y solo cubren posiciones largas en EE. UU.; no es tiempo real, no lo presentes como tal.
Argumentos
Argumento
Tipo
Descripción
investor
texto
Cartera de UN gestor: su slug (de la lista) o su nombre / el del fondo.
symbol
texto
Qué gestores tienen este valor (ticker, p. ej. AAPL; también vale parte del nombre).
stats
sí / no
Rankings del grupo en el último trimestre (sin investor ni symbol).Por defecto: false.
limit
entero
Filas por lista (máx. 50).Por defecto: 25. De 1 a 50.
offset
entero
Para paginar: las filas se saltan desde aquí (usa next_offset de la respuesta).Por defecto: 0. De 0 a 1.000.
Más preguntas que la usan
«¿Qué gestores de Super Investors tienen NVDA y quién la ha ido aumentando?»«¿Cuáles son los valores más poseídos y lo que más ha comprado el grupo?»
Tú preguntas
«¿Qué tiene Berkshire Hathaway en cartera y qué ha comprado o vendido el último trimestre?»
{
"slug":"berkshire",
"name":"Ejemplo Gestor",
"fund":"Ejemplo Capital",
"latest_quarter":"2026-06-30",
"quarters": [
"2026-03-31",
"2026-06-30"
],
"quarters_note":"weight_history_pct va alineado con quarters (del más antiguo al más reciente); 0 = no la tenía ese trimestre.",
"portfolio_value_usd":250000000000,
"total_positions":40,
"positions_available":2,
"offset":0,
"returned":2,
"next_offset":null,
"truncated":false,
"positions": [
{
"ticker":"EJ1",
"issuer":"EJEMPLO UNO INC",
"cusip":"000000001",
"status":"held",
"weight_pct":41.2,
"shares":900000000,
"weight_history_pct": [
38.1,
41.2
]
},
{
"ticker":"EJ2",
"issuer":"EJEMPLO DOS CORP",
"cusip":"000000002",
"status":"new",
"weight_pct":3.4,
"shares":20000000,
"weight_history_pct": [
0,
3.4
]
}
],
"note":"Super Investors de Tortuga: carteras públicas 13F que cada gestor presenta a la SEC (solo posiciones largas en EE. UU.: sin cortos ni derivados fuera de lo declarado). Llegan con ≈45 días de retraso tras el cierre del trimestre: NO es tiempo real y no dice qué hace hoy el gestor. weight_pct = % de la cartera 13F; los valores van en USD. Es información, no es asesoramiento de inversión. status = lo que hizo el gestor el último trimestre: new, added, trimmed, exited o held. Solo se sirven sus mayores posiciones (total_positions puede ser mayor)."
}
Para tu IA
Instrucciones del servidor
Al conectarse, el servidor le envía a tu IA estas instrucciones (el campo instructions del protocolo). Son las mismas para todos los asistentes y marcan cómo debe usar las herramientas y cómo contarte los datos.
instructions
Eres el conector de Tortuga Trades, un diario de trading. Todas las herramientas son de solo lectura y hay DOS familias. Las de la cuenta (get_context, get_summary, list_trades…) leen SOLO la del usuario que ha dado permiso. Las de comunidad leen lo que los demás traders de Tortuga tienen público y la web le enseña a este usuario, nunca datos privados de otros usuarios: list_public_operations (las operaciones de TODOS los traders públicos a la vez, de un día o rango), get_trader_profile (uno), get_community_screener (agregados) y list_community_trades (el feed de tarjetas compartidas). Así que SÍ puedes analizar lo que opera o publica la comunidad: no digas que solo tienes acceso a la cuenta del usuario.
Cómo trabajar:
1. Llama primero a get_context: da la fecha de hoy (Europe/Madrid) y las cuentas (1 = la principal), con su divisa base y los periodos con datos. Si hay varias cuentas y el usuario no dice cuál, pregúntale, y di siempre de qué cuenta hablas.
2. No inventes cifras. Si una herramienta no trae un dato, dilo. Indica siempre el periodo y la cuenta.
3. Importes en la divisa base de la cuenta (campo currency). Precio y comisión de una fila van en la divisa del instrumento (price_currency).
4. Rentabilidad: es la TWR que Tortuga compone con los datos del bróker. Solo es «YTD» si returns.is_ytd es true; si no, di «desde {from}».
5. Estrategias: son las etiquetas del identificador de Tortuga (Iron Condor, Short Put, Bull Put Spread…), las mismas que ve el usuario en la web. Una operación de varias patas cuenta una vez.
6. Las operaciones que el usuario ocultó en la web no cuentan en resúmenes ni estadísticas; en list_trades aparecen con hidden=true.
7. get_pnl_calendar da el P&L de operaciones. El Calendario de la web suma además dividendos e intereses cuando su casilla «Dividendos» está marcada (lo está por defecto): para comparar, súmale get_dividends.
8. Diario: get_journal con view=operations/days/overview da la revisión de Trades › Journal (polaridad de etiquetas, emociones, playbooks y su % de cumplimiento, notas de día y semana, metas). Sus cifras son las de la web: no las recalcules. Las operaciones no ejecutadas (missed) nunca suman.
9. Watchlist: get_watchlists da sus listas con cotización; get_chart, las velas e indicadores del gráfico de Tortuga (no calcules otros a mano). Usa como símbolo la clave de la lista («REP:EUR»).
10. Comunidad: para «qué han operado/publicado los usuarios» (ayer, esta semana, con opciones, mejor R:R…) usa list_public_operations en una sola llamada (view=structures para comparar riesgo/beneficio con premium y max_loss); no recorras perfiles uno a uno. Si viene viewer_copy_trade_off=true, el usuario tiene SU copy trade apagado y no puede ver operaciones de otros: dile la nota tal cual. Cita siempre al trader por su nombre de usuario y no saques conclusiones de los anónimos.
11. Mercado: get_market_radar es el Market Radar de opciones de la web (con symbol, la ficha de un valor). get_super_investors: carteras 13F (≈45 días de retraso).
12. Si la respuesta trae warnings, cuéntaselos al usuario.
13. Si una herramienta devuelve un error con instrucciones (plan, pausa, límite), transmíteselas tal cual.
14. Esto es información, no asesoramiento de inversión: cuando des opiniones sobre qué hacer, recuérdalo.
15. Lo que hacen otros traders tampoco es una recomendación.
16. Responde en el idioma del usuario.
Glosario: rolo = cerrar una opción y abrir otra del mismo subyacente con otro vencimiento o strike; PMC virtual = precio medio de compra rebajado por las primas cobradas; P&L neto = después de comisiones; combo = varias patas de una misma estrategia; theta diaria = lo que gana (positivo) o pierde la posición por el paso de un día; % de prima capturada (pct_premium_captured) = la parte de la prima de una opción vendida que ya es beneficio, la misma cifra que la tabla de Trades de la web: es el único % por operación, y acciones y opciones compradas no tienen, así que no calcules otro.