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)
| Interface | Caminho | Descrição |
|---|---|---|
| Cotação em Tempo Real | /v1/quote | Cotação em tempo real de uma única ação |
| Cotações em Lote | /v1/batch | Cotações em lote de até 50 ações |
| Livro de Ordens de Nível 5 | /v1/orderbook | Ordens de compra e venda de nível 5 |
| Dados Intraday | /v1/intraday | Gráfico intraday do dia |
| Leilão de Abertura | /v1/auction | Informações do leilão |
| Ranking de Alta | /v1/top | Ranking de ganhos do mercado inteiro |
| Índices de Mercado | /v1/index | Índices como Shanghai, Shenzhen, ChiNext |
| Histórico de Velas | /v1/kline | Velas diárias, semanais, mensais e intraday |
| Pesquisa de Código | /v1/search | Pesquisa por código/nome da ação |
| Instantâneo de Cotações A+H | /v1/hsgt/ah_spot | Cotações comparativas A+H |
🚀 Limites de Alta
| Interface | Caminho | Descrição |
|---|---|---|
| Pool de Limite de Alta | /v1/limit_up | Pool de ações no limite de alta do dia/histórico |
| Pool de Limite de Baixa | /v1/limit_down | Pool de ações no limite de baixa do dia/histórico |
| Pool de Rompimento de Limite | /v1/limit_up_break | Ações que atingiram o limite de alta e depois abriram |
| Escada de Limites Consecutivos | /v1/lianban | Escada hierárquica de limites consecutivos |
Todos os quatro pools suportam
?date=AAAA-MM-DDpara 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ódigo | Significado |
|---|---|
| 200 | Sucesso |
| 400 | Erro de parâmetro |
| 401 | Chave de API inválida |
| 403 | Permissões do plano insuficientes |
| 429 | Limite de chamadas excedido (atualize o plano para aumentar) |
| 502 | Fonte de dados temporariamente indisponível, tente novamente mais tarde |
Comparação de Planos
| Plano | Preço | Limite Diário | Limite por Minuto | Permissões de Interface |
|---|---|---|---|---|
| Gratuito | ¥0 | 100 chamadas | 10 chamadas | Interfaces básicas |
| Versão de Teste do Skill | ¥0 (registro inclui) | 100 chamadas | 10 chamadas | Todas as mais de 56 interfaces |
| Profissional | ¥49/mês | 10.000 chamadas | 100 chamadas | Todas as interfaces |
| Empresarial | ¥199/mês (preço original ¥299) | 100.000 chamadas | Ilimitado | Todas as interfaces |
Links
- 🌐 Site: https://klineapi.com
- 📖 Documentação da API: https://klineapi.com/docs
- 🚀 Registro e Teste: https://klineapi.com/register
- 💬 Contato e Suporte: https://klineapi.com/contact