TickDB MCP

Cobre Forex/FX · Metais Preciosos · Índices · Ações dos EUA (NASDAQ/NYSE) · Ações de HK · Ações A/CN · Criptomoedas através de 13 ferramentas MCP apoiadas por uma API REST.

GitHub

845

Experimente este MCPPatrocinado

Documentação

TickDB — API de dados de mercado em tempo real unificada para Forex, Ações e Cripto

Uma conexão para Forex, Metais Preciosos, Índices, Ações dos EUA, Ações de HK, A-Shares e Cripto

Conjunto de ferramentas de código aberto · Documentação completa da API + AI Skill + Implementação do servidor MCP

Versão do idioma: 🇨🇳 简体中文 • 🇹🇼 繁體中文 • 🇺🇸 English

📚 Documentação online • 🌐 Site oficial • 🤖 Integração AI ↓

🎯 O que é o TickDB?

O TickDB é uma API de dados de mercado em tempo real nativa para IA (AI-native real-time market data API) voltada para desenvolvedores, agentes de IA e aplicações financeiras multi-mercado.

Através de uma única conexão (one connection), você acessa sem interrupções dados de mercado em tempo real e históricos de múltiplos mercados financeiros, incluindo Forex, Metais Preciosos, Índices, Ações dos EUA (NASDAQ / NYSE), Ações de HK, A-Shares e Criptomoedas.

O TickDB foi construído para desenvolvedores que precisam de dados de mercado confiáveis, de baixa latência e com suporte de longo prazo, ajudando você a evitar a complexidade de gerenciar múltiplas fontes de dados, protocolos e fornecedores, permitindo que você se concentre no seu negócio e nas suas estratégias.

Suporta várias formas de dados de mercado, incluindo execuções em nível de tick (trades), profundidade do livro de ordens (order book / depth), candles (candlestick) e muito mais, acessíveis via REST API e WebSocket, cobrindo cenários de negociação quantitativa, agentes de IA, sistemas de mercado em tempo real, plataformas de negociação e análise de dados.

🚀 Integração rápida

📦 Este repositório fornece o código-fonte completo: SKILL/ (configuração de AI Skill) · mcp/ (servidor MCP em Python, 13 ferramentas · Dockerfile · 46 testes unitários · CI · MIT). O endpoint hospedado mcp.tickdb.ai é executado com base no código de mcp/ — o que você vê, o que você implementa e o que a equipe oficial executa é o mesmo código.

Escolha uma das formas de integração que melhor se adequa a você:

Forma	Indicado para	Descrição
💬 Skill	Uso imediato via conversa com IA, zero configuração	Instalação com um comando via npx, a IA obtém automaticamente uma chave de teste
🔌 MCP	Clientes de codificação com IA / implantação autônoma de código aberto	Endpoint hospedado + configuração JSON, ou auto-implementação com base em `mcp/`
💻 CLI	Terminal / scripts / agentes de IA	Instalação global via npm, consulta direta de dados de mercado pela linha de comando
🔧 REST API	Integração de aplicações	API HTTP + 6 exemplos de endpoints
🌐 WebSocket	Dados em tempo real via streaming	Assinatura de baixa latência para ticker / depth / trade

✨ Principais características

🔌 Acesso unificado - Uma única API cobre Forex, metais preciosos, índices, ações dos EUA, ações de HK, A-Shares e criptomoedas
⚡ Dados em tempo real - Stream via WebSocket, latência de ponta a ponta de aproximadamente 10-50ms
🤖 Nativo para IA - A oferta oficial inclui Skill / MCP / CLI para integração com IA, pronto para uso em agentes de IA e assistentes de codificação
🛠️ Amigável para desenvolvedores - API RESTful + WebSocket, respostas JSON estruturadas, documentação completa e exemplos em múltiplos idiomas
🌍 Cobertura global - Mais de 37.527 instrumentos, 6 grandes mercados (US/HK/CN + Forex/Crypto/Indices)
🆓 Comece gratuitamente - Sem necessidade de cartão de crédito, obtenha sua chave de API imediatamente

🏗️ Casos de uso típicos

Negociação quantitativa (Quantitative Trading) - Fonte de dados de mercado em tempo real para sistemas de algoritmos e estratégias
Agentes de IA / Assistentes de codificação - Através de Skill / MCP, permita que assistentes de IA consultem diretamente dados de mercado, com consultas orientadas por linguagem natural
Painéis de mercado - Exibição de preços em tempo real, monitoramento de ativos e carteiras
Aplicações de negociação - Construa interfaces de mercado e sistemas de gráficos semelhantes ao TradingView
Análise de dados e backtesting - Análise de dados históricos, backtesting de estratégias e pesquisas
Integração de serviços financeiros - Integre a plataformas de negociação existentes ou infraestrutura financeira
Auto-implementação / Privado - Não quer usar o endpoint hospedado? Implante por conta própria com base no código mcp/ deste repositório, com total controle sobre o fluxo de dados

🚀 Início rápido — REST API

1. Registre-se e obtenha sua chave de API

Visite TickDB.ai para criar uma conta e obter sua chave de API.

🔑 Autenticação

Todas as solicitações à API HTTP precisam incluir a chave de API no cabeçalho:

X-API-Key: YOUR_API_KEY

🌐 URL base

https://api.tickdb.ai

📋 Endpoints principais da API HTTP

Endpoint	Método	Descrição
`/v1/market/kline`	GET	Dados históricos de candles (K-line)
`/v1/market/ticker`	GET	Dados de mercado em tempo real (Ticker)
`/v1/market/depth`	GET	Dados de profundidade do livro de ordens (Order Book)
`/v1/market/trades`	GET	Histórico de execuções recentes (Recent Trades)

🏪 Mercados suportados

Tipo de mercado	Exemplo de formato de Symbol	Descrição
Forex (FX)	`GBPUSD`	Principais pares de moedas (Base/Quote)
Metais Preciosos	`XAUUSD`	Metais preciosos vs. dólar (Commodity / USD)
Ações dos EUA	`AAPL.US`	Ações listadas na NYSE / NASDAQ
Índices	`SPX`	Índices de ações (ex.: S&P 500)
Ações de HK	`700.HK`	Títulos listados na Bolsa de Hong Kong
A-Shares	`600519.SH`	Ações das bolsas de Xangai / Shenzhen
Criptomoedas	`BTCUSDT`	Pares de negociação de ativos criptográficos

2. Obter dados de candles (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. Obter dados de mercado em tempo real (Ticker)

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

4. Obter dados de profundidade do livro de ordens (Depth)

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

5. Obter dados de execuções (Trades)

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

6. Consultar instrumentos disponíveis

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

🌐 Assinatura em tempo real — WebSocket

Streaming de dados de baixa latência (10-50ms), ideal para painéis de mercado em tempo real, estratégias quantitativas e automação de agentes.

Canais suportados

ticker - Atualizações de preço em tempo real
depth - Mudanças no livro de ordens (Order Book)
trade - Execuções em tempo 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'] }
    }));
};

🤖 Integração com IA

O TickDB é uma API de dados de mercado nativa para IA, oferecendo três formas nativas de integração, cobrindo desde conversas com zero configuração até integrações profundas em nível de produção.

💬 Skill — Use por meio de conversa

Após a instalação, a IA obtém automaticamente uma chave de teste, permitindo consultar 72 instrumentos populares sem registro:

npx clawhub@latest install tickdb-market-data

Ou utilize diretamente o arquivo SKILL deste repositório.

🔌 MCP — Integração permanente

Configuração única para que clientes de codificação com IA, como Claude, Cursor e Kiro, tenham acesso permanente a 13 ferramentas de dados de mercado.

Endpoint hospedado (recomendado, sem auto-implementação):

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

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

O servidor MCP é de código aberto e está localizado no diretório mcp/ deste repositório.

📊 Visão geral do mcp/: 13 ferramentas MCP · Python 3.11+ · Pronto para Docker · 46 testes unitários · Licença MIT · CI contínuo

Documentação	Link
Configuração de conexão do cliente	mcp/MCP_CLIENT_SETUP.md
Instruções de implantação (auto-implementação)	mcp/DEPLOYMENT.md
Documentação completa do MCP	mcp/README.md

💻 CLI — Terminal & Agent

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

Veja mais na página de integração com IA no site oficial.

📚 Documentação online

Referência completa da API, parâmetros e exemplos de solicitações prontos para execução:

Docs: https://docs.tickdb.ai
Site oficial: https://tickdb.ai
Página de integração com IA: https://tickdb.ai/ai-tools

🤝 Comunidade e suporte

GitHub Issues - Reporte bugs ou solicite recursos
Suporte técnico - Telegram
E-mail - support@tickdb.ai
Documentação - docs.tickdb.ai

📄 Licença

Este documento está licenciado sob a Licença MIT.