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