الأدلةدروس

كيفية جلب أسعار الصرف إلى Excel باستخدام Power Query

الصق استعلام M في Excel لتحميل جدول أسعار يمكن تحديثه. يشرح هذا الدليل مسارًا كاملًا: صيغ بسيطة للتحويل، وPower Query لجلب البيانات، وطريقة لحفظ التاريخ والمصدر مع النتيجة.

1 أكتوبر 2026 · قراءة 5 دقائق

استخدم Power Query لتحميل جدول الأسعار، واستخدم صيغ الخلايا لتحويل المبالغ. يستدعي الاستعلام /v1/latest/USD ويحوّل JSON إلى جدول من عمودين، ثم يتحدث عند فتح المصنف أو الضغط على تحديث الكل. إذا احتجت سعر يوم محدد، استخدم الأداة التاريخية واحفظ التاريخ والمصدر مع النتيجة. لشرح صيغ التحويل مع مثال قابل للتعديل، راجع دليل تحويل العملات في Excel بالإنجليزية. وللبحث عن تاريخ محدد، استخدم أداة الأسعار التاريخية بالإنجليزية واحفظ التاريخ والمصدر مع النتيجة.

  • Power Query M مدمج في Excel على Mac وWindows, دون إضافات، ودون WEBSERVICE() المقتصرة على Windows والمعطّلة على Mac.
  • استدعاء واحد لـ/v1/latest/{base} يعيد كل الأسعار؛ افصل عنوان URL الأساسي عن RelativePath كي يستمر التحديث المجدول في العمل.
  • مرّر مفتاحك بصيغة Authorization: Bearer exr_live_...، أو X-API-Key إذا تعذّر على الموصّل ضبط ترويسة Authorization.
  • الخطة المجانية 5,000 استدعاء شهريًا بمعدل 10 طلبات في الدقيقة، دون بطاقة.
  • الأسعار إرشادية, للنمذجة والتحليل والعرض، لا لتسوية صفقة.
  • يمنح المفتاح المجاني 5,000 استدعاء شهريًا و10 طلبات في الدقيقة، دون الحاجة إلى بطاقة.

احصل على مفتاح API مجاني

سجّل في exchangerate.dev/signup. بعد تأكيد البريد تعرض لوحة التحكم مفتاحًا يبدأ بـexr_live_. انسخه؛ ستلصقه في الاستعلام كوسيط. الخطة المجانية 5,000 استدعاء شهريًا دون بطاقة.

افتح محرر Power Query

من شريط Excel، اضغط البيانات ← إحضار البيانات ← تشغيل محرر Power Query. داخل المحرر، اضغط الصفحة الرئيسية ← مصدر جديد ← استعلام فارغ، ثم عرض ← المحرر المتقدم. ستلصق استعلام M في ذلك الصندوق في الخطوة التالية.

الصق استعلام M

استبدل محتوى المحرر بالاستعلام أدناه واضغط تم، ثم أعد تسمية الاستعلام إلى FxRates في الشريط الجانبي. الوسيط RelativePath ليس اختياريًا, بدونه يفشل التحديث المجدول في Microsoft 365 بخطأ في بيانات الاعتماد.

Power Query · Advanced Editor
// excel: Power Query M query "FxRates"// curl-equivalent: https://api.exchangerate.dev/v1/latest/USD// Private workbook only: do not share or export this query with a key.// Replace ApiKey with your exchangerate.dev key from /signuplet    ApiKey = "exr_live_replace_with_your_key_here",    Base = "USD",    Source = Json.Document(        Web.Contents(            "https://api.exchangerate.dev",            [                RelativePath = "v1/latest/" & Base,                Timeout = #duration(0, 0, 0, 10),                Headers = [#"Authorization" = "Bearer " & ApiKey]            ]        )    ),    Rates = Record.ToTable(Source[rates]),    Renamed = Table.RenameColumns(Rates, {{"Name", "currency"}, {"Value", "rate"}})in    Renamed

حمّل إلى ورقة عمل واختر «مجهول»

اضغط الصفحة الرئيسية ← إغلاق وتحميل. يضع Excel جدولًا من عمودين, العملة والسعر, في ورقة جديدة. في أول تشغيل يسأل Excel عن طريقة المصادقة مع المصدر https://api.exchangerate.dev: اختر مجهول. مفتاحك ينتقل في الترويسة لا في الرابط، لذا «مجهول» هو الخيار الصحيح. اضغط Ctrl+Alt+F5 للتحديث في أي وقت.

غيّر عملة الأساس أو رشّح إلى أزواج قليلة

غيّر Base لإعادة احتساب كل الأسعار مقابل عملة أخرى، أو أضف استعلام symbols لإعادة الأزواج التي تحتاجها فقط, صفوف أقل والاستدعاء نفسه:

Power Query · variants
// Re-base every rate to the euroBase = "EUR"// Return only the quote currencies you need (one call, fewer rows)RelativePath = "v1/latest/USD",Query = [symbols = "EUR,GBP,JPY"]// One pair, rate calculated for youRelativePath = "v1/convert/USD/JPY/1"   // read Source[rate]
تبني هذا بمساعدة مساعد ذكاء اصطناعي؟

ينشر exchangerate.dev خادم MCP وملف llms.txt، فيستطيع Claude أو Cursor أو ChatGPT قراءة المخطط الحي وكتابة الاستعلام نيابة عنك. اطلب منه: «اكتب استعلام Power Query M في Excel يجلب أسعار USD من exchangerate.dev مع وضع مفتاحي في ترويسة Authorization، واستخدم RelativePath كي يعمل التحديث». راجع دليل MCP.

التحديث والاستيعاب ضمن الخطة المجانية

لا يستطلع Excel من تلقاء نفسه. يتحدّث الجدول عند فتح المصنّف، أو بالضغط على تحديث الكل، أو بضبط تحديث دوري من البيانات ← الاستعلامات والاتصالات ← الخصائص. الحساب يبقى مريحًا داخل الخطة المجانية:

  • 5,000 استدعاء شهريًا، 10 طلبات في الدقيقة، دون بطاقة
  • النموذج المعتاد يطلق بضعة استدعاءات يوميًا (عند الفتح ومع تحديثات يدوية قليلة)
  • حتى التحديث التلقائي كل 5 دقائق خلال ساعات السوق يقارب 100 استدعاء يوميًا
  • يغطي /v1/latest و/v1/convert و/v1/range و/v1/{date}/{base}
الرمزالعَرَضالمعالجة
401DataSource.Error: 401المفتاح مفقود أو غير صالح. أعد لصقه في ApiKey، ثم امسح أي بيانات اعتماد محفوظة من البيانات ← إحضار البيانات ← إعدادات مصدر البيانات لـapi.exchangerate.dev.
429429 Too Many Requestsتجاوزت حد 10 طلبات في الدقيقة. وزّع التحديثات بين الاستعلامات، أو ارتقِ بالخطة من /pricing.
—يطلب Excel بيانات الاعتماد مرارًااتصلت بالرابط الكامل بدل استخدام RelativePath. انسخ الاستعلام أعلاه بعنوان الأساس المفصول، واختر «مجهول».
أسعار إرشادية لا تصلح للتسوية

تُنشر هذه الأسعار للنمذجة والتحليل والعرض. ليست تسعيرة تداول, لا تستخدمها لتسوية صفقة أو تحويل. يذكر كل رد ذلك في حقل notice الخاص به.

جرّب نقطة النهاية قبل بناء الاستعلام

يمكنك استدعاء /v1/latest/USD دون مفتاح ورؤية JSON بالبنية نفسها التي يحلّلها استعلام M. وعندما يبدو صحيحًا، يمنح المفتاح المجاني مصنّفك حصته الخاصة: 5,000 استدعاء شهريًا؛ دون بطاقة.

أسئلة

هل يمكن أن يبنيه لي Claude أو Cursor أو ChatGPT؟

نعم. ينشر exchangerate.dev خادم MCP وملف llms.txt، فيستطيع مساعد الذكاء الاصطناعي قراءة المخطط الحي وأشكال نقاط النهاية. اطلب منه كتابة استعلام Power Query M في Excel يجلب الأسعار من exchangerate.dev مع مفتاحك في ترويسة Authorization واستخدام RelativePath كي يعمل التحديث. ولأنه يقرأ المخطط الفعلي، فإنه يستخدم أسماء الحقول الصحيحة من أول محاولة.

هل هذا مناسب لنموذج مالي في Excel؟

نعم؛ وهذا هو الاستخدام الأساسي. اتصال Power Query يمنح نموذج التدفقات النقدية المخصومة أو ورقة التحوّط أو قائمة الأرباح والخسائر متعددة العملات مدخلًا للعملات يتحدّث عند فتح المصنّف، بدل سعر ثابت يتقادم. وجّه خلية إلى جدول الأسعار المحمّل فيعيد النموذج الحساب من بيانات حالية.

هل يعمل على Mac؟

نعم. Power Query M هو المسار على المنصتين. الدالة القديمة WEBSERVICE() مقتصرة على Windows ومعطّلة على Mac، لذا يتجنبها هذا الدليل. استعلام M أعلاه يعمل بصورة متطابقة على Excel في macOS وWindows.

هل يمكنني استخدام هذه الأسعار في منتج تجاري؟

تسمح المجانية بالاستخدام التجاري مع رابط إسناد ظاهر، والمدفوعة بلا إسناد. إعادة توزيع البيانات أو بيعها تحتاج اتفاقاً مكتوباً: hello@exchangerate.dev.

كيف أجلب زوج عملات واحدًا فقط؟

أضف مرشّح symbols إلى نقطة النهاية latest، مثل /v1/latest/USD?symbols=JPY، ثم اقرأ rates.JPY. أو استدعِ /v1/convert/USD/JPY/1 الذي يعيد السعر والمبلغ المحوّل في رد واحد.

ما حدود المفتاح المجاني؟

يمنح المفتاح المجاني 5,000 استدعاء شهريًا و10 طلبات في الدقيقة. عند استخدام التحديث المجدول، اجمع العملات في استعلام واحد وراقب الاستخدام.

تابع القراءة

ابدأ بمفتاح API مجاني

5,000 طلب شهريًا ضمن الخطة المجانية. لا حاجة إلى بطاقة ائتمان.

احصل على مفتاح مجاني