مستندات وب‌سرویس لایو طلا و ارز (REST API)

<?php
/**
 * تابع استعلام خودکار قیمت طلای ۱۸ عیار از API تابلوی طلا
 */
function get_live_gold_18k_price() {
    $transient_key = 'live_gold_18k_sell_price';
    $cached_price = get_transient($transient_key);

    if ($cached_price !== false) {
        return (float) $cached_price;
    }

    $api_url = 'https://live.mehrgold24.ir/api/rates.php?item=gold18k';
    $response = wp_remote_get($api_url, [
        'timeout' => 5,
        'headers' => ['Accept' => 'application/json']
    ]);

    if (is_wp_error($response)) {
        return 0; // در صورت خطا، نرخ قبلی یا صفر
    }

    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);

    if (!empty($data['success']) && !empty($data['data']['item']['sell'])) {
        $sell_price = (float) $data['data']['item']['sell'];
        // ذخیره نرخ در کش وردپرس به مدت ۶۰ ثانیه برای بهینه‌سازی سرعت سایت
        set_transient($transient_key, $sell_price, 60);
        return $sell_price;
    }

    return 0;
}

// نمونه استفاده برای محاسبه قیمت زیورآلات:
$gold_price = get_live_gold_18k_price(); // تومان برای ۱ گرم طلای ۱۸ عیار
// $product_price = ($product_weight * $gold_price) + $ojrat + $profit;
?>

async function fetchLiveGoldRates() {
  try {
    const response = await fetch('https://live.mehrgold24.ir/api/rates.php');
    const result = await response.json();

    if (result.success) {
      console.log('طلای ۱۸ عیار فروش:', result.data.gold.gold18k.sellFormatted, 'تومان');
      console.log('سکه امامی فروش:', result.data.coins.banki.coinEmamBanki.sellFormatted, 'تومان');
      console.log('دلار نقدی فروش:', result.data.currencies.usd.sellFormatted, 'تومان');
      
      // دسترسی سریع از طریق آرایه فلت items:
      const gold18k = result.data.items.gold18k;
      console.log('خرید:', gold18k.buy, 'فروش:', gold18k.sell);
    }
  } catch (error) {
    console.error('خطا در دریافت نرخ‌های طلا:', error);
  }
}

fetchLiveGoldRates();

# استعلام تمام نرخ‌ها
curl -s "https://live.mehrgold24.ir/api/rates.php"

# استعلام فقط طلا و مظنه
curl -s "https://live.mehrgold24.ir/api/rates.php?category=gold"

# استعلام تکی طلای ۱۸ عیار
curl -s "https://live.mehrgold24.ir/api/rates.php?item=gold18k"

{
  "success": true,
  "timestamp": "2026-09-06T09:20:00+03:30",
  "data": {
    "gold": {
      "gold18k": {
        "title": "طلای ۱۸ عیار",
        "buy": 7684000,
        "sell": 7734000,
        "buyFormatted": "7,684,000",
        "sellFormatted": "7,734,000",
        "unit": "تومان",
        "spreadApplied": 50000
      }
    },
    "coins": {
      "banki": { ... },
      "non_banki": { ... }
    },
    "currencies": {
      "usd": { ... },
      "eurCash": { ... },
      "iqdDinar": { ... },
      "usdtTether": { ... }
    },
    "items": {
      "gold18k": { "title": "طلای ۱۸ عیار", "buy": 7684000, "sell": 7734000 },
      "coinEmamBanki": { "title": "سکه تمام امامی (بانکی)", "buy": 82900000, "sell": 83000000 }
    }
  }
}