محدودیت تعداد درخواست در API طلالایو چقدر است؟

سقف مجاز مصرف رایگان ۶۰ درخواست در دقیقه به ازای هر آدرس آیپی میباشد.

شرایط استفاده و الزام ذکر منبع در API چیست؟

استفاده از دادههای این وبسرویس منوط به درج لینک مستقیم و فعال به وبسایت talalive.ir به عنوان منبع قیمت طلا است.

RESTful API v1.0 • دسترسی آزاد و رایگان

مستندات وب‌سرویس (API) رایگان نرخ لحظه‌ای طلا و سکه

Q: آیا برای استفاده از API به ساخت حساب کاربری یا API Key نیاز است؟

خیر؛ نسخه ۱ این وبسرویس بهصورت کاملاً باز و بدون نیاز به کلید دسترسی ارائه شده است.

با اتصال به API زنده طلالایو، آخرین نرخ‌های مظنه مثقال آبشده، طلای ۱۸ و ۲۴ عیار، انواع مسکوکات بانکی و ارزهای پایه را با بالاترین سرعت و دقت میلی‌ثانیه‌ای در پروژه‌ها، اپلیکیشن‌ها و سامانه‌های حسابداری خود نمایش دهید.

⚡

فرمت خروجی

JSON استاندارد (UTF-8)

🔒

احراز هویت

عمومی / بدون توکن (v1)

⏱️

محدودیت نرخ (Rate Limit)

۶۰ درخواست در دقیقه

🌐

پشتیبانی CORS

فعال (Access-Control: *)

GET /api/v1/rates

وضعیت سرور: فعال و آنلاین

شرح عملکرد اندپوینت

این متد آخرین نرخ‌های بازار طلا و جواهر تهران را شامل قیمت هر گرم طلای ۱۸ عیار، ۲۴ عیار، مظنه مثقال ۱۷ عیار، انس جهانی طلا، تمام سکه امامی و بهار آزادی، نیم سکه، ربع سکه، سکه گرمی و نرخ پایه دلار آزاد بازمی‌گرداند. کلیه مبالغ به واحد تومان محاسبه و اعلام شده‌اند.

پارامترهای ورودی (Query Parameters):

این اندپوینت در نسخه ۱ به هیچ پارامتر اجباری یا اختیاری نیاز ندارد و خروجی کامل بسته‌ی قیمتی را تحویل می‌دهد.

هدرهای استاندارد پاسخ (Response Headers):


                    Content-Type: application/json; charset=utf-8

                    Access-Control-Allow-Origin: *

                    Cache-Control: public, max-age=15

                    X-RateLimit-Limit: 60

                    X-RateLimit-Remaining: 59

نمونه خروجی واقعی (JSON Response 200 OK):

{
  "status": "success",
  "attribution": {
    "provider": "سامانه تابلوی طلای آنلاین طلالایو",
    "website": "https://talalive.ir",
    "terms": "استفاده از این وب‌سرویس منوط به درج لینک مستقیم و فعال به talalive.ir به عنوان منبع داده است."
  },
  "rate_limits": {
    "allowed_requests_per_minute": 60,
    "throttle_policy": "IP-based sliding window"
  },
  "timestamp": "2026-09-30T14:16:03+03:30",
  "api_time": "لحظه‌ای",
  "currency": "IRR (Toman)",
  "data": {
    "gold": {
      "gram_18k": {
        "name": "طلای ۱۸ عیار (گرم)",
        "price": 25504409,
        "unit": "تومان"
      },
      "gram_24k": {
        "name": "طلای ۲۴ عیار (گرم)",
        "price": 34005879,
        "unit": "تومان"
      },
      "mesghal_17k": {
        "name": "مظنه مثقال ۱۷ عیار (تهران)",
        "price": 110480000,
        "unit": "تومان"
      },
      "ounce_global": {
        "name": "انس جهانی طلا",
        "price": 4185.29,
        "unit": "دلار"
      }
    },
    "coins": {
      "emami": {
        "name": "سکه تمام طرح جدید (امامی)",
        "price": 259560000,
        "unit": "تومان"
      },
      "bahar": {
        "name": "سکه تمام بهار آزادی (طرح قدیم)",
        "price": 250140000,
        "unit": "تومان"
      },
      "half": {
        "name": "نیم سکه بهار آزادی",
        "price": 133870000,
        "unit": "تومان"
      },
      "quarter": {
        "name": "ربع سکه بهار آزادی",
        "price": 72580000,
        "unit": "تومان"
      },
      "gerami": {
        "name": "سکه گرمی",
        "price": 37000000,
        "unit": "تومان"
      }
    },
    "currency": {
      "usd_free": {
        "name": "دلار آمریکا (آزاد)",
        "price": 255500,
        "unit": "تومان"
      }
    }
  }
}

نمونه کدهای اتصال در زبان‌های مختلف

برای اتصال سریع، کدهای تست‌شده زیر را مستقیماً در پروژه خود کپی و اجرا نمایید:

curl -X GET "https://talalive.ir/api/v1/rates" \
     -H "Accept: application/json"

async function fetchGoldRates() {
    try {
        const response = await fetch('https://talalive.ir/api/v1/rates');
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        const result = await response.json();
        console.log('قیمت طلای ۱۸ عیار:', result.data.gold.gram_18k.price);
        console.log('سکه امامی:', result.data.coins.emami.price);
        return result.data;
    } catch (error) {
        console.error('خطا در دریافت نرخ:', error);
    }
}

fetchGoldRates();

import requests

url = "https://talalive.ir/api/v1/rates"
headers = {"Accept": "application/json"}

try:
    response = requests.get(url, headers=headers, timeout=10)
    response.raise_for_status()
    data = response.json()
    
    gold_18k = data["data"]["gold"]["gram_18k"]["price"]
    coin_emami = data["data"]["coins"]["emami"]["price"]
    
    print(f"هر گرم طلای ۱۸ عیار: {gold_18k:,} تومان")
    print(f"سکه طرح جدید: {coin_emami:,} تومان")
except requests.exceptions.RequestException as e:
    print(f"خطا در برقراری ارتباط: {e}")

<?php

$url = 'https://talalive.ir/api/v1/rates';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result && $result['status'] === 'success') {
    $gold18k = $result['data']['gold']['gram_18k']['price'];
    echo "طلای ۱۸ عیار: " . number_format($gold18k) . " تومان";
}

⚖️ شرایط استفاده، محدودیت‌ها و الزام درج منبع

دسترسی به API نرخ طلالایو برای کلیه توسعه‌دهندگان، استارتاپ‌ها، سامانه‌های حسابداری طلافروشی و وب‌سایت‌های خبری آزاد و رایگان است؛ مشروط به رعایت مفاد زیر:

الزام ذکر منبع با لینک فعال: در صورت استفاده از داده‌های این وب‌سرویس در صفحات وب یا اپلیکیشن‌ها، درج عنوان و لینک فعال مستقیم به طلالایو (talalive.ir) با عنوان «منبع قیمت: طلالایو» یا «منبع داده: سامانه تابلوی طلای آنلاین طلالایو» الزامی است.
سقف درخواست مجاز: حداکثر سقف مجاز برای هر آی‌پی (IP Address)، ۶۰ فراخوانی در هر دقیقه می‌باشد. سیستم به طور خودکار درخواست‌های فراتر از این سقف را با خطای HTTP 429 Too Many Requests متوقف خواهد کرد.
کش کردن داده‌ها در سمت سرور مصرف‌کننده: توصیه اکید می‌شود داده‌های دریافتی را حداقل به مدت ۱۵ الی ۳۰ ثانیه در سرور خود کش (Cache) کنید تا از ارسال درخواست‌های غیرضروری و بلاک شدن آی‌پی سرور جلوگیری شود.
ممنوعیت حملات و فشار غیرمتعارف: هرگونه تلاش برای مهندسی معکوس، حملات Denial-of-Service یا فرار از محدودیت نرخ موجب مسدودسازی دائمی دسترسی آی‌پی یا رنج آی‌پی خواهد شد.

سؤالات متداول توسعه‌دهندگان درباره API طلالایو

۱. آیا برای استفاده از API به ساخت حساب کاربری یا API Key نیاز است؟

خیر؛ نسخه ۱ این وب‌سرویس به‌صورت کاملاً باز و بدون نیاز به کلید دسترسی ارائه شده است. شما می‌توانید مستقیماً از اندپوینت /api/v1/rates استفاده نمایید.

۲. نرخ‌ها در این API در چه فواصل زمانی به‌روزرسانی می‌شوند؟

سامانه طلالایو قیمت‌های صنف طلا را از ساعت ۱۰:۳۰ صبح همزمان با گشایش بازار سبزه میدان و اتحادیه‌های مرجع به صورت میلی‌ثانیه‌ای دریافت و در کش توزیع‌شده با طول عمر ۱۵ ثانیه نگهداری می‌کند.

۳. اگر نیاز به وب‌سرویس اختصاصی یا خروجی با وب‌سوکت داشته باشیم چه کنیم؟

توسعه‌دهندگان و شرکت‌های صرافی یا نرم‌افزاری که نیازمند ترافیک بالا، وب‌سوکت زنده یا داده‌های تاریخی هستند، می‌توانند از طریق صفحه تماس با ما درخواست خود را برای دریافت پنل تجاری سازمانی ثبت نمایند.

۴. آیا امکان استفاده از ویجت آماده به جای کدنویسی API وجود دارد؟

بله! اگر تمایل به برنامه‌نویسی اختصاصی ندارید، می‌توانید با مراجعه به سازنده ویجت آنلاین طلالایو تنها با یک خط کد آی‌فریم، تابلوی زنده قیمت طلا را در سایت یا وبلاگ وردپرسی خود قرار دهید.

سایر ابزارها و خدمات دیجیتال طلالایو

علاوه بر وب‌سرویس توسعه‌دهندگان، طلالایو راهکارهای هوشمند تابلوی مغازه طلافروشی و ماشین‌حساب‌های صنفی پیشرفته را در اختیارتان می‌گذارد:

دریافت کد ویجت طلای سایت ماشین‌حساب فاکتور طلا آشنایی با تابلوی طلافروشی پشتیبانی فنی و تماس