TickDB MCP

---

🎯 ¿Qué es TickDB?

TickDB es una API de datos de mercado en tiempo real nativa para IA (AI-native real-time market data API) diseñada para desarrolladores, agentes de IA y aplicaciones financieras multimercado.

Con una sola conexión (one connection), accede sin interrupciones a datos de mercado en tiempo real e históricos de múltiples mercados financieros, incluidos Forex, Metales Preciosos, Índices, Acciones de EE. UU. (NASDAQ / NYSE), Acciones de HK, Acciones A y Criptomonedas.

TickDB está diseñado para desarrolladores que necesitan datos de mercado confiables, de baja latencia y sostenibles a largo plazo, ayudándote a evitar la complejidad de gestionar múltiples fuentes de datos, protocolos y proveedores, para que te centres en tu negocio y estrategia.

Admite operaciones a nivel de tick (trades), profundidad de cartera (order book / depth), velas (candlestick) y otros formatos de datos de mercado, mediante API REST y WebSocket, cubriendo trading cuantitativo, agentes de IA, sistemas de cotización en tiempo real, plataformas de trading y análisis de datos.

---

🚀 Inicio rápido

📦 Este repositorio incluye el código fuente completo: SKILL/ (configuración de Skill de IA) · mcp/ (servidor MCP en Python, 13 herramientas · Dockerfile · 46 pruebas unitarias · CI · MIT). El endpoint alojado mcp.tickdb.ai se ejecuta basado en el código de mcp/ — lo que ves, lo que despliegas y lo que ejecuta el equipo oficial es el mismo código.

Elige el método de integración que mejor se adapte a ti:

Método	Ideal para	Descripción
💬 Skill	Uso inmediato por conversación, cero configuración	Instalación con un solo comando npx, la IA obtiene automáticamente una clave de prueba
🔌 MCP	Clientes de codificación con IA / despliegue propio de código abierto	Endpoint alojado + configuración JSON, o despliegue propio basado en mcp/
💻 CLI	Terminal / scripts / agentes de IA	Instalación global con npm, consulta de datos directamente desde la línea de comandos
🔧 API REST	Integración en aplicaciones	API HTTP + 6 ejemplos de endpoints
🌐 WebSocket	Datos en streaming en tiempo real	Suscripción de baja latencia a ticker / depth / trade

---

✨ Características principales

• 🔌 Integración unificada - Una sola API cubre Forex, Metales Preciosos, Índices, Acciones de EE. UU., Acciones de HK, Acciones A y Criptomonedas
• ⚡ Datos en tiempo real - Transmisión por streaming basada en WebSocket, latencia de extremo a extremo de aproximadamente 10-50 ms
• 🤖 Nativo para IA - Skill / MCP / CLI oficiales, tres niveles de integración de IA, listos para usar con agentes de IA y asistentes de codificación
• 🛠️ Amigable para desarrolladores - API RESTful + WebSocket, respuestas JSON estructuradas, documentación completa y ejemplos en varios idiomas
• 🌍 Cobertura global - Más de 37,527 instrumentos, 6 mercados principales (EE. UU./HK/CN + Forex/Crypto/Índices)
• 🆓 Comienza gratis - Sin necesidad de tarjeta de crédito, obtén tu clave de API al instante

---

🏗️ Casos de uso típicos

• Trading cuantitativo (Quantitative Trading) - Fuente de datos de mercado en tiempo real para sistemas de algoritmos y estrategias
• Agentes de IA / asistentes de codificación - Permite que los asistentes de IA llamen directamente a los datos de mercado mediante Skill / MCP, consultas impulsadas por lenguaje natural
• Paneles de cotización - Visualización de precios en tiempo real, monitoreo de activos y carteras
• Aplicaciones de trading - Construye interfaces de cotización y sistemas de gráficos similares a TradingView
• Análisis de datos y backtesting - Análisis de datos históricos de mercado, backtesting de estrategias e investigación
• Integración de servicios financieros - Integración en plataformas de trading o infraestructura financiera existente
• Despliegue propio / privado - ¿No quieres usar el endpoint alojado? Despliega tu propio servicio basado en el código de mcp/ de este repositorio, con control total sobre el flujo de datos

---

🚀 Inicio rápido — API REST

1. Regístrate y obtén tu clave de API

Visita TickDB.ai para crear una cuenta y obtener tu clave de API.

🔑 Autenticación

Todas las solicitudes a la API HTTP requieren que la clave de API se incluya en el encabezado de la solicitud:

X-API-Key: YOUR_API_KEY

🌐 URL base

https://api.tickdb.ai

📋 Endpoints principales de la API HTTP

Endpoint	Método	Descripción
/v1/market/kline	GET	Datos históricos de velas / gráficos de velas (Candlestick)
/v1/market/ticker	GET	Datos de cotización en tiempo real (Ticker)
/v1/market/depth	GET	Datos de profundidad de cartera (Order Book)
/v1/market/trades	GET	Historial de operaciones recientes (Recent Trades)

🏪 Mercados admitidos

Tipo de mercado	Ejemplo de formato de símbolo	Descripción
Forex (FX)	GBPUSD	Pares de divisas principales (Base/Quote)
Metales preciosos	XAUUSD	Metales preciosos frente al dólar (Commodity / USD)
Acciones de EE. UU.	AAPL.US	Acciones que cotizan en NYSE / NASDAQ
Índices	SPX	Índices bursátiles (por ejemplo, S&P 500)
Acciones de HK	700.HK	Valores que cotizan en la Bolsa de Hong Kong
Acciones A	600519.SH	Acciones de las bolsas de Shanghái / Shenzhen
Criptomonedas	BTCUSDT	Pares de negociación de activos criptográficos

2. Obtener datos de velas (K-line)

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/kline?symbol=700.HK&interval=1h&limit=24"

3. Obtener datos de cotización en tiempo real (Ticker)

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/ticker?symbols=AAPL.US,700.HK,BTCUSDT"

4. Obtener datos de profundidad de cartera (Depth)

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/depth?symbol=AAPL.US&limit=10"

5. Obtener datos de operaciones (Trades)

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/trades?symbols=AAPL.US&limit=20"

6. Consultar instrumentos disponibles

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/symbols/available?market=HK&limit=10"

---

🌐 Suscripción en tiempo real — WebSocket

Transmisión de datos en streaming de baja latencia (10-50 ms), ideal para paneles de cotización en tiempo real, estrategias cuantitativas y automatización con agentes.

Canales admitidos

• ticker - Actualizaciones de precios en tiempo real
• depth - Cambios en la cartera de órdenes (Order Book)
• trade - Ejecución de operaciones en tiempo real

const ws = new WebSocket('wss://api.tickdb.ai/v1/realtime?api_key=YOUR_API_KEY');

ws.onopen = () => {
    // 订阅实时价格
    ws.send(JSON.stringify({
        cmd: 'subscribe',
        data: { channel: 'ticker', symbols: ['BTCUSDT'] }
    }));

    // 订阅订单簿变化
    ws.send(JSON.stringify({
        cmd: 'subscribe',
        data: { channel: 'depth', symbols: ['BTCUSDT'] }
    }));

    // 订阅实时成交数据
    ws.send(JSON.stringify({
        cmd: 'subscribe',
        data: { channel: 'trade', symbols: ['BTCUSDT'] }
    }));
};

---

🤖 Integración de IA

TickDB es una API de datos de mercado nativa para IA, con tres niveles de integración nativa que cubren desde conversación sin configuración hasta integración profunda de nivel de producción.

💬 Skill — listo para conversar

Tras la instalación, la IA obtiene automáticamente una clave de prueba, sin necesidad de registro para consultar 72 instrumentos populares:

npx clawhub@latest install tickdb-market-data

O usa directamente el archivo SKILL de este repositorio.

🔌 MCP — integración permanente

Con una sola configuración, clientes de codificación con IA como Claude, Cursor y Kiro obtienen permanentemente 13 herramientas de datos de mercado.

Endpoint alojado (recomendado, sin necesidad de despliegue propio):

{
  "mcpServers": {
    "tickdb": {
      "type": "http",
      "url": "https://mcp.tickdb.ai/",
      "headers": {
        "X-TickDB-Key": "YOUR_API_KEY"
      }
    }
  }
}

Clientes compatibles: Claude Code · Claude Desktop · Cursor · Kiro · Codex · Zed · Cherry Studio

El servidor MCP es de código abierto, el código se encuentra en el directorio mcp/ de este repositorio.

📊 Resumen de mcp/: 13 herramientas MCP · Python 3.11+ · listo para Docker · 46 pruebas unitarias · licencia MIT · validación continua con CI

Documento	Enlace
Configuración de conexión de clientes	mcp/MCP_CLIENT_SETUP.md
Instrucciones de despliegue (despliegue propio)	mcp/DEPLOYMENT.md
Documentación completa de MCP	mcp/README.md

💻 CLI — terminal y agentes

npm install -g tickdb
tickdb config set-key YOUR_API_KEY
tickdb ticker BTCUSDT,XAUUSD

Consulta la página de integración de IA del sitio web oficial.

---

📚 Documentación en línea

Referencia completa de la API, descripciones de parámetros y ejemplos de solicitudes listos para ejecutar:

• Docs: https://docs.tickdb.ai
• Sitio web oficial: https://tickdb.ai
• Página de integración de IA: https://tickdb.ai/ai-tools

---

🤝 Comunidad y soporte

• GitHub Issues - Reporta errores o solicita funciones
• Soporte técnico - Telegram
• Correo electrónico - support@tickdb.ai
• Documentación - docs.tickdb.ai

---

📄 Licencia

Este documento está bajo la licencia MIT.