واجهة API لأسعار البلاتين: أسعار XPT وXPD اللحظية والتاريخية

أسعار البلاتين والبلاديوم عبر API

تقدّم واجهة API لأسعار البلاتين سعر البلاتين الحالي والتاريخي كبيانات منظَّمة، بصيغة JSON عبر HTTPS عادةً، حتى تستخدمها أداة التسعير لدى شركة إعادة تدوير أو قائمة أسعار صائغ أو أداة تتبع محفظة مستثمر دون نسخ الأرقام من موقع ويب. وعادةً ما يأتي معه البلاديوم، أقرب المعادن إلى البلاتين. ويسعّر MetalAPI كليهما عبر نقاط النهاية وصيغة الاستجابة نفسها التي يستخدمها للذهب والفضة.

ينتمي البلاتين والبلاديوم إلى معادن مجموعة البلاتين الستة (PGMs)، مع الروديوم والروثينيوم والإيريديوم والأوزميوم. ويغطي MetalAPI البلاتين والبلاديوم؛ أما المعادن الأربعة الأخرى فليست ضمن قائمة رموزه.

XPT وXPD هما رمزا ISO 4217 لأونصة تروي واحدة من كل معدن، وينتميان إلى العائلة نفسها التي ينتمي إليها XAU للذهب. والسعر اللحظي هو السعر الفوري: النقطة الوسطى بين سعري الطلب والعرض في سوق ما بين البنوك. وتتضمن كل الخطط الرمزين كليهما، بما فيها Free.

سعر البلاتين لكل أونصة عبر API

كما هو الحال مع الذهب والفضة، يُسعَّر البلاتين والبلاديوم لكل أونصة تروي (31.1034768 غرامًا) في سوق الجملة، وهذه هي الوحدة الافتراضية في الواجهة. اطلب المعدنين من /latest، والذهب أيضًا إن أردت المقارنة. فالطلب الواحد يكلّف الشيء نفسه مهما كان عدد الرموز التي يُرجعها:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD,XAU" \
  -H "X-API-Key: $METALAPI_KEY"

يظهر كل معدن مرتين. USDXPT هو سعر أونصة تروي واحدة من البلاتين بالدولار الأمريكي، وهو الرقم الذي تعرضه؛ وXPT معكوسه، أي أونصات التروي لكل دولار، ويُحتفظ به للتوافق مع واجهات API على نمط سوق العملات. وهذه هي القيم النموذجية من التوثيق، وليست أسعارًا لحظية:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8,
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89
  }
}

ولعملة أخرى، اضبط base: يُرجع base=EUR المفتاحين EURXPT وEURXPD. وبسعر التوثيق النموذجي البالغ 1.1642 USD لكل يورو، يبلغ سعر البلاتين 1,384.94 EUR والبلاديوم 1,267.65 EUR لكل أونصة تروي. وتعمل جميع العملات الـ57 المدعومة، ويأتي سعر المعدن وسعر الصرف دائمًا من اللقطة نفسها.

سعر البلاتين والبلاديوم لكل غرام

يعمل الصاغة وشركات إعادة التدوير عادةً بالغرام، والمشترون الصناعيون غالبًا بالكيلوغرام. ويحوّل unit الوحدة على الخادم، ويقبل gram وkilogram وounce وpound وmetric_ton وshort_ton إلى جانب القيمة الافتراضية troy_oz:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "unit": "gram",
  "rates": {
    "XPT": 0.01929077235,
    "USDXPT": 51.83825623,
    "XPD": 0.02107567204,
    "USDXPD": 47.44807179
  }
}

أي 51.84 USD لكل غرام من البلاتين و47.45 USD لكل غرام من البلاديوم، أو 51,838.26 و47,448.07 USD لكل كيلوغرام. وينطبق unit على كل معدن في الطلب، وounce تعني أونصة الأفوارديبوا البالغة 28.35 غرامًا، لذا احذف unit، أو مرّر troy_oz، للحصول على أونصة السبائك.

سعرا الطلب والعرض للبلاتين والبلاديوم

من خطة Standard فما فوق، أضف رموز -BID و-ASK إلى currencies لتتلقى جانبي عرض السعر بجوار السعر الوسطي، تحت مفاتيح مثل USDXPT-BID وUSDXPT-ASK:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPT-BID,XPT-ASK,XPD,XPD-BID,XPD-ASK" \
  -H "X-API-Key: $METALAPI_KEY"

يُتداول البلاتين والبلاديوم بأحجام أصغر بكثير من الذهب، لذا تكون فوارقهما عادةً أوسع بالنسبة المئوية. وإذا كنت تقدّم أسعار شراء وبيع، فابنها على سعري الطلب والعرض الحقيقيين لا على السعر الوسطي مع هامش ثابت. وسعرا الطلب والعرض جزء من أحدث عرض سعر فقط؛ أما نقاط النهاية التاريخية فتُرجع أسعارًا وسطية. ويشرح مقال السعر الفوري والطلب والعرض والفارق كيف يبني التجار عروض أسعارهم عليها.

أسعار البلاتين والبلاديوم التاريخية

يعود السجل اليومي للمعدنين إلى عام 2000، ويمكن لكل خطة الاستعلام عنه كله. وتغطي أربع نقاط نهاية العمل على البيانات التاريخية:

• /historical، أو التاريخ نفسه في المسار، لأسعار إغلاق يوم واحد.
• /timeframe لأسعار الإغلاق اليومية على مدى نطاق: حتى 30 يومًا لكل طلب في Free و365 يومًا في الخطط المدفوعة.
• /change لسعر البداية وسعر النهاية والتغير المطلق والتغير بالنسبة المئوية بين تاريخين.
• /ohlc لسعر الافتتاح والأعلى والأدنى والإغلاق ليوم ما.

في الميزانيات وعقود التوريد، كثيرًا ما يكون المتوسط أنفع من سعر يوم واحد. وفي الخطط المدفوعة يُرجع طلب /timeframe واحد حتى 365 سعر إغلاق يومي، وهذا يكفي لمتوسط شهري أو ربع سنوي في استدعاء واحد.

# Closing prices on one day, per gram
curl "https://metalapi.com/api/v1/2024-01-15?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

# Change since the start of the year (a range longer than 30 days needs a paid plan)
curl "https://metalapi.com/api/v1/change?currencies=XPT,XPD&start_date=2026-01-02&end_date=2026-10-23" \
  -H "X-API-Key: $METALAPI_KEY"

لا توجد أسعار إغلاق في عطلات نهاية الأسبوع وعطلات السوق، وقد تغيب هذه الأيام عن السلسلة، لذا لا تفترض وجود مُدخل لكل يوم تقويمي. وللسجلات الأطول، كرّر الطلب على النطاق سنةً بسنة. وأسعار المعادن قبل أكتوبر 2026 مشتقة من العقود الآجلة للشهر الأقرب، لذا قد تختلف قليلًا عن السعر الفوري في اليوم نفسه. ويتناول دليل البيانات التاريخية النطاقات وشموع OHLC والتقسيم إلى صفحات بالتفصيل.

مقارنة البلاتين والبلاديوم بالذهب

نسب الأسعار هي أبسط طريقة لمقارنة المعادن: اقسم سعرًا لكل أونصة على آخر. وعندما يأتي السعران من الاستجابة نفسها، تكون النسبة واحدة في كل العملات والوحدات. وبالأسعار النموذجية من التوثيق:

عند هذه الأسعار تشتري أونصة الذهب الواحدة نحو 2.48 أونصة من البلاتين، ويكلّف البلاتين نحو 40% من سعر الذهب للأونصة. وهذه العلاقات ليست مستقرة: فعلى مدى السجل المتاح في الواجهة، تغيّر ترتيب المعادن الثلاثة أكثر من مرة. لا تُثبّت في منطق التسعير افتراضات مثل «البلاتين أرخص من الذهب»؛ بل اجلب السلسلة وانظر بنفسك. والنسب أيضًا وسيلة رخيصة للتحقق من البيانات: فالنسبة البعيدة جدًا عن نطاقها الأخير تعني عادةً سعرين بوحدتين أو عملتين مختلفتين، لا حدثًا في السوق.

يجلب هذا السكربت أسعار الإغلاق اليومية لمدة 30 يومًا، وهو ما يقع ضمن حد النطاق في خطة Free، ويطبع النسب الثلاث لكل يوم تداول:

const url = new URL("https://metalapi.com/api/v1/timeframe");
url.search = new URLSearchParams({
  currencies: "XAU,XPT,XPD",
  start_date: "2026-09-24",
  end_date: "2026-10-23", // 30 days: within the Free plan's range limit
});

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);

const ratio = (a, b) => (a / b).toFixed(3);
for (const [date, r] of Object.entries(data.rates)) {
  if (!r.USDXAU || !r.USDXPT || !r.USDXPD) continue; // skip incomplete days
  console.log(date, "Au/Pt", ratio(r.USDXAU, r.USDXPT), "Au/Pd", ratio(r.USDXAU, r.USDXPD), "Pt/Pd", ratio(r.USDXPT, r.USDXPD));
}
// With the example prices: Au/Pt 2.480, Au/Pd 2.709, Pt/Pd 1.093

شغّل الحساب نفسه على بيانات /timeframe لعدة سنوات وستحصل على رسم بياني للنسب. ويطبّق مقال نسبة الذهب إلى الفضة الفكرة نفسها على الفضة.

من يستخدم واجهة API لأسعار البلاتين والبلاديوم

شركات إعادة تدوير المحولات الحفازة. تُعد محفزات عوادم المركبات من أهم استخدامات البلاتين والبلاديوم، والمحولات المستهلكة مصدر مهم لمعادن مجموعة البلاتين المعاد تدويرها. وتعتمد قيمة المحول على كمية البلاتين والبلاديوم والروديوم التي تحتويها ركيزته، وهي تختلف بحسب الطراز، لذا تعتمد شركات إعادة التدوير على التحاليل المخبرية وتدفع حصة من قيمة المعدن بعد خصم رسوم التكرير والمعالجة. وتوفّر واجهة API للأسعار جانب المعدن في هذا الحساب. ولا يسعّر MetalAPI الروديوم، لذا خذه من مصدر آخر إذا احتاج إليه نموذجك:

import os
from decimal import Decimal

import requests

# Assayed PGM content of one lot, in grams, and the share of metal value you pay.
# Placeholders: use your own assay results and refining contract terms.
LOT_GRAMS = {"XPT": Decimal("120"), "XPD": Decimal("310")}
PAYABLE = Decimal("0.80")

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"currencies": ",".join(LOT_GRAMS), "unit": "gram", "base": "EUR"},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json(parse_float=Decimal)
if not data["success"]:
    raise RuntimeError(data["error"])

total = Decimal("0")
for symbol, grams in LOT_GRAMS.items():
    price = data["rates"]["EUR" + symbol]  # EUR per gram
    value = grams * price * PAYABLE
    total += value
    print(f"{symbol}: {grams} g x {price:.4f} EUR/g x {PAYABLE} = {value:.2f} EUR")

print(f"Payable Pt + Pd: {total:.2f} EUR at prices of {data['date']} (rhodium priced separately)")

بأسعار التوثيق النموذجية وسعر صرف اليورو فيه، تبلغ قيمة الدفعة الافتراضية 14,382.06 EUR. والكميات والحصة المستحقة الدفع للتوضيح فقط؛ أما أرقامك فتأتي من التحاليل المخبرية ومن عقد التكرير الخاص بك.

الصاغة. تُصنع مجوهرات البلاتين عادةً بدرجة نقاوة عالية، مثل 950 جزءًا من الألف، ويُستخدم البلاديوم في مجوهراته الخاصة وكذلك معدنًا للسبك في الذهب الأبيض. ونقطة النهاية /carat مخصصة للذهب فقط، لذا سعّر البلاتين بحسب النقاوة بنفسك: قيمة المعدن لكل غرام = السعر لكل غرام × النقاوة ÷ 1,000. وبالسعر النموذجي، تبلغ قيمة المعدن في البلاتين 950 نحو 49.25 USD للغرام، قبل أجور الصياغة والضرائب.

المشترون الصناعيون. إلى جانب محفزات المركبات، يدخل البلاتين والبلاديوم في محفزات الصناعات الكيميائية والتكرير، وإنتاج الزجاج، والإلكترونيات، وسبائك طب الأسنان، وخلايا الوقود. وتستخدم فرق المشتريات /change لتحركات الفترات ومتوسطات /timeframe للميزانيات والتحقق من العقود. وتنبّه تنبيهات الأسعار، المتاحة في الخطط المدفوعة لأي رمز بما في ذلك XPT وXPD، عندما يتجاوز السعر مستوى معيّنًا؛ ويبدأ التسليم عبر خطافات الويب من خطة Advanced.

المستثمرون. تُقيَّم العملات والسبائك والمنتجات المتداولة في البورصة من البلاتين والبلاديوم بالسعر الفوري نفسه. فيقيّم /convert?from=XPT&to=EUR&amount=10 عشر أونصات تروي في استدعاء واحد، ويضع base المحفظة بعملة مالكها، ومن خطة Pro يدفع البث اللحظي التحديثات إليك بدلًا من أن تستطلعها بنفسك.

نصائح عملية

• جمّع المعادن. يكلّف currencies=XAU,XAG,XPT,XPD طلبًا واحدًا، بينما تكلّف أربعة استدعاءات منفصلة أربعة طلبات.
• استطلع وفق فترة خطتك. تُحدَّث Free يوميًا، وLite كل 30 دقيقة، وStandard كل 10 دقائق، وAdvanced وPro كل 60 ثانية، وUltra وBusiness كل 15 ثانية، وEnterprise كل 5 ثوانٍ. والطلبات فيما بين ذلك تُرجع اللقطة نفسها وتُحتسب مع ذلك.
• راعِ ساعات السوق. تُغلق سوق المعادن الثمينة الفورية يوم الجمعة الساعة 17:00 بتوقيت نيويورك وتعيد الافتتاح يوم الأحد الساعة 17:00. وخلال عطلة نهاية الأسبوع تواصل الواجهة إرجاع آخر سعر.
• خزّن السياق مع كل سعر: الرمز والوحدة وعملة الأساس وtimestamp. فالرقم دون وحدته لا يمكن إعادة استخدامه بأمان.
• تحقّق من وجود المفاتيح. إذا لم يتوفر أحد جانبي الطلب أو العرض، فإنه يُحذف من rates بدلًا من ضبطه على صفر.
• لوحة أسعار عامة دون شيفرة. تعرض الودجة القابلة للتضمين أسعار البلاتين والبلاديوم اللحظية على موقع ويب دون كشف مفتاح API، وتتضمن خطة Free ودجة واحدة.

ابدأ باستخدام أسعار البلاتين والبلاديوم

سجّل للحصول على مفتاح مجاني واطلب currencies=XPT,XPD لترى المعدنين خلال دقائق. تتضمن خطة Free 100 طلب شهريًا مع تحديثات يومية والسجل الكامل. وعندما تحتاج إلى أسعار أحدث أو الطلب والعرض أو التنبيهات أو البث، تبيّن صفحة الأسعار ما تتضمنه كل خطة، وتسرد صفحة الرموز الأسعار اللحظية لكل معدن وعملة وعملة مشفرة تغطيها الواجهة.

الأسئلة الشائعة

ما رمزا البلاتين والبلاديوم؟

XPT للبلاتين وXPD للبلاديوم، وهما رمزا ISO 4217 لأونصة تروي واحدة من كل معدن. وفي الاستجابات، يحمل USDXPT وUSDXPD السعرين بالدولار الأمريكي لكل أونصة تروي.

هل يمكنني الحصول على سعر البلاتين لكل غرام؟

نعم. أضف unit=gram إلى /latest أو إلى أي نقطة نهاية تاريخية. وبالسعر النموذجي البالغ 1,612.35 USD لكل أونصة تروي، يعادل ذلك 51.84 USD لكل غرام. وتعمل kilogram والوحدات الأخرى بالطريقة نفسها.

إلى أي مدى تعود البيانات التاريخية للبلاتين والبلاديوم؟

تعود أسعار الإغلاق اليومية إلى عام 2000 في كل الخطط. ويغطي طلب /timeframe الواحد حتى 30 يومًا في Free و365 يومًا في الخطط المدفوعة، لذا كرّر الطلب على النطاقات الأطول.

هل يوفّر MetalAPI أسعار الروديوم؟

لا. من بين معادن مجموعة البلاتين، لا يسعّر MetalAPI سوى البلاتين والبلاديوم. وتُرجع نقطة النهاية /api/v1/symbols قائمة الرموز الحالية ولا تُحتسب من حصتك.

هل البلاتين مشمول في خطة Free؟

نعم. تتضمن كل خطة كل الرموز والسجل الكامل. وتضيف الخطط المدفوعة تحديثات أحدث، ونطاقات أطول لكل طلب، وأسعار الذهب حسب العيار، ومن خطة Standard فما فوق أسعار الطلب والعرض.