Apresentando o Bitculator Data API

Cada gráfico, tabela e medidor no Bitculator operam com um único motor de dados: preços ao vivo atualizados aproximadamente a cada minuto, milhares de mercados em várias bolsas, indicadores de sentimento, indicadores técnicos, liquidações, histórico do mercado global.

Hoje vamos abrir esse motor. A Bitculator Data API está no ar - uma API JSON com autenticação Bearer, com 85 endpoints em 15 grupos, um plano gratuito e documentação em 19 idiomas.

Sua primeira chamada é uma linha:

curl "https://bitculator.com/api/v1/coins?per_page=5" \\-H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : "..."} }

Crie uma chave no seu console do desenvolvedor e essa chamada funciona agora mesmo. 

A API está organizada em 15 grupos de recursos, e tudo o que a plataforma mostra está ali:

• Moedas e preços - o catálogo completo de ativos, cotações ao vivo, preços históricos, OHLC, dados de oferta.
• Mercados e bolsas - pares, tickers, volumes e detalhes das bolsas onde monitoramos.
• Carteiras - o diretório de carteiras com especificações e ativos suportados.
• Mercado global - capitalização de mercado total, volume e domínio, incluindo séries históricas.
• Sentimento e indicadores - medo e ganância, sinais de regimes de touros/ursos, e indicadores técnicos (RSI, médias móveis e outros) por ativo.
• Liquidações - dados de liquidação de posições longas e curtas.
• Conversão e calculadoras - conversão de criptomoeda↔fiat em taxas ao vivo e os endpoints da calculadora da plataforma.
• Editorial - artigos e conteúdo de glossário.
• Alarmes e webhooks - crie alarmes de preço via a API e receba entregas de webhooks assinadas quando forem acionados.
• Meta - uso, planos e a especificação legível por máquina.

A referência completa, com exemplos executáveis para cada endpoint, está na especificação OpenAPI, e a documentação oferece uma coleção Postman pronta para uso.

Algumas decisões de design às quais nos recusamos a ceder:

• Precisão de string decimal. Preços, taxas e suprimentos são retornados como strings, nunca números em ponto flutuante. Um float não consegue levar fielmente 0.00000001842, então não pedimos que ele o faça. Seu parser mantém cada dígito que o mercado produziu.
• Um envelope, em todo lugar. Respostas bem-sucedidas são { data, meta }; cada erro 4xx ou 5xx é { "error": { "code", "message", "details" } }. Combinar com error.code: as mensagens podem ser reformuladas, os códigos são estáveis.
• Sua cota depende de cada resposta. Os cabeçalhos X-Quota-Limit, X-Quota-Used e X-Quota-Reset retornam em cada chamada, então você nunca precisa adivinhar onde está—embora você possa também apenas consultar GET /usage. 
• Limites previsíveis. limites por_page são baseados no plano, e exceder um limite retorna um 422 honesto. A API nunca restringe silenciosamente sua requisição e devolve menos do que você pediu.
• Webhooks assinados. as entregas de alarmes carregam um cabeçalho X-Bitculator-Signature no estilo Stripe para que você possa verificar a autenticidade antes de confiar no payload.
• Uma especificação pública. Toda a superfície é descrita na especificação OpenAPI, e a documentação oferece uma coleção Postman pronta para uso.

O Data API tem sua própria cota mensal, separada dos widgets incorporáveis da Bitculator. O nível gratuito não requer cartão - pegue uma chave e comece a construir. Planos pagos aumentam o pool mensal de chamadas e o teto de per_page; os detalhes e os preços atuais estão na página da Data API.

Ao lado da API, enviamos oito SDKs oficiais, licenciados sob MIT - TypeScript, Python, PHP, Go, Rust, Java, C# e C++ - cada um cobrindo todos os 85 endpoints com paginação automática, erros tipados, tentativas inteligentes e a garantia de string decimal embutida. Comandos de instalação, logos e links para o repositório de todos os oito estão na seção de SDKs da página da API, e o código-fonte está aberto em github.com/bitculator. Mas para ficar claro: você não precisa de um SDK. É HTTP simples com um cabeçalho Bearer - curl, fetch, requests ou Guzzle funcionam exatamente como você esperaria.

1. Faça uma leitura rápida da página da Data API para planos, quotas e o guia rápido.
2. Crie sua chave no console de desenvolvedor
3. Faça sua primeira chamada - e verifique os cabeçalhos X-Quota-* que acompanham.

Construímos esta API porque queríamos que ela existisse. Se você construir algo com ela, ficaríamos verdadeiramente felizes em ouvir.