API gratuita del dinar argelino

Tu primera solicitud

Copia este ejemplo en tu terminal para convertir 100 euros a dinares al tipo de compra orientativo del mercado paralelo.

curl 'https://easyalgerie.com/api/v1/dinar/convert?amount=100&from=EUR&to=DZD&market=parallel_buy'

Dos endpoints, un formato sencillo

URL base : https://easyalgerie.com/api/v1/dinar

GET /rates — Consultar tipos de cambio

Los tipos se expresan en DZD por 1 unidad de divisa extranjera. Sin filtro, la respuesta incluye las 11 divisas disponibles.

curl 'https://easyalgerie.com/api/v1/dinar/rates?currency=EUR'

currency

Opcional: código de una divisa extranjera, como EUR o USD. No uses DZD.

GET /convert — Convertir un importe

Convierte una divisa a dinares o dinares a una divisa. Exactamente una de las dos debe ser DZD: no se admite la conversión directa EUR/USD.

amount

Obligatorio. De 0 a 1.000.000.000, usando un punto decimal y hasta 6 decimales. Sin separadores de miles ni notación exponencial.

from / to

Obligatorios. Códigos ISO de las divisas de origen y destino. Exactamente una debe ser DZD.

market

Opcional. official, parallel_buy o parallel_sell. Valor predeterminado: parallel_buy.

Los códigos de divisa no distinguen mayúsculas y minúsculas. Se rechazan los parámetros desconocidos o duplicados.

Divisas admitidas

DZDEURUSDCADGBPCHFTRYCNYSARAEDTNDMAD

Origen y actualidad de los datos

provider

Tipo de cambio recibido de un proveedor externo.

editorial

Tipo editorial del conversor público, incluidos los valores introducidos manualmente por EasyAlgerie.

fallback

Valor estático de respaldo. No lo presentes como un tipo de cambio actual.

Consulta sourceUpdatedAt para ver la fecha de la fuente: null significa que se desconoce. Para los tipos manuales, es la fecha de edición en UTC, no una observación independiente del mercado. retrievedAt indica cuándo se obtuvo la instantánea de datos, no cuándo se fijó el tipo.

Las fuentes externas se almacenan en caché durante 6 horas. Los tipos manuales tienen prioridad y su caché se invalida al guardar (duración de respaldo: 30 segundos). refreshIntervalSeconds se refiere a las fuentes externas.

Las conversiones son orientativas, sin transacciones ni garantía de cambio. Los tipos públicos son independientes de los tipos comerciales usados en los pagos de EasyAlgerie.

Límites y gestión de errores

60 solicitudes por minuto y dirección IP, compartidas entre /rates y /convert. Las cabeceras RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset indican la cuota. Guarda los tipos en caché para cálculos repetidos.

400

Parámetros no válidos: consulta error.code, error.message y error.field.

405

Método no permitido. Usa GET para leer datos.

429

Cuota superada: espera los segundos indicados en Retry-After.

503

Datos no disponibles temporalmente. Reinténtalo más tarde, sin bucles rápidos.

CORS público: se permiten solicitudes desde el navegador sin enviar cookies ni credenciales. No se necesita ninguna clave API secreta.

Ejemplo JavaScript

const url = new URL("https://easyalgerie.com/api/v1/dinar/convert");
url.search = new URLSearchParams({
  amount: "100", from: "EUR", to: "DZD", market: "parallel_buy"
}).toString();

const response = await fetch(url, { credentials: "omit" });
if (response.status === 429) {
  throw new Error("Retry after " + response.headers.get("Retry-After") + " seconds");
}
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || "API unavailable");

console.log(data.result, data.to);
console.log(data.provenance);

Conectar un agente de IA

1. Importa la especificación OpenAPI en una herramienta compatible, sin autenticación. No todos los agentes admiten la importación automática.
2. Usa getDinarExchangeRates para consultar tipos y convertAlgerianDinars para convertir. Indica explícitamente el mercado elegido.
3. Comprueba el origen y las fechas antes de responder. No presentes tipos editoriales o de respaldo como cotizaciones en tiempo real.
4. Aclara los importes ambiguos: 1 DZD = 100 céntimos. Si el cliente habla de «millones», pregunta si se refiere a dinares o céntimos.