محاسبه حباب سکه با API؛ محاسبهٔ خودکار حباب سکه و طلا برای پلتفرم‌های تحلیلی

حباب سکه یکی از پرجستجوترین مفاهیم بازار طلای ایران است و پلتفرم‌های تحلیلی، کانال‌های بازار و اپ‌های سرمایه‌گذاری می‌خواهند آن را لحظه‌ای نشان دهند. در این آموزش محاسبه حباب سکه با API را برای همهٔ سکه‌ها پیاده می‌کنیم. مفهوم حباب را در مقالهٔ حباب سکه چیست و چطور محاسبه می‌شود توضیح داده‌ایم؛ اینجا تمرکز بر داده و کد است.

این آموزش بخشی از راهنمای کامل API قیمت ارز و طلا است.

مشخصات سکه‌ها

سکه‌های بانک مرکزی ایران عیار ۹۰۰ (۲۱٫۶ قیراط) دارند؛ یعنی ۹۰ درصد وزن آن‌ها طلای خالص است.

وزن‌ها اسمی‌اند و تلرانس ضرب ممکن است اختلاف بسیار کوچکی بسازد که در محاسبهٔ حباب اثر محسوسی ندارد.

دو روش محاسبهٔ ارزش ذاتی

روش ۱: از انس جهانی و دلار آزاد (حباب نسبت به بازار جهانی)

قیمت گرم طلای خالص = قیمت انس (دلار) × نرخ دلار آزاد (تومان) ÷ ۳۱٫۱۰۳۵

این روش نشان می‌دهد سکه نسبت به ارزش جهانی طلایش چقدر گران یا ارزان است. وقتی کسی از «حباب سکه» حرف می‌زند، معمولاً همین را منظور دارد.

روش ۲: از طلای ۱۸ عیار بازار داخلی (حباب نسبت به طلای داخل)

قیمت گرم طلای خالص = قیمت گرم طلای ۱۸ عیار ÷ ۰٫۷۵

این روش حباب سکه را نسبت به بازار طلای داخلی می‌سنجد و برای مقایسهٔ «سکه بخرم یا طلای آبشده» مفیدتر است. چون خود بازار طلای داخلی هم ممکن است نسبت به انس حباب داشته باشد (رجوع کنید به حباب طلا)، دو روش عدد متفاوتی می‌دهند. در داشبورد خود هر دو را با برچسب روشن نمایش دهید.

کد پایتون

import os, requests

API, KEY = "https://api.ezrate.me/v1", os.environ["EZRATE_KEY"]
OUNCE_G = 31.1035
COINS = {"emami": 8.133, "bahar": 8.133, "nim": 4.0665, "rob": 2.03325, "gerami": 1.01}
FINENESS = 0.9

r = requests.get(f"{API}/rates", params={"symbols": "ounce,usd,g18," + ",".join(COINS)},
                 headers={"X-API-Key": KEY}, timeout=10)
r.raise_for_status()
x = {d["symbol"]: d for d in r.json()["data"]}

# قیمت انس به دلار: فیلد usd یا با quote=usd؛ اینجا از فیلد usd می‌خوانیم
ounce_usd = float(x["ounce"]["usd"])
pure_world = ounce_usd * x["usd"]["sell"] / OUNCE_G      # روش ۱
pure_local = x["g18"]["sell"] / 0.75                    # روش ۲

for s, w in COINS.items():
    intrinsic_w = w * FINENESS * pure_world
    intrinsic_l = w * FINENESS * pure_local
    price = x[s]["sell"]
    print(f"{x[s]['name']}: حباب جهانی {(price - intrinsic_w) / intrinsic_w * 100:+.1f}٪ | "
          f"حباب نسبت به طلای داخل {(price - intrinsic_l) / intrinsic_l * 100:+.1f}٪")

نسخهٔ جاوااسکریپت برای داشبورد

const COINS = { emami: 8.133, bahar: 8.133, nim: 4.0665, rob: 2.03325, gerami: 1.01 }
export function bubbles(x) {                       // x: نرخ‌ها بر اساس نماد (از سرور خودتان)
  const pureWorld = Number(x.ounce.usd) * x.usd.sell / 31.1035
  return Object.entries(COINS).map(([s, w]) => {
    const intrinsic = w * 0.9 * pureWorld
    return { symbol: s, price: x[s].sell, intrinsic: Math.round(intrinsic),
             bubblePct: +((x[s].sell - intrinsic) / intrinsic * 100).toFixed(2) }
  })
}

تفسیر درست حباب

• حباب سکه‌های کوچک بیشتر است. هزینهٔ ضرب نسبت به وزن، تقاضای هدیه و نقدشوندگی، حباب ربع و گرمی را معمولاً بالاتر از سکه امامی نگه می‌دارد. دلایل کامل در چرا حباب ربع سکه بیشتر است.
• حباب ثابت نیست. در روزهای هیجانی و انتظار تورمی بالا می‌رود و با آرام شدن بازار کم می‌شود.
• حباب سیگنال خرید یا فروش نیست. حباب بالا ریسک افت قیمت در زمان آرامش را بیشتر می‌کند، اما بازار ممکن است مدت‌ها با حباب بالا بماند.
• ساعت معتبر را ببینید. نیمه‌شب که منابع کم‌اند، قیمت سکه کمتر به‌روز می‌شود و حباب محاسبه‌شده ممکن است گمراه‌کننده باشد. فیلد sources را کنار عدد نگه دارید.

نسخهٔ انگلیسی این مفاهیم برای مخاطب بین‌المللی در Iranian Gold Coins Explained آمده است. اگر فقط عدد حباب را برای مشاهده می‌خواهید، صفحه‌های قیمت سکه امامی و قیمت سکه باکس حباب را لحظه‌ای نشان می‌دهند.

نرخ‌های لحظه‌ای مرتبط با این مطلب: قیمت دلار.