مقداری از یک نماد را به نماد دیگر تبدیل میکند، مثلاً یک انس طلا به تومان یا صد دلار به انس نقره. حساب از راه تومان و با نرخ میانهٔ همان لحظه انجام میشود.
GET
/api/markets/v1/convert?from=XAU&to=IRT&amount=1
رایگان + پرو
curl "https://netarz.ir/api/markets/v1/convert?from=XAU&to=IRT&amount=1" \
-H "Authorization: Bearer fx-ntz-v1-..."
پارامترها
| پارامتر | معنی |
|---|---|
from | نماد مبدأ (الزامی) |
to | نماد مقصد (الزامی)؛ IRT برای تومان و IRR برای ریال هم پذیرفته میشود |
amount | مقدار؛ پیشفرض ۱ |
نکتهها
- عدد تبدیل از همان قیمتهایی ساخته میشود که طرح شما در آخرین قیمت میگیرد؛ در طرح رایگان یعنی با همان تأخیر.
- اگر برای یکی از دو نماد هنوز عددی ثبت نشده باشد، پاسخ
409 no_dataاست. - تبدیل انس به تومان یک حساب ساده است (انس × دلار نِت اَرز) و قیمت بازار طلای تهران نیست.