Tortuga Trades
Trading Journal
Tortuga Trades

— Tortuga MCP · v1

Tu cuenta de Tortuga, dentro de tu IA.

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.

Índice

Introducción

Preguntas tú, tu IA consulta Tortuga

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

DatoValor
URL del servidorhttps://tortugatrades.app/mcp
TransporteStreamable HTTP sin estado: cada petición es un POST con JSON-RPC 2.0 (GET responde 405).
AutorizaciónOAuth 2.1 con PKCE (S256). El token viaja en la cabecera Authorization: Bearer.
Metadatos del recurso (RFC 9728)https://tortugatrades.app/.well-known/oauth-protected-resource/mcp
Servidor de autorizaciónhttps://clerk.tortugatrades.app
Registro del clienteClient ID Metadata Documents o registro dinámico (RFC 7591).
Permisos (scopes)profile email offline_access
Sin acceso: 401 con la pista para el cliente
HTTP/2 401
www-authenticate: Bearer resource_metadata="https://tortugatrades.app/.well-known/oauth-protected-resource/mcp"

{"error":"unauthorized"}
Con un token caducado o inválido, la cabecera añade error="invalid_token" y el asistente vuelve a pedirte acceso.

Instalar en tu asistente

Añade Tortuga en un minuto

La dirección es siempre la misma, https://tortugatrades.app/mcp, y la primera vez entras con tu cuenta de Tortuga.

Claude

Web, escritorio y móvil
  1. Abre Ajustes › Conectores › «Añadir conector personalizado».
  2. Nombre: Tortuga Trades. URL: https://tortugatrades.app/mcp
  3. Pulsa «Conectar», entra con tu cuenta de Tortuga y acepta el permiso.
  4. 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
  1. En chatgpt.com, abre Ajustes › Plugins (antes «Conectores») › Avanzado y activa el modo desarrollador.
  2. Crea un conector con la URL https://tortugatrades.app/mcp y autenticación OAuth.
  3. 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
  1. 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.
  2. Entra con tu cuenta de Tortuga y acepta. Después funciona también en la app móvil de Gemini.
  3. 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
  1. Añade el servidor desde tu terminal con el comando de abajo.
  2. 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
  1. Añade el servidor desde tu terminal con el comando de abajo.
  2. 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
  1. Pulsa «Añadir a Cursor» o pega el bloque en ~/.cursor/mcp.json (o en .cursor/mcp.json, solo para un proyecto).
  2. Cursor te pedirá entrar con tu cuenta de Tortuga la primera vez que use una herramienta.
~/.cursor/mcp.json
{
  "mcpServers": {
    "tortuga": {
      "url": "https://tortugatrades.app/mcp"
    }
  }
}
Añadir a Cursor

VS Code

.vscode/mcp.json
  1. Pega el bloque en .vscode/mcp.json (o en tu configuración de usuario).
  2. Pulsa «Start» sobre el servidor y entra con tu cuenta de Tortuga cuando VS Code te lo pida.
.vscode/mcp.json
{
  "servers": {
    "tortuga": {
      "type": "http",
      "url": "https://tortugatrades.app/mcp"
    }
  }
}

¿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ímiteValor
Consultas por minuto60
Consultas al día2.000
Tamaño de las listasCada 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ágina50 por defecto y 200 como máximo (list_trades y get_journal).
Calendario por díasHasta 366 días por consulta; para más, por semanas o meses.
GráficosHasta 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 radarHasta 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 consultaUnos 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ódigoCuándoTexto que recibe tu IA
betaLa 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_onlyTu 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
pausedHas 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_limitedMá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_accountEl número de cuenta no existe en tu Tortuga.Esa cuenta no existe en tu Tortuga Trades. Consulta tus cuentas con get_context.
bad_inputUn 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».
timeoutLa 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_errorTortuga 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.

Primera página
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_trades",
    "arguments": {
      "account": 1,
      "limit": 2
    }
  }
}
Respuesta
{
  "account": 1,
  "accounts_available": [
    1,
    2
  ],
  "currency": "EUR",
  "total": 11,
  "returned": 2,
  "next_cursor": "2",
  "truncated": false,
  "warnings": []
}
Sin la lista trades, que trae las 2 filas.
Página siguiente
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_trades",
    "arguments": {
      "account": 1,
      "limit": 2,
      "cursor": "2"
    }
  }
}

Fechas, divisas y datos

Cómo leer las respuestas

  • 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.

HerramientaQué respondeArgumentos
get_contextMi cuenta en Tortuga«¿Qué cuentas tengo en Tortuga y hasta qué fecha tengo datos?»—
get_summaryResumen de la cuenta«¿Cómo va mi cuenta este año?»account
list_tradesOperaciones«Enséñame las puts vendidas de este año.»account from to symbol strategy type status outcome sort limit cursor
get_tradeDetalle de operación«¿Cuánta prima capturé con la put de KO que recompré en julio, y qué anoté en el diario?»account id*
get_trade_statsEstadísticas por estrategia«¿Qué estrategia me deja más dinero?»account group_by from to symbol strategy type
get_pnl_calendarCalendario de P&L«¿Cuánto gané cada mes de este año?»account granularity from to
get_portfolioCartera«¿Qué posiciones tengo abiertas y cuánto pesa cada una?»account class
get_optionsOpciones abiertas«¿Qué opciones me vencen pronto y cuánta theta cobro al día?»account
get_dividendsDividendos e intereses«¿Cuánto llevo cobrado en dividendos este año y qué me queda por cobrar?»account year
get_journalDiario«Resume lo que he escrito en mi diario desde junio.»account from to view trade_id limit cursor
get_watchlistsWatchlist«¿Cómo van hoy los valores de mi lista de favoritos?»account list quotes limit cursor
get_chartGráfico«¿Cómo está el RSI de AAPL en diario?»symbol* interval limit indicators
list_public_operationsOperaciones públicas de la comunidad«¿Qué operaciones con opciones de las publicadas ayer por los usuarios de Tortuga tienen mejor R:R?»date from to kind underlying strategy side traders view limit cursor
list_community_tradesFeed de operaciones compartidas«¿Qué puts vendidas ha compartido la comunidad en el feed esta semana?»underlying strategy kind traders limit cursor
get_trader_profilePerfil de un trader«¿Cómo le va a @tortuga_demo esta temporada y qué ha operado últimamente?»username* include symbol from to limit cursor
get_community_screenerScreener de la comunidad«¿Qué tickers y estrategias opera más la comunidad este mes?»window ticker strategy sector detail_kind detail_key limit
get_market_radarMarket Radar«¿Qué valores del Market Radar están en zona de vender prima y sin resultados antes del vencimiento?»symbol zone strategy signal sector trend term iv_rank_min iv_percentile_min vrp_min exclude_earnings liquid_only unusual_activity price_min price_max sort limit
get_super_investorsSuper Investors«¿Qué tiene Berkshire Hathaway en cartera y qué ha comprado o vendido el último trimestre?»investor symbol stats limit offset

* 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_context",
    "arguments": {}
  }
}
Tortuga responde · cuenta de ejemplo
{
  "today": "2026-09-25",
  "timezone": "Europe/Madrid",
  "accounts": [
    {
      "account": 1,
      "label": "Interactive Brokers",
      "currency": "EUR",
      "last_sync": "2026-09-25T06:14:00.000Z",
      "sync_error": null,
      "returns_period": {
        "from": "2026-01-01",
        "to": "2026-09-24"
      },
      "trades": 11,
      "first_trade_date": "2025-03-10",
      "last_trade_date": "2026-09-08",
      "has_options": true
    },
    {
      "account": 2,
      "label": "DEGIRO",
      "currency": "EUR",
      "last_sync": null,
      "sync_error": null,
      "returns_period": null,
      "trades": 2,
      "first_trade_date": "2026-02-11",
      "last_trade_date": "2026-05-06",
      "has_options": false
    }
  ],
  "notes": []
}
get

Resumen de la cuenta

solo lectura
get_summary

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

ArgumentoTipoDescripción
accountenteroNú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

«Dame el resumen de mi cuenta principal.»
Tú preguntas

«¿Cómo va mi cuenta este año?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_summary",
    "arguments": {
      "account": 1
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "account": 1,
  "accounts_available": [
    1,
    2
  ],
  "label": "Interactive Brokers",
  "currency": "EUR",
  "net_liquidation": 11666.09,
  "cash": 5231.46,
  "invested": 6434.63,
  "returns": {
    "pct": 7.84,
    "from": "2026-01-01",
    "to": "2026-09-24",
    "is_ytd": true,
    "label": "Rentabilidad YTD 2026"
  },
  "returns_note": null,
  "stats": {
    "closed_operations": 4,
    "winners": 3,
    "losers": 1,
    "win_rate_pct": 75,
    "realized_pnl": 390.16,
    "gross_gains": 547.97,
    "gross_losses": -157.81,
    "profit_factor": 3.47,
    "expectancy": 97.54,
    "avg_win": 182.66,
    "avg_loss": -157.81
  },
  "warnings": []
}
list

Operaciones

solo lectura
list_trades

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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
fromfechaDesde (incluido), AAAA-MM-DD.
tofechaHasta (incluido), AAAA-MM-DD.
symboltextoTicker o subyacente, p. ej. AAPL o SPY.
strategytextoEstrategia tal como la etiqueta Tortuga: «Iron Condor», «Short Put», «Bull Put Spread»… (acepta minúsculas y alias en castellano).
typeopciónTipo de instrumento.Valores: stock, etf, fund, option, future, fx, other.
statusopciónclosed = ejecución que cierra (tiene P&L realizado); open = ejecución de apertura.Valores: open, closed.
outcomeopciónwin = P&L > 0; loss = P&L < 0.Valores: win, loss.
sortopciónOrden: 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".
limitenteroFilas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursortextoEl 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?»
Tú preguntas

«Enséñame las puts vendidas de este año.»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_trades",
    "arguments": {
      "account": 1,
      "strategy": "put vendida",
      "from": "2026-01-01",
      "limit": 20
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "account": 1,
  "accounts_available": [
    1,
    2
  ],
  "currency": "EUR",
  "total": 5,
  "returned": 5,
  "next_cursor": null,
  "truncated": false,
  "trades": [
    {
      "id": "flex::1011",
      "date": "2026-09-08",
      "symbol": "PFE 24P 20/11/26",
      "underlying": "PFE",
      "type": "option",
      "side": "SELL",
      "qty": 1,
      "price": 0.62,
      "price_currency": "USD",
      "commission": -0.65,
      "pnl": null,
      "pct_premium_captured": null,
      "strategy": "Short Put",
      "combo_id": null,
      "status": "open",
      "expiry": "2026-11-20",
      "strike": 24,
      "right": "P"
    },
    {
      "id": "flex::1010",
      "date": "2026-08-14",
      "symbol": "XLF 50P 21/08/26",
      "underlying": "XLF",
      "type": "option",
      "side": "BUY",
      "qty": 1,
      "price": 0.08,
      "price_currency": "USD",
      "commission": -0.65,
      "pnl": 38.98,
      "pct_premium_captured": 85.45,
      "strategy": "Short Put",
      "combo_id": null,
      "status": "closed",
      "expiry": "2026-08-21",
      "strike": 50,
      "right": "P"
    },
    {
      "id": "flex::1009",
      "date": "2026-07-10",
      "symbol": "KO 68P 17/07/26",
      "underlying": "KO",
      "type": "option",
      "side": "BUY",
      "qty": 1,
      "price": 0.14,
      "price_currency": "USD",
      "commission": -0.65,
      "pnl": 80.78,
      "pct_premium_captured": 87.27,
      "strategy": "Short Put",
      "combo_id": null,
      "status": "closed",
      "expiry": "2026-07-17",
      "strike": 68,
      "right": "P"
    }
  ],
  "warnings": []
}
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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
idobligatoriotextoEl 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_trade",
    "arguments": {
      "account": 1,
      "id": "flex::1009"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
group_byopciónAgrupar 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".
fromfechaDesde (incluido), AAAA-MM-DD.
tofechaHasta (incluido), AAAA-MM-DD.
symboltextoTicker o subyacente, p. ej. AAPL o SPY.
strategytextoEstrategia tal como la etiqueta Tortuga: «Iron Condor», «Short Put», «Bull Put Spread»… (acepta minúsculas y alias en castellano).
typeopciónTipo 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?»
Tú preguntas

«¿Qué estrategia me deja más dinero?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_trade_stats",
    "arguments": {
      "account": 1,
      "group_by": "strategy",
      "from": "2026-01-01"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
granularityopciónUna 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".
fromfechaDesde (incluido), AAAA-MM-DD.
tofechaHasta (incluido), AAAA-MM-DD.

Más preguntas que la usan

«¿Cuál fue mi mejor semana?»
Tú preguntas

«¿Cuánto gané cada mes de este año?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pnl_calendar",
    "arguments": {
      "account": 1,
      "granularity": "month",
      "from": "2026-01-01",
      "to": "2026-09-30"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
classopciónQué 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_portfolio",
    "arguments": {
      "account": 1,
      "class": "all"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNú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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_options",
    "arguments": {
      "account": 1
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
yearenteroAñ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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_dividends",
    "arguments": {
      "account": 1,
      "year": 2026
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
fromfechaDesde (incluido), AAAA-MM-DD.
tofechaHasta (incluido), AAAA-MM-DD.
viewopciónentries (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_idtextoEl id de una fila de list_trades: devuelve solo la entrada del diario de esa operación.
limitenteroFilas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursortextoEl 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.»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_journal",
    "arguments": {
      "account": 1,
      "from": "2026-06-01"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
accountenteroNúmero de cuenta en Tortuga (1 = la principal). Las cuentas del usuario salen en get_context.Por defecto: 1. De 1 a 20.
listtextoId o nombre de la lista (sin distinguir mayúsculas), o portfolio / favorites / community / radar. Por defecto, la lista activa en la web.
quotessí / noIncluir la cotización actual de cada símbolo de la lista elegida.Por defecto: true.
limitenteroSímbolos por página (máx. 100).Por defecto: 50. De 1 a 100.
cursortextoEl 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_watchlists",
    "arguments": {
      "list": "favorites"
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
symbolobligatoriotextoTicker de Yahoo o clave de la Watchlist con pista de plaza: AAPL, ^GSPC, BTC-USD, REP:EUR.
intervalopciónTemporalidad: 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".
limitenteroVelas a devolver, las más recientes (máx. 500).Por defecto: 100. De 1 a 500.
indicatorsarrayIndicadores 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?»
Tú preguntas

«¿Cómo está el RSI de AAPL en diario?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_chart",
    "arguments": {
      "symbol": "AAPL",
      "interval": "D",
      "limit": 5,
      "indicators": [
        {
          "type": "rsi"
        },
        {
          "type": "sma",
          "period": 20
        }
      ]
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
datetextoUn solo día: today, yesterday (Europe/Madrid) o AAAA-MM-DD. Alternativa a from/to.
fromfechaDesde (incluido), AAAA-MM-DD. Ventana de como mucho 31 días; sin date ni from, los últimos 7 días.
tofechaHasta (incluido), AAAA-MM-DD. Por defecto, el mismo día que from (o hoy).
kindopciónall, options (solo opciones) o stock (acciones y demás instrumentos sin opción).Valores: all, options, stock. Por defecto: "all".
underlyingtextoSubyacente, p. ej. SPY o AAPL.
strategytextoEstrategia (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.
sideopciónopen = ejecuciones de apertura; close = cierres (con P&L realizado).Valores: open, close.
tradersarrayLimita a estos traders (nombre de usuario, sin @).
viewopciónexecutions (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".
limitenteroEjecuciones 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.
cursortextoEl 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_public_operations",
    "arguments": {
      "date": "yesterday",
      "kind": "options",
      "view": "structures",
      "limit": 50
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
underlyingtextoSubyacente, p. ej. SPY.
strategytextoEstrategia (o varias separadas por coma) tal como la etiqueta Tortuga: «Short Put», «Iron Condor»…
kindopciónstock (acciones), options (opciones) o futures.Valores: stock, options, futures.
tradersarrayNombres de usuario de los traders (sin @), como salen en author.username.
limitenteroOperaciones por página (máx. 100).Por defecto: 25. De 1 a 100.
cursortextoEl 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_community_trades",
    "arguments": {
      "strategy": "Short Put",
      "limit": 10
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
usernameobligatoriotextoNombre de usuario del trader (sin @), como sale en author.username o en el Ranking.
includeopciónall (actividad y cartera), activity o positions.Valores: all, activity, positions. Por defecto: "all".
symboltextoFiltra la actividad por símbolo o subyacente.
fromfechaDesde (incluido), AAAA-MM-DD.
tofechaHasta (incluido), AAAA-MM-DD.
limitenteroFilas por página (máx. 200).Por defecto: 50. De 1 a 200.
cursortextoEl 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_trader_profile",
    "arguments": {
      "username": "tortuga_demo",
      "limit": 10
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
windowopciónVentana: week, month o year.Valores: week, month, year. Por defecto: "week".
tickertextoCruza todo con un ticker.
strategytextoCruza todo con una estrategia (o varias separadas por coma).
sectortextoCruza todo con un sector.
detail_kindopciónDetalle de un ticker o de una estrategia (requiere detail_key).Valores: ticker, strategy.
detail_keytextoEl ticker o la estrategia del detalle, como sale en la fila (key).
limitenteroFilas 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_community_screener",
    "arguments": {
      "window": "month",
      "limit": 5
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
symboltextoFicha de UN valor (p. ej. AAPL). Sin symbol, la lista filtrada.
zoneopciónCuadrante: 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.
strategyopciónSolo 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.
signalopciónSemáforo de la mejor estrategia puntuada.Valores: favorable, neutral, avoid.
sectortextoSector GICS en inglés (Technology, Energy…) o ETF.
trendopciónTendencia técnica.Valores: bullish, neutral, bearish.
termopciónEstructura temporal de la IV.Valores: contango, flat, backwardation.
iv_rank_minnúmeroIV Rank mínimo (0-100).De 0 a 100.
iv_percentile_minnúmeroIV Percentile mínimo (0-100).De 0 a 100.
vrp_minnúmeroVRP mínimo en puntos porcentuales (IV30 − RV20).De -100 a 100.
exclude_earningssí / noQuita los que presentan resultados antes del vencimiento objetivo.Por defecto: false.
liquid_onlysí / noSolo buena liquidez (nota ≥ 3 de 4).Por defecto: false.
unusual_activitysí / noSolo actividad inusual: volumen de opciones de hoy ≥ 2× su media de 20 sesiones.Por defecto: false.
price_minnúmeroPrecio mínimo del subyacente, USD.
price_maxnúmeroPrecio máximo del subyacente, USD.
sortopciónOrden, 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".
limitenteroFilas (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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_market_radar",
    "arguments": {
      "zone": "sell_premium",
      "exclude_earnings": true,
      "liquid_only": true,
      "limit": 5
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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

ArgumentoTipoDescripción
investortextoCartera de UN gestor: su slug (de la lista) o su nombre / el del fondo.
symboltextoQué gestores tienen este valor (ticker, p. ej. AAPL; también vale parte del nombre).
statssí / noRankings del grupo en el último trimestre (sin investor ni symbol).Por defecto: false.
limitenteroFilas por lista (máx. 50).Por defecto: 25. De 1 a 50.
offsetenteroPara 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?»

Tu IA llama a la herramienta
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_super_investors",
    "arguments": {
      "investor": "berkshire",
      "limit": 10
    }
  }
}
Tortuga responde · cuenta de ejemplo
{
  "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.