¿Qué hace Finanzas y datos FX?
Obtén tipos de cambio y precios de criptomonedas con llamadas sin clave. El error que esto previene: recurrir a exchangerate.host, Fixer o Alpha Vantage desde la memoria de entrenamiento — ahora todos requieren clave — o inventar una tasa desactualizada a partir de datos de entrenamiento para un cálculo real.
APIs clasificadas
- Frankfurter (api.frankfurter.dev) — POR DEFECTO para FX fiduciario. Tipos de referencia del Banco Central Europeo, ~30 monedas principales, historial desde 1999, series temporales, sin clave, sin límite de tasa preocupante.
- CoinGecko nivel gratuito (api.coingecko.com) — precios de criptomonedas, capitalizaciones de mercado, cambio en 24h para miles de monedas. Sin clave, pero con un límite ajustado: aproximadamente 5-15 llamadas/min desde una IP anónima. Agrupa ids en una sola llamada; en caso de 429, espera 60s.
Procedimiento
- ¿Fiduciario o cripto? Fiduciario → Frankfurter. Cripto → CoinGecko. La conversión cripto→fiduciario es una sola llamada a CoinGecko (
vs_currencies=eur), no dos saltos. - Fecha de la tasa. Las tasas de referencia del BCE se actualizan ~16:00 CET en días hábiles; el campo
datede la respuesta indica qué día obtuviste realmente. Las solicitudes de fin de semana/festivos devuelven el día hábil anterior — cita esa fecha, no la presentes como si fuera hoy. - Usa ids de CoinGecko, no tickers. El parámetro
idsrequierebitcoin,ethereum,solana— no BTC/ETH. Para una moneda desconocida, resuélvela una vez mediante/api/v3/search?query={nombre}→coins[0].id. - Nunca hagas matemáticas FX de memoria. Si la tarea multiplica dinero por una tasa, la tasa proviene de una de estas llamadas, con la fecha adjunta.
Pregunta al usuario solo si falta: par de divisas o criptomoneda (sin valor predeterminado), fecha/rango (valor predeterminado: última), cantidad (valor predeterminado: 1).
Plantillas de URL + formas de respuesta reales
Tipo de cambio más reciente:
https://api.frankfurter.dev/v1/latest?base=USD&symbols=EUR,GBP,JPY
{"amount":1.0,"base":"USD","date":"<último día hábil>","rates":{"EUR":0.87352,"GBP":0.74878,"JPY":161.15}}
Convierte una cantidad del lado del servidor con &amount=250 — rates se devuelve premultiplicado.
Histórico / series temporales:
https://api.frankfurter.dev/v1/2024-01-15?base=USD&symbols=EUR ← una fecha
https://api.frankfurter.dev/v1/2024-01-02..2024-01-31?base=USD&symbols=EUR ← rango
https://api.frankfurter.dev/v1/currencies ← mapa código → nombre
Forma del rango: {"rates":{"2024-01-02":{"EUR":0.91274},"2024-01-03":{"EUR":0.91583}}} — clave por fecha, solo días hábiles (un año completo devuelve ~256 puntos diarios; sin claves de fin de semana, así que no trates los vacíos como datos faltantes). Omite la fecha final (/2024-01-02..) para llegar hasta el presente.
Precio al contado de cripto:
https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true
{"bitcoin":{"usd":63289,"usd_24h_change":1.19},"ethereum":{"usd":1790.89,"usd_24h_change":1.90}}
Los ids desconocidos se eliminan silenciosamente de la respuesta — una clave faltante significa un id incorrecto, no un precio nulo.
Tabla de mercado cripto (ranking, capitalización, suministro):
https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1
Array de {"id","symbol","name","current_price","market_cap","market_cap_rank","price_change_percentage_24h","circulating_supply","ath"} — una llamada reemplaza veinte llamadas /simple/price; prefierela para cualquier lista.
Entregable
La tasa o precio con su date/marca de tiempo y fuente nombrada, más la URL exacta utilizada. Cualquier conversión muestra la aritmética: 250 USD × 0.87352 (BCE, <fecha de la tasa>) = 218.38 EUR.
NO USAR — recurre a X en su lugar
- exchangerate.host — cada solicitud ahora requiere una
access_key; verificado que falla sin clave. Frankfurter lo reemplaza. - Fixer, Alpha Vantage, Finnhub, Polygon, OpenExchangeRates — requieren clave; no envíes a un usuario a registrarse cuando Frankfurter/CoinGecko cubren la necesidad.
- Cotizaciones de acciones/renta variable — nada sin clave sobrevive la verificación. Dilo claramente y nombra las opciones de pago en lugar de inventar un precio.
- PIB, inflación, desempleo, series comerciales — government-open-data.
- Asesoramiento financiero — esta habilidad obtiene números; los juicios de compra/venta/asignación están fuera de alcance. Presenta datos, no recomendaciones.
Nivel de calidad
- Cada número lleva su fecha y fuente; ninguna tasa o precio proviene de la memoria de entrenamiento.
- Se respeta el límite de ~30 monedas de Frankfurter — los pares exóticos (ej. NGN, VND) se declaran no compatibles, no se aproximan.
- Las llamadas a CoinGecko se agrupan; un 429 produce una espera, no un bucle de reintento.
Verificado con fuente y vigencia del proyecto public-apis (MIT).