هر عددی که API بازارها می‌فرستد منبع روشنی دارد و هر ردیف نام منبعش را در source و meta.sources با خودش می‌آورد.
نمادی که اجازهٔ انتشارش را در API نداریم، اصلاً در پاسخ نمی‌آید؛ حتی اگر نامش را بخواهید، جوابش مثل نمادی است که وجود ندارد.
نمادها
| نماد | نام | منبع | وضعیت در API |
|---|---|---|---|
XAU |
انس طلا | gold-api.com | در API |
XAG |
انس نقره | gold-api.com | در API |
GOLD18 |
طلای ۱۸ عیار (هر گرم) ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
MESGHAL |
مثقال طلای ۱۸ عیار ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
COIN_EMAMI |
سکهٔ امامی ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
COIN_BAHAR |
سکهٔ بهار آزادی ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
COIN_HALF |
نیم‌سکه ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
COIN_QUARTER |
ربع‌سکه ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
COIN_GERAMI |
سکهٔ گرمی ارزش محاسبه‌ای | gold-api.com + دلار نِت اَرز | در API |
USD، EUR، … |
۳۴ ارز به تومان | نِت اَرز | در API |
فهرست کامل و همیشه به‌روز را از GET /instruments بگیرید. نمادهای ویژهٔ طرح پرو در آن با pro_only: true مشخص شده‌اند.
ارزش محاسبه‌ای یعنی چه
عدد تومانی طلای ۱۸ عیار، مثقال و سکه‌ها از معامله‌های بازار تهران نمی‌آید. آن را خودمان حساب می‌کنیم: قیمت انس جهانی طلا ÷ ۳۱٫۱۰۳۵ (گرم‌های یک انس) × عیار × نرخ دلار نِت اَرز، و برای مثقال ضرب در ۴٫۶۰۸۳ و برای هر سکه ضرب در وزن طلای خالصش. حباب سکه، اجرت ساخت و سود فروشنده در آن نیست و قیمت بازار تهران معمولاً با آن فرق دارد.
هر ردیف محاسبه‌ای این فیلدها را دارد تا برنامهٔ شما هیچ‌وقت آن را با قیمت بازار اشتباه نگیرد:
| فیلد | مقدار |
|---|---|
computed | true |
is_market_price | false |
label_fa | «ارزش محاسبه‌ای» |
disclaimer_fa | توضیح یک‌خطی که می‌گوید این عدد قیمت بازار تهران نیست |
اگر عدد محاسبه‌ای را در سایت یا اپ خودتان نشان می‌دهید، label_fa و disclaimer_fa را هم کنارش بگذارید تا خواننده آن را قیمت بازار نداند.
نام منبع
پیشنهاد ما این است که زیر جدول یا نمودار نام منبع را بنویسید، مثلاً «منبع: gold-api.com» برای انس و «نرخ ارز از نِت اَرز» برای ارزها، تا خواننده بداند هر عدد از کجا آمده است.
نام و نشانی هر منبع در meta.sources هر پاسخ هست.
چیزهایی که فعلاً نیست
- قیمت بازار طلا و سکهٔ تهران و حباب سکه
- رمزارزها و سهام
- تاریخچهٔ ارزها؛ آن را از تاریخچهٔ API نرخ ارز بگیرید.