آخرین عدد هر نماد، با زمان دقیقی که ثبت شده است. بدون پارامتر symbols همهٔ نمادهای باز برمی‌گردند.
GET
/api/markets/v1/latest?symbols=XAU,XAG,USD
رایگان + پرو
curl "https://netarz.ir/api/markets/v1/latest?symbols=XAU,XAG,USD,EUR" \
-H "Authorization: Bearer fx-ntz-v1-..."
GET
/api/markets/v1/latest/{symbol}
رایگان + پرو
const res = await fetch('https://netarz.ir/api/markets/v1/latest/XAU', {
headers: { Authorization: 'Bearer fx-ntz-v1-...' },
});
const { data, meta } = await res.json();
console.log(data.price, data.as_of, meta.sources);فیلدهای هر ردیف
| فیلد | معنی |
|---|---|
symbol | نماد، مثلاً XAU یا USD |
asset_class | metal برای انس، fiat برای ارز |
unit، unit_amount | واحد قیمت؛ برای چند ارز کم‌ارزش مثل دینار عراق، قیمت برای چند واحد است |
quote_currency | انس به USD، ارزها به IRT (تومان) |
price، bid، ask | قیمت؛ bid و ask فقط وقتی عدد زنده است و منبع آن‌ها را داده باشد |
change_24h، change_pct_24h | تغییر نسبت به عدد پایانی روز قبل (تقویم تهران) |
as_of | زمان واقعی عدد؛ هیچ‌وقت زمان درخواست شما نیست |
stale | true یعنی منبع مدتی است عدد تازه‌ای نداده و این آخرین عدد سالم است |
status | ok، یا no_data وقتی برای آن لحظه عددی ثبت نشده است |
pro_only | نمادی که فقط طرح پرو می‌گیرد |
طرح رایگان و پرو
- رایگان: عدد هر نماد همان است که ۱۵ دقیقه پیش بود. اگر برای آن لحظه عددی نداشته باشیم،
price: nullوstatus: no_dataبرمی‌گردد؛ عدد زنده جای آن نمی‌نشیند. - پرو: آخرین عدد ثبت‌شده، بدون تأخیر.
meta.delayed_minutesوmeta.is_delayedمی‌گویند پاسخ شما چقدر عقب است.
نمادی که نیست
در /latest نماد ناشناخته خطا نمی‌دهد: در meta.skipped با دلیل unknown یا pro_required می‌آید و بقیهٔ نمادها برمی‌گردند. در /latest/{symbol} همان نماد خطای 404 unknown_symbol یا 402 pro_required می‌گیرد.
کش
پاسخ /latest در طرح پرو ۳۰ ثانیه و در طرح رایگان ۶۰ ثانیه کش می‌شود. انس هر پنج دقیقه از منبع خوانده می‌شود، پس درخواست پشت‌سرهم عدد تازه‌تری نمی‌دهد و فقط سهمیهٔ روزانهٔ شما را مصرف می‌کند.