Tu primera llamada es una línea:
Cada gráfico, tabla y medidor en Bitculator se ejecuta con un único motor de datos: precios en vivo actualizados aproximadamente cada minuto, miles de mercados en intercambios, indicadores de sentimiento, indicadores técnicos, liquidaciones, historial del mercado global.
Hoy vamos a abrir ese motor. La Bitculator Data API está en vivo - una API JSON autenticada con Bearer y 85 endpoints en 15 grupos, una capa gratuita, y documentación en 19 idiomas.
Tu primera llamada es una línea:
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, "..." : "..."} }
Crea una clave en tu consola de desarrollador y esa llamada funciona ahora mismo.
Qué puedes obtener
La API está organizada en 15 grupos de recursos, y todo lo que la plataforma muestra está ahí:
- Monedas & precios - el catálogo completo de activos, cotizaciones en vivo, precios históricos, OHLC, datos de suministro.
- Mercados & intercambios - pares, tickers, volúmenes y detalles de los intercambios entre las plataformas que seguimos.
- Carteras - el directorio de carteras con especificaciones y activos soportados.
- Mercado global - capitalización de mercado total, volumen y dominio, incluidas series históricas.
- Sentimiento & indicadores - miedo y codicia, señales de régimen alcista/bajista y indicadores técnicos (RSI, promedios móviles y otros) por activo.
- Liquidaciones - datos de liquidaciones largas y cortas.
- Conversión & calculadoras - conversión cripto↔fiat a tasas en vivo y los endpoints de calculadora de la plataforma.
- Editorial - artículos y contenido del glosario.
- Alarmas & webhooks - crea alarmas de precios a través de la API y recibe entregas de webhooks firmadas cuando se disparan.
- Meta - uso, planes y la especificación legible por máquina.
La referencia completa, con ejemplos ejecutables para cada endpoint, se encuentra en la documentación de la API.
Construido de la manera que te gustaría
Unos pocos principios de diseño que nos negamos a comprometernos:
- Precisión de cadenas decimales. Los precios, tasas y suministros se devuelven como cadenas, nunca como flotantes. Un flotante no puede llevar con fidelidad 0.00000001842, así que no le pedimos que lo haga. Tu analizador conserva cada dígito que produjo el mercado.
- Un único sobre, en todas partes. Las respuestas exitosas son { data, meta }; cada error 4xx o 5xx es { "error": { "code", "message", "details" } }. Coincidir con error.code: los mensajes pueden reformularse, los códigos son estables.
- Tu cuota depende de cada respuesta. Las cabeceras X-Quota-Limit, X-Quota-Used y X-Quota-Reset regresan con cada llamada, así que nunca tendrás que adivinar tu situación; aunque también puedes simplemente consultar GET /usage.
- Límites predecibles. Los límites por página (per_page) son basados en el plan, y exceder un límite devuelve un 422 honesto. La API nunca bloquea silenciosamente tu solicitud y devuelve menos de lo que pediste.
- Webhooks firmados. Las entregas de alarmas traen un encabezado al estilo Stripe X-Bitculator-Signature para que puedas verificar la autenticidad antes de confiar en una carga útil.
- Una especificación pública. Toda la superficie está descrita en la Especificación OpenAPI, y la documentación ofrece una colección de Postman lista para usar.
Planes que comienzan gratis
La Data API tiene su propio cupo mensual, separado de los widgets incrustables de Bitculator. La capa gratuita no necesita tarjeta - obtén una clave y empieza a construir. Los planes pagos aumentan el cupo de llamadas mensuales y el per_page techo; los detalles y los precios actuales están en la página de Data API.
¿No quieres escribir HTTP a mano? Hay un SDK para eso
Junto a la API enviamos ocho SDK oficiales, con licencia MIT - TypeScript, Python, PHP, Go, Rust, Java, C# y C++ - cada uno cubre los 85 endpoints con paginación automática, errores tipados, reintentos inteligentes y la garantía de cadenas decimales incorporada. Los comandos de instalación, logotipos y enlaces a repositorios para los ocho se encuentran en la sección de SDKs de la página de la API, y el código fuente está disponible en github.com/bitculator. Pero para aclarar: no necesitas un SDK. Es HTTP simple con un encabezado Bearer - curl, fetch, requests o Guzzle funcionan exactamente como esperarías.
Empieza a construir
- Echa un vistazo a la página de Data API para planes, cuotas y el inicio rápido.
- Crea tu clave en la consola de desarrollo
- Realiza tu primera llamada, y verifica los encabezados X-Quota-* que acompañan la respuesta.
Construimos esta API porque queríamos que existiera. Si construyes algo con ella, realmente nos encantaría saberlo.


