API REST MCP (Protocolo de Contexto de Modelo) de Korea Investment & Securities

Este es un servidor MCP (Protocolo de contexto de modelo) que busca información sobre precios y transacciones de acciones utilizando la API REST de Korea Investment & Securities (KIS). Proporciona diversas funciones de transacciones financieras, como negociación de acciones nacionales y extranjeras, consulta de precios y gestión de cuentas.

✨ Características principales

• 🇰🇷 Negociación de acciones nacionales
  • Consulta de precios actuales en tiempo real
  • Orden de compra/venta
  • Consultar saldo
  • Ver información del hogar
  • Consultar el historial de pedidos
• 🌏 Comercio de acciones extranjeras
  • Soporte para los principales mercados, incluidos EE. UU., Japón, China, Hong Kong y Vietnam.
  • Consulta de precios actuales en tiempo real
  • Orden de compra/venta
• ⚡ Características
  • Respuesta rápida con procesamiento asincrónico
  • Información de precios y transacciones en tiempo real
  • Manejo de errores estable
  • Diseño escalable

⚠️ Nota

Este proyecto aún está en desarrollo y es un proyecto inacabado. Realice una prueba exhaustiva antes de usarlo para realizar una inversión real.

• Cualquier pérdida y responsabilidad derivada del uso de este proyecto son enteramente responsabilidad del usuario.
• Al utilizar la API, debe cumplir con los Términos de uso de Korea Investment & Securities.
• Se requiere precaución al utilizar una cuenta real y se recomienda realizar pruebas suficientes con una cuenta de inversión simulada.
• Asegúrese de verificar las restricciones con respecto a los límites de llamadas API.

Requisitos

• Python >= 3.13
• uv (herramienta de empaquetado de Python)

Instalación

Funciones

Comercio de acciones nacionales

• inquery_stock_price - Consultar el precio actual de las acciones
  • symbol : código bursátil (p. ej., "005930") (cadena, obligatoria)
  • Rendimientos: Precio actual, precio del día anterior, tasa de aumento o disminución, volumen de negociación, etc.
• order_stock - Orden de compra/venta de acciones
  • symbol : código bursátil (cadena, obligatorio)
  • quantity : Cantidad del pedido (número, requerido)
  • price : precio del pedido (0: precio de mercado) (número, obligatorio)
  • order_type : Tipo de orden ("compra" o "venta") (cadena, obligatoria)
• inquery_balance - Consultar el saldo de la cuenta
  • Devoluciones: Tenencias, valoración, estado de pérdidas y ganancias, etc.
• inquery_order_list - Consultar el historial diario de pedidos
  • start_date : Fecha de inicio de la búsqueda (AAAAMMDD) (cadena, obligatoria)
  • end_date : Fecha de finalización de la búsqueda (AAAAMMDD) (cadena, obligatoria)
• inquery_order_detail - Consultar detalles del pedido
  • order_no : número de pedido (cadena, obligatorio)
  • order_date : Fecha del pedido (AAAAMMDD) (cadena, obligatoria)
• inquery_stock_ask - Consultar información sobre el precio de las acciones
  • symbol : código bursátil (cadena, obligatorio)
  • Devoluciones: precio de compra/venta, cantidad ofertada, etc.

Comercio de acciones en el extranjero

• order_overseas_stock - Orden de compra/venta de acciones extranjeras
  • symbol : código bursátil (p. ej., "AAPL") (cadena, obligatoria)
  • quantity : Cantidad del pedido (número, requerido)
  • price : precio del pedido (número, requerido)
  • order_type : Tipo de orden ("compra" o "venta") (cadena, obligatoria)
  • market : Código de mercado (cadena, obligatorio)
    • "NASD": NASDAQ
    • "NYSE": Nueva York
    • "AMEX": Amex
    • "SEHK": Hong Kong
    • "SHAA": Shanghái, China
    • "SZAA": Shenzhen, China
    • "TKSE": Japón
    • "HASE": Hanói, Vietnam
    • "VNSE": Ciudad Ho Chi Minh, Vietnam
• inquery_overseas_stock_price - Consultar precios actuales de acciones en el extranjero
  • symbol : código bursátil (cadena, obligatorio)
  • market : Código de mercado (cadena, obligatorio)

Recursos

Configuración

Configure su clave API y la información de su cuenta a través de variables de entorno:

• KIS_APP_KEY : Clave de la aplicación de inversión y valores de Corea
• KIS_APP_SECRET : Clave secreta de inversión y valores de Corea
• KIS_ACCOUNT_TYPE : Tipo de cuenta ("REAL" o "VIRTUAL")
• KIS_CANO : Número de cuenta

Horario de negociación

Acciones nacionales:

• Horario habitual: 09:00 ~ 15:30
• Precio único fuera de horario: 15:40 ~ 16:00

Acciones extranjeras:

• EE. UU. (NASDAQ/Nueva York): 22:30 ~ 05:00 (hora de Corea)
• Japón: 09:00 ~ 15:10
• China: 10:30 ~ 16:00
• Hong Kong: 10:30 - 16:00
• Vietnam: 11:15 - 16:15

Manejo de errores

Errores principales que pueden ocurrir al llamar a la API:

• Error de autenticación: clave API o clave secreta no válida
• Fondos insuficientes: Cuando el importe del pedido es mayor que el saldo de la cuenta
• Límite de tiempo: Fuera del horario comercial
• Límite de pedido: si la cantidad o el importe del pedido excede el límite.

Acerca de

• Diseño escalable
• Respuesta rápida con procesamiento asincrónico
• Información de precios y transacciones en tiempo real
• Manejo de errores estable

Licencia

Licencia MIT