CommunityPesquisa e Análise de Dadosgithub.com

kraine2008-ux/klineapi-skill

KLineAPI - Skill de API de cotação em tempo real para ações A da China: mais de 56 interfaces de dados (cotações em tempo real, pool de limites de alta, quadro de dragão e tigre, fluxo de capital, dados financeiros), com registro gratuito que já libera crédito de uso para todas as interfaces.

O que é klineapi-skill?

Este skill fornece acesso direto à API KLineAPI, uma plataforma especializada em dados de mercado de ações A da China (Shanghai/Shenzhen). Ele oferece mais de 56 endpoints de dados, incluindo cotações em tempo real, candles históricos (K-line), monitoramento de limites de alta/baixa, fluxo de capital, dados financeiros (balanço, DRE, fluxo de caixa), blockboards (LHB), setores temáticos e muito mais. O skill é útil para desenvolvedores, traders quantitativos e entusiastas do mercado de ações chinês que precisam integrar dados de mercado em bots de trading, dashboards ou agentes de IA. Ele suporta plataformas como sistemas baseados em API REST (qualquer linguagem), com exemplos práticos em Python e cURL fornecidos no markdown. O funcionamento é simples: o usuário se registra gratuitamente no site da KLineAPI para obter uma chave de API, que é então usada em todas as requisições. O skill explica como autenticar (via query parameter ou header), fornece snippets de código para consultar cotações, listar limites de alta, fazer análises financeiras e automatizar revisões diárias de fechamento. A versão gratuita já permite testar todos os endpoints (com limite de 100 requisições/dia), enquanto planos pagos (Profissional por ¥49/mês e Empresarial por ¥199/mês) aumentam drasticamente os limites. Para agentes de IA, este skill permite que eles tomem decisões com base em dados de mercado reais, monitorem portfólios, gerem alertas de breakouts ou analisem fundamentos de empresas listadas em tempo real.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add kraine2008-ux/klineapi-skill

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

KLineAPI - Skill de API de Cotações em Tempo Real para Ações A

Resposta em milissegundos · Mais de 56 interfaces de dados · Uma integração cobre todos os cenários Site: https://klineapi.com · Documentação: https://klineapi.com/docs · Registro: https://klineapi.com/register

O KLineAPI é uma interface de dados de cotações de ações A voltada para desenvolvedores e equipes de quant. Ele cobre todos os cenários, como cotações em tempo real, velas históricas, monitoramento de limites de alta, fluxo de capital, dados financeiros, etc. Este Skill fornece um manual de integração pronto para uso e exemplos de código.

Início Rápido

1. Registre-se e obtenha uma Chave de API

Acesse https://klineapi.com/register para se registrar gratuitamente. Após o registro, obtenha sua Chave de API no "Painel do Desenvolvedor" (no formato kline_xxxxxxxx).

Limite de teste do Skill (ativado no registro):

  • ✅ Todas as interfaces liberadas
  • ✅ 100 chamadas por dia / 10 chamadas por minuto
  • ✅ Após exceder, atualize para o Plano Profissional (¥49/mês) ou Empresarial (¥199/mês, por tempo limitado) para aumentar significativamente o limite

2. Método de Autenticação

Todas as interfaces exigem uma Chave de API. Escolha entre duas formas de envio:

# Forma 1: Parâmetro de consulta
curl "https://klineapi.com/v1/quote?key=SUA_CHAVE&code=600519"

# Forma 2: Cabeçalho de requisição
curl -H "X-API-Key: SUA_CHAVE" "https://klineapi.com/v1/quote?code=600519"

3. Exemplo em Python

import requests

CHAVE = "SUA_CHAVE_DE_API"
BASE = "https://klineapi.com"

def obter_cotacao(codigo):
    r = requests.get(f"{BASE}/v1/quote", params={"key": CHAVE, "code": codigo}, timeout=10)
    return r.json()

print(obter_cotacao("600519"))  # Cotação em tempo real da Moutai

Visão Geral das Interfaces (mais de 56, todas categorizadas)

📊 Cotações em Tempo Real (Interfaces Gratuitas)

InterfaceCaminhoDescrição
Cotação em Tempo Real/v1/quoteCotação em tempo real de uma única ação
Cotações em Lote/v1/batchCotações em lote de até 50 ações
Livro de Ordens de Nível 5/v1/orderbookOrdens de compra e venda de nível 5
Dados Intraday/v1/intradayGráfico intraday do dia
Leilão de Abertura/v1/auctionInformações do leilão
Ranking de Alta/v1/topRanking de ganhos do mercado inteiro
Índices de Mercado/v1/indexÍndices como Shanghai, Shenzhen, ChiNext
Histórico de Velas/v1/klineVelas diárias, semanais, mensais e intraday
Pesquisa de Código/v1/searchPesquisa por código/nome da ação
Instantâneo de Cotações A+H/v1/hsgt/ah_spotCotações comparativas A+H

🚀 Limites de Alta

InterfaceCaminhoDescrição
Pool de Limite de Alta/v1/limit_upPool de ações no limite de alta do dia/histórico
Pool de Limite de Baixa/v1/limit_downPool de ações no limite de baixa do dia/histórico
Pool de Rompimento de Limite/v1/limit_up_breakAções que atingiram o limite de alta e depois abriram
Escada de Limites Consecutivos/v1/lianbanEscada hierárquica de limites consecutivos

Todos os quatro pools suportam ?date=AAAA-MM-DD para retroceder dados de dias de negociação históricos

🏷️ Setores e Temas

Setor da Ação /v1/stock_sector · Lista de Setores /v1/board_list · Setores Temáticos /v1/thematic/list · Setores da Indústria /v1/thematic/industry_list · Detalhes do Setor /v1/sector_detail · Limites de Alta por Setor /v1/plates_zt

🐉 Lista de Dragons (LHB)

Lista de Dragons /v1/lhb · Assentos Institucionais /v1/lhb/institution · Estatísticas de Ações Ativas /v1/lhb_active

💰 Fluxo de Capital

Detalhes de Fluxo de Capital da Ação /v1/finance/stock_fund_flow · Ranking de Fluxo de Capital da Ação /v1/moneyflow/rank · Capital Principal /v1/moneyflow/main_rank

🏢 Dados da Empresa

Perfil da Empresa /v1/company/profile (inclui negócio principal, representante legal, tags temáticas) · Detalhes de Dividendos /v1/company/dividend · Dez Maiores Acionistas /v1/company/top10_holder · Dez Maiores Acionistas Flutuantes /v1/company/top10_float_holder · Estrutura de Capital /v1/company/capital_structure · Liberação de Restrições /v1/trade/release

📈 Análise Financeira

Dados Financeiros /v1/finance · Demonstração de Resultados /v1/finance/income · Balanço Patrimonial /v1/finance/balance · Fluxo de Caixa /v1/finance/cashflow · Previsão de Desempenho /v1/finance/forecast · Relatório Rápido de Desempenho /v1/finance/express · Relatório de Desempenho /v1/finance/performance · Análise de Indicadores Financeiros /v1/finance/analysis

💹 Fundos/ETFs

Visão Geral do Fundo /v1/fund/brief · Participações do Fundo /v1/fund/hold · Valor Patrimonial Líquido Histórico /v1/fund/nav · Cotação Panorâmica de ETF /v1/fund/etf_spot · Velas de ETF /v1/etf/kline · Títulos Conversíveis em Tempo Real /v1/bond/realtime

Uso Avançado

Automação de Revisão de Limites de Alta (após o fechamento diário)

import requests
from datetime import date

CHAVE = "SUA_CHAVE"
BASE = "https://klineapi.com"

def revisao_limite_diario(d=None):
    d = d or date.today().isoformat()
    pools = {}
    for nome, caminho in [("Limite de Alta", "limit_up"), ("Limite de Baixa", "limit_down"),
                          ("Rompimento", "limit_up_break"), ("Consecutivos", "lianban")]:
        r = requests.get(f"{BASE}/v1/{caminho}", params={"key": CHAVE, "date": d}, timeout=15)
        pools[nome] = r.json().get("data", {})
    return pools

Monitoramento de Carteira + Verificação Financeira

def monitorar_acao(codigo):
    q = obter_cotacao(codigo)              # Preço em tempo real
    f = requests.get(f"{BASE}/v1/finance/analysis",
                     params={"key": CHAVE, "code": codigo}, timeout=15).json()
    return {"cotacao": q, "financas": f}

Códigos de Erro

CódigoSignificado
200Sucesso
400Erro de parâmetro
401Chave de API inválida
403Permissões do plano insuficientes
429Limite de chamadas excedido (atualize o plano para aumentar)
502Fonte de dados temporariamente indisponível, tente novamente mais tarde

Comparação de Planos

PlanoPreçoLimite DiárioLimite por MinutoPermissões de Interface
Gratuito¥0100 chamadas10 chamadasInterfaces básicas
Versão de Teste do Skill¥0 (registro inclui)100 chamadas10 chamadasTodas as mais de 56 interfaces
Profissional¥49/mês10.000 chamadas100 chamadasTodas as interfaces
Empresarial¥199/mês (preço original ¥299)100.000 chamadasIlimitadoTodas as interfaces

Links

Habilidades Relacionadas