EasyAlgerie · Développeurs

API dinar algérien gratuite

Ajoutez les taux du dinar et la conversion de devises à votre site, application ou agent IA. Des réponses JSON simples, sans compte et sans clé API.

Sans authentification
11 devises ↔ DZD
Lecture seule

Votre première requête

Copiez cet exemple dans votre terminal pour convertir 100 euros en dinars au taux indicatif d’achat du marché parallèle.

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

Voir la réponse JSON

Deux endpoints, un format simple

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

GET /rates — Consulter les taux

Les taux sont exprimés en DZD pour 1 unité de devise étrangère. Sans filtre, la réponse contient les 11 devises disponibles.

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

currency: Facultatif : code d’une devise étrangère, par exemple EUR ou USD. Ne pas indiquer DZD.

GET /convert — Convertir un montant

Convertissez une devise en dinars, ou des dinars en devise. Une seule des deux devises doit être DZD : la conversion directe EUR/USD n’est pas prise en charge.

amount: Obligatoire. De 0 à 1 000 000 000, avec un point décimal et jusqu’à 6 décimales. Sans séparateur de milliers ni notation exponentielle.
from / to: Obligatoires. Codes ISO des devises de départ et d’arrivée. Exactement une des deux doit être DZD.
market: Facultatif. official, parallel_buy ou parallel_sell. Valeur par défaut : parallel_buy.

Les codes de devise sont insensibles à la casse. Les paramètres inconnus ou répétés sont refusés.

Devises prises en charge

DZDEURUSDCADGBPCHFTRYCNYSARAEDTNDMAD

Choisir le bon taux

official: Référence bancaire provenant d’un fournisseur de change ; ce n’est pas une offre garantie par une banque.
parallel_buy: Le cambiste achète la devise étrangère au client contre des dinars.
parallel_sell: Le cambiste vend la devise étrangère au client contre des dinars.

Le marché choisi s’applique dans les deux sens de conversion : l’API ne le remplace pas automatiquement par un autre taux.

Comprendre la réponse

result: Montant converti, arrondi au centième (demi vers le haut).
rate: Multiplicateur : 1 unité de from = rate unités de to.
dzdPerUnit: Taux de référence en DZD pour 1 unité de la devise étrangère.
provenance: Origine de la valeur, source et date disponible.

Origine et fraîcheur des données

provider: Taux reçu d’un fournisseur externe.
editorial: Taux éditorial du convertisseur public, notamment saisi manuellement par EasyAlgerie.
fallback: Valeur statique de secours. Ne pas la présenter comme un taux actuel.

Consultez sourceUpdatedAt pour la date de la source : null signifie qu’elle est inconnue. Pour un taux manuel, c’est la date UTC de modification, pas une observation indépendante du marché. retrievedAt désigne la récupération du snapshot, pas la date de fixation du taux.

Les sources externes sont mises en cache pendant 6 heures. Les taux manuels sont prioritaires et leur cache est invalidé à l’enregistrement (durée de secours : 30 secondes). refreshIntervalSeconds concerne les sources externes.

Les conversions sont indicatives, sans transaction ni garantie de change. Les taux publics ne sont pas les taux commerciaux utilisés pour les paiements EasyAlgerie.

Limites et gestion des erreurs

60 requêtes par minute et par adresse IP, partagées entre /rates et /convert. Les en-têtes RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset indiquent le quota. Cachez les taux pour les calculs répétés.

400: Paramètres invalides : lire error.code, error.message et error.field.
405: Méthode non autorisée. Utiliser GET pour consulter les données.
429: Quota dépassé : attendre le nombre de secondes indiqué par Retry-After.
503: Données temporairement indisponibles. Réessayer plus tard, sans boucle rapide.

CORS public : les appels depuis un navigateur sont autorisés, sans envoyer de cookies ni d’identifiants. L’API ne demande aucune clé secrète.

Exemple 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);

Connecter un agent IA

Importez la spécification OpenAPI dans un outil compatible, sans authentification. L’import n’est pas pris en charge automatiquement par tous les agents.
Utilisez getDinarExchangeRates pour lire les taux et convertAlgerianDinars pour convertir. Indiquez explicitement le marché choisi.
Vérifiez la provenance et la date avant de répondre. Ne présentez pas un taux éditorial ou de secours comme un cours en temps réel.
Clarifiez les montants ambigus : 1 DZD = 100 centimes. Si le client parle de « millions », demandez s’il s’agit de dinars ou de centimes.

Ouvrir OpenAPI