API رایگان بورس TSETMC
API رایگان بورس TSETMC
✅ دسترسی لحظهای به قیمتها: این API قیمتهای لحظهای طلا، دلار، سکه و سایر ارزها را با دقت بالا ارائه میدهد.
✅ پشتیبانی از انواع دادهها: ارائه قیمت لحظهای برای دلار، یورو، طلا، سکه و دیگر ارزهای مهم.
✅ سهولت در استفاده: با خروجی دیتا در قالب استاندارد JSON، این API به راحتی قابل پیادهسازی در انواع نرمافزارها و سیستمهای تحلیلی است.
✅ دسترسی رایگان : بدون نیاز به پرداخت هزینه تا 1500 ریکوئست روزانه، با دسترسی پایدار و سریع.
| متغیر | توضیح | مثال |
|---|---|---|
| date | تاریخ | 1403/12/28 |
| time | زمان | 19:58 |
| time_unix | زمان یونیکس | 1742315280 |
| symbol | نماد | IR_COIN_EMAMI |
| name_en | نام انگلیسی | Emami Coin |
| name | نام فارسی | سکه امامی |
| price | قیمت | 97005000 |
| change_value | مقدار تغییر قیمت | 6964959 |
| change_percent | درصد تغییر قیمت | 7.18 |
| unit | واحد قیمت | تومان |
نسخه حرفهای (Pro) وبسرویس طلا و ارز BrsApi، یک ابزار قدرتمند و بهروز برای دریافت دادههای لحظهای و تاریخچه قیمتی انواع نمادهای بازار طلا، ارز و رمزارز است. این API برای توسعهدهندگان، تحلیلگران و سرویسهای مالی طراحی شده و با ساختاری ساده، مستندات دقیق و پاسخدهی سریع، نیاز شما به اطلاعات قیمت لحظهای طلا و ارز را به بهترین شکل پوشش میدهد.
از طریق نسخه Pro میتوانید بهصورت دقیق فقط بخشی از اطلاعات مورد نظر خود را دریافت کنید، دادههای ۲۴ ساعته یا تاریخچه روزانه را استخراج کرده و در نرمافزار، اپلیکیشن یا وبسایت خود بهکار ببرید. پشتیبانی از پارامترهای متنوع و ساختار خروجی JSON استاندارد، استفاده از این API را برای انواع کاربردهای شخصی یا تجاری آسان کرده است.
همچنین نسخه Pro علاوه بر آیتمهای نسخه رایگان، شامل قیمت انواع سکه پارسیان و نرخ خرید و فروش ارزهای سامانه سنا و نیما نیز میباشد؛ این اطلاعات برای تحلیلهای دقیقتر بازار و کاربردهای تخصصی بسیار ارزشمند هستند.
مثال :
در نسخه Pro از API
طلا و ارز، این امکان را دارید که فقط اطلاعات مورد نیاز خود را بهصورت دقیق دریافت کنید.
این کار با استفاده از پارامتر section انجام میشود.
پارامتر section از سه مقدار زیر پشتیبانی میکند:
gold – قیمتهای مرتبط با طلاcurrency – نرخ ارزهای رایجcryptocurrency – قیمت انواع رمزارز یا ارز دیجیتال
در صورتی که نیاز به دریافت همزمان چند بخش دارید، میتوانید مقادیر را با , از هم جدا کنید.
section=gold
section=gold,currency
توجه: اگر پارامتر section ارسال نشود، اطلاعات مربوط به هر سه بخش
(طلا، ارز، رمزارز)
بهصورت کامل و جامع بازگردانده خواهد شد.
| متغیر | توضیح | مثال |
|---|---|---|
| successful | موفقیتآمیز بودن ریکوئست | true |
| code_http | کد پاسخ http | 200 |
| message_error | پیام خطا | null |
| url_base_icon | آدرس پایه آیکن | https://Api.BrsApi.ir/.../Icon |
| date | تاریخ | 1404/02/14 |
| time | زمان | 19:02 |
| time_unix | زمان یونیکس | 1746372720 |
| symbol | نماد | USD |
| name_en | نام انگلیسی | US Dollar |
| name | نام فارسی | دلار آمریکا |
| sign | نماد گرافیکی | $ |
| price | قیمت | 859000 |
| change_value | مقدار تغییر قیمت | 7000 |
| change_percent | درصد تغییر قیمت | 0.82 |
| unit | واحد قیمت | ریال |
| path_icon | نام فایل آیکن | USD.png |
در خروجی API، برای هر نماد (مثلاً دلار آمریکا)، مسیر آیکن در قالب دو پارامتر جداگانه ارائه میشود:
url_base_icon: مسیر پایه برای ذخیرهسازی آیکنهاpath_icon: نام فایل آیکن (مثلاً USD.png)فایلهای آیکن در چهار اندازه متفاوت ارائه میشوند:
32x3264x64128x128256x256{url_base_icon}/{Size}/{path_icon}
فرض کنید مقادیر زیر از API دریافت شده باشند:
url_base_icon = https://Api.BrsApi.ir/XXX/Iconpath_icon = USD.png128x128https://Api.BrsApi.ir/XXX/Icon/128x128/USD.png
مثال :
برای دریافت دادههای قیمتی مربوط به ۲۴ ساعت گذشته یک نماد، کافیست دو پارامتر زیر را در درخواست خود ارسال کنید:
history=1 – فعالسازی حالت تاریخچه ۲۴ ساعتهsymbol مشخص کنید (مثلاً برای دلار آمریکا مقدار
USD را وارد نمایید).
دریافت تاریخچه ۲۴ ساعته قیمت دلار:
https://Api.BrsApi.ir/Market/Gold_Currency_Pro.php?key=YourApiKey&history=1&symbol=USD
توجه: مقدار پارامتر symbol باید یکی از نمادهای معتبر موجود در
API باشد (مانند
USD، EUR، BTC و ...)
مثال :
برای دریافت تاریخچه قیمت روزانه یک نماد در یک بازه زمانی خاص، از پارامتر
history=2 به همراه موارد زیر استفاده کنید:
symbol: مشخصکننده نماد مورد نظر (مثلاً USD برای دلار آمریکا)date_start: تاریخ شروع بازه (مثلاً 1404-01-01)date_end: تاریخ پایان بازه (مثلاً 1404-02-02)دریافت قیمت روزانه دلار در بازه ۱ فروردین تا ۲ اردیبهشت ۱۴۰۴:
https://Api.BrsApi.ir/Market/Gold_Currency_Pro.php?key=YourApiKey&history=2&symbol=USD&date_start=1404-01-01&date_end=1404-02-02
نکته: تاریخها باید به فرمت شمسی YYYY-MM-DD و با خط تیره وارد شوند.
توجه: در صورتی که تاریخ شروع یا پایان واردشده، مصادف با یک روز تعطیل باشد، سیستم بهصورت خودکار نزدیکترین تاریخ غیرتعطیل را انتخاب و استفاده خواهد کرد.
توضیحات تکمیلی:
date_start اختیاری است. در صورتی که مقدار آن مشخص نشود، سیستم بهطور خودکار قدیمیترین تاریخ موجود را بهعنوان نقطه شروع در نظر میگیرد.date_end نیز اختیاری است. در صورت عدم ارسال این پارامتر، آخرین تاریخ موجود در پایگاه داده بهصورت پیشفرض اعمال خواهد شد.| متغیر | توضیح | مثال |
|---|---|---|
| symbol | نماد | USD |
| name | نام | دلار آمریکا |
| sign | نماد گرافیکی | $ |
| unit | واحد قیمت | ریال |
| url_base_icon | آدرس پایه آیکن | https://Api.BrsApi.ir/XXX/Icon |
| path_icon | نام فایل آیکن | USD.png |
| date | تاریخ | 1404/02/05 |
| open | اولین قیمت | 796500 |
| high | بالاترین قیمت | 797000 |
| low | پایینترین قیمت | 795500 |
| close | آخرین قیمت | 796000 |