MY PROP JOURNAL

Etiquetas

Gestiona grupos de etiquetas y etiquetas para organizar tu contenido de trading

Descripción General

Las etiquetas proporcionan una forma flexible de organizar y categorizar tu contenido de trading. La API de Etiquetas te permite crear grupos de etiquetas y etiquetas personalizadas para etiquetar operaciones, análisis, planes, estrategias, tarjetas de reporte, libros de gráficos, playbooks y cuentas.

URL Base: /api/v1/tags

Grupos de Etiquetas

Los grupos de etiquetas son contenedores que contienen etiquetas relacionadas. Cada grupo puede tener un color personalizado y orden de clasificación.

Listar Grupos de Etiquetas

Recupera todos los grupos de etiquetas con sus etiquetas asociadas.

GET /api/v1/tags

Respuesta:

{
  "tagGroups": [
    {
      "id": "uuid",
      "name": "Condiciones del Mercado",
      "color": "#3B82F6",
      "sort_order": 0,
      "tags": [
        {
          "id": "uuid",
          "name": "Tendencial",
          "tag_group_id": "uuid",
          "sort_order": 0,
          "created_at": "2024-01-15T10:00:00Z",
          "updated_at": "2024-01-15T10:00:00Z"
        }
      ],
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-01-15T10:00:00Z"
    }
  ]
}

Crear Grupo de Etiquetas

Crea un nuevo grupo de etiquetas.

POST /api/v1/tags
Content-Type: application/json

{
  "type": "tag_group",
  "name": "Condiciones del Mercado",
  "color": "#3B82F6"
}

Respuesta:

{
  "tagGroup": {
    "id": "uuid",
    "name": "Condiciones del Mercado",
    "color": "#3B82F6",
    "sort_order": 0,
    "tags": [],
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Actualizar Grupo de Etiquetas

Actualiza un grupo de etiquetas existente.

PUT /api/v1/tags
Content-Type: application/json

{
  "type": "tag_group",
  "id": "uuid",
  "name": "Contexto del Mercado",
  "color": "#10B981"
}

Eliminar Grupo de Etiquetas

Elimina un grupo de etiquetas y todas sus etiquetas asociadas.

DELETE /api/v1/tags?type=tag_group&id=uuid

Advertencia: Eliminar un grupo de etiquetas eliminará en cascada todas las etiquetas dentro de ese grupo y eliminará las asociaciones de etiquetas de todo el contenido.

Etiquetas

Las etiquetas pertenecen a grupos de etiquetas y se pueden aplicar a varios tipos de contenido.

Crear Etiqueta

Crea una nueva etiqueta dentro de un grupo de etiquetas.

POST /api/v1/tags
Content-Type: application/json

{
  "type": "tag",
  "tag_group_id": "uuid",
  "name": "Tendencial"
}

Respuesta:

{
  "tag": {
    "id": "uuid",
    "name": "Tendencial",
    "tag_group_id": "uuid",
    "sort_order": 0,
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Actualizar Etiqueta

Actualiza el nombre, orden de clasificación o mueve una etiqueta a un grupo diferente.

PUT /api/v1/tags
Content-Type: application/json

{
  "type": "tag",
  "id": "uuid",
  "name": "Tendencia Fuerte",
  "tag_group_id": "uuid",
  "sort_order": 1
}

Actualización Masiva de Etiquetas

Actualiza múltiples etiquetas a la vez (útil para reordenar).

PUT /api/v1/tags
Content-Type: application/json

{
  "type": "bulk_tags",
  "tagGroupId": "uuid",
  "tags": [
    { "id": "uuid-1", "sort_order": 0 },
    { "id": "uuid-2", "sort_order": 1 },
    { "id": "uuid-3", "sort_order": 2 }
  ]
}

Eliminar Etiqueta

Elimina una etiqueta y la elimina de todo el contenido asociado.

DELETE /api/v1/tags?type=tag&id=uuid

Cargar Etiquetas Predeterminadas

Carga un conjunto predefinido de grupos de etiquetas y etiquetas para una configuración rápida.

POST /api/v1/tags
Content-Type: application/json

{
  "type": "load_defaults"
}

Respuesta:

{
  "tagGroups": [
    {
      "id": "uuid",
      "name": "Calidad del Setup",
      "color": "#3B82F6",
      "sort_order": 0,
      "tags": [
        { "id": "uuid", "name": "A+", "sort_order": 0 },
        { "id": "uuid", "name": "A", "sort_order": 1 },
        { "id": "uuid", "name": "B", "sort_order": 2 }
      ]
    }
  ]
}

Filtrado por Etiquetas

Las etiquetas se incluyen automáticamente al obtener contenido que admite etiquetado. Usa el parámetro tags para filtrar por IDs de etiquetas:

GET /api/v1/trades?tags=uuid-1,uuid-2

Esto devuelve solo las operaciones que tienen al menos una de las etiquetas especificadas aplicadas.

Casos de Uso

Organizar por Tipo de Setup:

{
  "tag_group": "Setups",
  "tags": ["Ruptura", "Retroceso", "Reversión", "Continuación"]
}

Rastrear Calidad de Ejecución:

{
  "tag_group": "Ejecución",
  "tags": ["Entrada Excelente", "Salida Pobre", "Operación Emocional"]
}

Condiciones del Mercado:

{
  "tag_group": "Mercado",
  "tags": ["Tendencial", "Rango", "Alta Volatilidad"]
}

Estrategias:

{
  "tag_group": "Estrategias",
  "tags": ["Scalping", "Day Trading", "Swing Trading"]
}