Mismo mensaje, nuevo formato

Guía práctica para consumir la API Infoway desde C++ con libcurl y batch_kline: obtener velas Kline, gestionar errores, rendimiento y parseo JSON, con WebSocket para actualizaciones en tiempo real.

12 sept 2025 • 4 min de lectura • Equip Q2BSTUDIO

Inteligencia-Artificial-

En este artículo explicamos cómo consumir la API Infoway desde C++ usando libcurl para obtener series K o kline de forma eficiente y segura. La API batch kline expone un endpoint con la plantilla https://data.infoway.io/common/batch_kline/{klineType}/{klineNum}/{codes} donde klineType define la resolución de la vela, klineNum el número de velas solicitadas y codes la lista de símbolos separados por comas codificadas en URL.

Parámetros principales: klineType valores habituales 1 1 minuto, 2 5 minutos, 3 15 minutos, 4 30 minutos, 5 1 hora, 6 2 horas, 7 4 horas, 8 1 día, 9 1 semana, 10 1 mes, 11 3 meses, 12 6 meses. klineNum cantidad máxima por petición 500. codes lista de símbolos como XAUUSD%2CXAGUSD cuando se codifica la coma como %2C. Ejemplo de endpoint para dos símbolos en 1 minuto y 2 velas https://data.infoway.io/common/batch_kline/1/2/XAUUSD%2CXAGUSD

Uso con libcurl: inicializar libcurl una sola vez en la aplicación con curl_global_init, crear un easy handle con curl_easy_init, configurar CURLOPT_URL con la URL final, adjuntar cabeceras HTTP como User-Agent, Accept application/json y la cabecera apiKey con el token proporcionado por Infoway. Registrar una función de callback para recopilar la respuesta y ejecutar curl_easy_perform. Tras la petición comprobar el código HTTP con CURLINFO_RESPONSE_CODE y limpiar recursos con curl_easy_cleanup y finalmente curl_global_cleanup al terminar la aplicación. Para mantener conexiones vivas en peticiones frecuentes habilitar opciones de keepalive como CURLOPT_TCP_KEEPALIVE y CURLOPT_KEEPALIVE_TIME para reducir latencia y costes de reuso TCP. Para muchas conexiones concurrentes valorar la interfaz multi de libcurl y curl_multi_perform.

Buenas prácticas de robustez: detectar HTTP 429 y aplicar política de reintentos con backoff exponencial empezando en 1 segundo y duplicando hasta un máximo razonable como 60 segundos. Manejar errores de red y timeouts. Si se hacen muchas peticiones a distintos símbolos, usar curl_share_init y compartir DNS entre handles con CURLSHOPT_SHARE y CURL_LOCK_DATA_DNS para reducir latencia en resoluciones.

Estructura de la respuesta y parseo: la respuesta principal incluye campos de control y un array data por símbolo. Cada elemento data contiene s identificador del símbolo y respList que es la lista de kline. Cada kline dispone de campos t timestamp en milisegundos, h high, o open, l low, c close, v volumen, vw volumen ponderado o valor acumulado, pc variación porcentual y pca variación absoluta. Para convertir t a fecha local dividir por 1000 para obtener segundos y luego usar las funciones de chrono y localtime de C++ para formatear la fecha y hora a conveniencia.

Si la API devuelve una vela vacía para el periodo en curso es habitual construir la vela provisional tomando el cierre de la vela anterior como open high low close y volumen cero. De este modo se mantiene continuidad en los gráficos y en los cálculos que dependen de la última vela.

VWAP y métricas: cuando se proporciona vm o un acumulado del valor negociado la VWAP se puede calcular como vm dividido por v siempre que v sea mayor que cero. Para medir actividad relativa de una vela se puede normalizar el volumen y calcular un z score usando media y desviación estándar del volumen reciente con la fórmula z = (v - avg) / stddev.

WebSocket para tiempo real: para casos donde se requiere latencia mínima se recomienda consumir el canal WebSocket que ofrece actualizaciones de kline en tiempo real, por ejemplo el endpoint wss posible en la API. Implementar ping cada 30 segundos, manejar pong y reintentos con backoff exponencial en caso de desconexión. En escenarios híbridos es común usar HTTP batch para sincronizaciones periódicas y WebSocket para las actualizaciones en vivo.

Consejos de rendimiento: agrupar símbolos en una misma llamada batch para reducir número de solicitudes, respetar límites de la API y usar serialización y parsing JSON eficientes. Para grandes volúmenes considerar procesar en hilos independientes con colas y controlar el uso de handles de libcurl para evitar fugas y cuellos de botella en I O.

En Q2BSTUDIO somos especialistas en integrar APIs, desarrollar soluciones a medida y diseñar arquitecturas robustas para datos financieros y de mercado. Ofrecemos servicios de aplicaciones a medida y software a medida con especial foco en inteligencia artificial, ciberseguridad, servicios cloud AWS y Azure, servicios de inteligencia de negocio y Power BI. Si necesita una solución de integración personalizada podemos ayudarle con el desarrollo de conectores, procesamiento en tiempo real y dashboards analíticos como parte de nuestros servicios de desarrollo de aplicaciones a medida y de inteligencia artificial para empresas. Contacte con Q2BSTUDIO para diseñar software a medida, agentes IA, estrategias de IA para empresas, ciberseguridad y servicios cloud que garanticen escalabilidad y cumplimiento.

Palabras clave integradas para SEO aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws azure servicios inteligencia de negocio ia para empresas agentes IA power bi

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.