GET /api/market
API نرخ ارز، طلا و رمزارز
دریافت نرخهای مرجع ارز، طلا و رمزارز همراه با زمان بهروزرسانی، منبع و وضعیت تازگی داده.
بدون API Keyمحدودیت عمومی تضمینشده اعلام نشده است؛ مصرف منصفانه و cache توصیه میشود.JSON
درخواست سریع
cURL
curl https://persiantoolbox.ir/api/market
JavaScript
const response = await fetch('https://persiantoolbox.ir/api/market');
const market = await response.json();Python
import requests
market = requests.get('https://persiantoolbox.ir/api/market', timeout=10).json()ساختار پاسخ
{
"ok": true,
"data": {
"timestamp": 1784726400000,
"currencies": {
"USD": { "code": "USD", "name": "دلار آمریکا", "rate": 1, "change24h": 0 },
"EUR": { "code": "EUR", "name": "یورو", "rate": 0.92, "change24h": 0 },
"IRR": { "code": "IRR", "name": "ریال ایران", "rate": 42000, "change24h": 0 }
},
"gold": { "pricePerGram": 0, "change24h": 0 },
"crypto": {
"BTC": { "symbol": "BTC", "name": "بیتکوین", "priceUSD": 0, "change24h": 0 }
},
"units": {
"currencyBase": "USD",
"iranCurrency": "IRR",
"goldPricePerGram": "IRR",
"cryptoPrice": "USD"
},
"sources": ["exchangerate-api", "coingecko"],
"freshness": "live"
}
}تازگی، منبع و واحد
کش داخلی پنجدقیقهای؛ پاسخ میتواند live، cached یا stale باشد.
پیش از ذخیره یا نمایش داده، مقادیر freshness، sources و units را بررسی کنید. نرخ ارزها نسبت به USD، قیمت هر گرم طلا به IRR و قیمت رمزارز به USD اعلام میشود.
دامنه داده
نرخها مرجع فنی منابع متصل هستند و تضمین نرخ بازار آزاد ایران، نرخ معامله صرافی یا قیمت قابل خریدوفروش نیستند. برای تصمیم مالی، منبع، واحد و زمان پاسخ را کنترل کنید.