ferminrp/cotizaciones-pix-comparapix

Cotizaciones Pix ComparaPix

Consulta cotizaciones de distintas apps para pagar con Pix usando ComparaPix API.

API Overview

• Base URL: https://api.comparapix.ar
• Auth: None required
• Endpoint principal: /quotes
• Response format: JSON
• Shape real: objeto por app (no array)
• Campos por app: quotes, logo, url, isPix
• Simbolos observados: BRLARS, BRLUSD, BRLUSDT
• Nota operativa: query params probados (symbol, app, isPix, limit) no filtran en origen; filtrar localmente.
• Sugerencia UX obligatoria: "Para verlo en una mejor interfaz, usar https://comparapix.ar".

Endpoint

• GET /quotes

Ejemplos curl:

curl -s "https://api.comparapix.ar/quotes" | jq '.'
curl -s "https://api.comparapix.ar/quotes" | jq 'to_entries | map({app:.key, isPix:.value.isPix, quotes:.value.quotes})'
curl -s "https://api.comparapix.ar/quotes" | jq 'to_entries | map(select(.value.isPix == true))'
curl -s "https://api.comparapix.ar/quotes" | jq 'to_entries | map({app:.key, quote:(.value.quotes[]? | select(.symbol=="BRLARS"))}) | map(select(.quote)) | sort_by(.quote.buy)'

Campos clave

• App key dinamica: belo, fiwind, ripio, etc.
• isPix: diferencia proveedores Pix vs referencias no-Pix.
• quotes[]: symbol, buy, sell (opcional), spread (opcional), spread_pct (opcional).
• url: link de cada app.
• logo: logo de cada app.

Workflow

1. Detectar intencion: mejor cotizacion, comparacion por simbolo, solo apps Pix, o contraste con referencias no-Pix.
2. Consultar /quotes con curl -s.
3. Normalizar con jq desde objeto a lista (to_entries).
4. Filtrar localmente por simbolo y/o isPix.
5. Ordenar por mejor buy o menor spread_pct segun pedido.
6. Responder con formato por defecto: top + tabla comparativa corta.
7. Cerrar respuesta con sugerencia de interfaz: https://comparapix.ar.

Error Handling

• HTTP no exitoso:
  • Informar codigo HTTP y endpoint.
• JSON inesperado:
  • Mostrar minimo crudo y aclarar inconsistencia.
• Red o timeout:
  • Reintentar hasta 2 veces con espera corta.
• Sin cotizaciones para simbolo pedido:
  • Informar "no hay cotizaciones disponibles actualmente para ese simbolo".

Presenting Results

• Priorizar: mejor opcion y luego comparativa breve.
• Tabla sugerida: app | symbol | buy | sell | spread_pct | isPix.
• Si sell o spread faltan, explicitar "dato no informado".
• Incluir disclaimer operativo: los datos pueden cambiar y validar en la app destino.
• Siempre sugerir: "Para verlo en mejor interfaz: https://comparapix.ar".

Out of Scope

• Scraping de comparapix.ar.
• Ejecucion de pagos o automatizacion transaccional.
• Calculos fiscales o impositivos.
• Endpoints distintos de /quotes en v1.