- سبک زندگی یاهو
- علم در بازی: نشانگر آب کلم قرمز
- در اینجا آمده است که چگونه می توانید رمزنگاری خود را از binance به metamask منتقل یا پس بگیرید
- حق بیمه ریسک بازار
- RT Active Global Trend t
- صرافی های متمرکز و غیرمتمرکز ارزهای دیجیتال - مقایسه!
- عمق بازار فارکس ، ابزاری مفید برای معامله گران فارکس
- فرا گرفتن. خودکارتجارت مستر
- صف به quaff؟همه گیر برای انحصار مشروبات الکلی ایالت سوئد مشکل ایجاد می کند
- نمونه موارد تست - معاملات سهام چند بازاری
آخرین مطالب
امکانات وب
آیا باید در کمتر از 1 دقیقه استفاده از API را شروع کنید؟برای پرش به سمت راست به راهنمای QuickStart 3 مرحله ای تعاملی ما ، روی دکمه زیر کلیک کنید.
نمونه های کد
برای اینکه شما را سریعتر و سریعتر اجرا کنید ، نمونه های کد در زبانهای مختلف برنامه نویسی وجود دارد که در آنجا منتظر شما هستند.
- شروع شدن
- امکانات
- نمونه های کد
مستندات API
به مستندات API MarketStack خوش آمدید! در مجموعه مقاله های زیر شما یاد می گیرید که چگونه از بازار API MarketStack JSON برای داده های موجود در زمان واقعی ، داخل و تاریخ سهام سهام ، تعریف کنید ، چندین نماد سهام را تعریف کنید ، داده های گسترده ای را در مورد 70+ بورس ، 170. 000+ سهام از بیش از 50 بازیابی کنیدکشورها ، و همچنین 750+ شاخص بازار ، اطلاعات مربوط به مناطق زمانی ، ارز و موارد دیگر.
API ما بر اساس یک درخواست و ساختار پاسخ آرامش بخش و آسان برای درک ساخته شده است. درخواست های API همیشه با استفاده از یک URL درخواست API ساده با یک سری پارامترهای مورد نیاز و اختیاری HTTP GET ارسال می شود و پاسخ های API در قالب JSON سبک وزن ارائه می شود. برای شروع کار در زیر ادامه دهید ، یا روی دکمه آبی بالا کلیک کنید تا به راهنمای QuickStart 3 مرحله ای ما بپردازید.
شروع شدن
احراز هویت API
برای هر درخواست API که می کنید ، باید با عبور از کلید دسترسی API خود به پارامتر API Access_Key ، با API تأیید کنید. می توانید مثالی در زیر پیدا کنید.
مثال درخواست API:
مهم: لطفاً مطمئن شوید که کلید دسترسی API خود را به صورت عمومی در معرض دید قرار ندهید. اگر فکر می کنید کلید دسترسی API شما ممکن است به خطر بیفتد ، همیشه می توانید در داشبورد حساب خود تنظیم مجدد کنید.
رمزگذاری HTTPS 256 بیتی موجود در: برنامه اصلی و بالاتر
اگر در برنامه اصلی یا بالاتر مشترک باشید ، می توانید با استفاده از HTTPS استاندارد صنعت به API MarketStack دسترسی پیدا کنید. برای انجام این کار ، به سادگی در هنگام درخواست API از پروتکل HTTPS استفاده کنید.
مثال درخواست API:
آیا شما یک کاربر برنامه رایگان هستید و به دنبال اتصال از طریق HTTPS هستید؟شما باید حساب خود را به برنامه اصلی ارتقا دهید.
خطاهای API
خطاهای API شامل کد خطا و اشیاء پاسخ پیام است. در صورت بروز خطایی ، MarketStack نیز کدهای وضعیت HTTP را مانند 404 برای خطاهای "یافت نشد" باز می گرداند. اگر درخواست API شما موفق شود ، کد وضعیت 200 ارسال می شود.
برای خطاهای اعتبار سنجی ، API MarketStack همچنین یک شیء پاسخ زمینه را ارائه می دهد که اطلاعات اضافی در مورد خطایی که در قالب یک یا چند ماده فرعی رخ داده است ، هر کدام مجهز به نام پارامتر آسیب دیده و همچنین اشیاء کلید و پیام است. می توانید یک خطای مثال را در زیر پیدا کنید.
خطای مثال:
خطاهای مشترک API:
| رمز | نوع | شرح |
|---|---|---|
| 401 | INPALID_ACCESS_KEY | یک کلید دسترسی API نامعتبر تهیه شد. |
| 401 | Mission_access_Key | هیچ کلید دسترسی API تهیه نشده است. |
| 401 | inacial_user | حساب کاربری داده شده غیرفعال است. |
| 403 | https_access_restrid | دسترسی HTTPS در برنامه اشتراک فعلی پشتیبانی نمی شود. |
| 403 | function_access_restrend | نقطه پایانی API در برنامه اشتراک فعلی پشتیبانی نمی شود. |
| 404 | INVALID_API_FICTION | نقطه پایانی API داده شده وجود ندارد. |
| 404 | 404 پیدا نشد | منبع یافت نشد. |
| 429 | useage_limit_reached | حساب کاربری داده شده به حجم درخواست ماهانه خود رسیده است. |
| 429 | rate_limit_reached | حساب کاربری داده شده به حد نرخ رسیده است. |
| 500 | خطای داخلی | یک اشتباه داخلی رخ داد. |
توجه: API محدود به 5 درخواست در ثانیه است.
ویژگی های API
داده های پایان روز موجود در: همه برنامه ها
برای به دست آوردن داده های پایان روز برای یک یا چند صندوق سهام می توانید از نقطه پایانی EOD API استفاده کنید. یک نماد تیک تیک جدا از کاما یا چندگانه با استفاده از پارامتر نمادها به API منتقل می شود.
توجه: برای درخواست داده های پایان روز برای نمادهای تک تیک ، می توانید از نقطه پایانی API استفاده کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
| هدف - شی | شرح |
|---|---|
| /EOD/[تاریخ] | تاریخ را در قالب YYYY-MM-DD مشخص کنید. همچنین می توانید زمان دقیقی را در قالب تاریخ ISO-8601 مشخص کنید ، به عنوان مثال2020-05-21t00: 00: 00+0000. مثال: /EOD /2020-01-01 |
| /EOD/آخرین | آخرین داده های پایان روز موجود را برای یک یا چند صندوق سهام بدست آورید. |
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| نماد | [مورد نیاز] یک یا چند نماد سهام جدا شده با کاما (تیک) را برای درخواست خود مشخص کنید ، به عنوان مثالAAPL یا AAPL ، MSFT. هر نماد یک درخواست API را مصرف می کند. حداکثر: 100 نماد |
| تبادل | [اختیاری] با مشخص کردن شناسایی MIC بورس اوراق بهادار ، نتایج خود را بر اساس یک بورس سهام خاص فیلتر کنید. مثال: xnas |
| مرتب سازی | [اختیاری] به طور پیش فرض ، نتایج بر اساس تاریخ/زمان نزولی طبقه بندی می شوند. برای مشخص کردن یک ترتیب مرتب سازی از این پارامتر استفاده کنید. مقادیر موجود: DESC (پیش فرض) ، ASC. |
| تاریخ از | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با عبور از تاریخ در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| تاریخ_تا | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با گذراندن یک تاریخ پایان در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
نمونه پاسخ API:
اگر درخواست API شما موفقیت آمیز بود، Marketstack API هم اطلاعات صفحه بندی و هم یک شی داده را برمی گرداند که شامل یک شی فرعی جداگانه برای هر تاریخ/زمان و نماد درخواست شده است. تمام اشیاء پاسخ در زیر توضیح داده شده است.
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| تاریخ | تاریخ/زمان دقیق UTC را که داده های داده شده در قالب ISO-8601 جمع آوری شده است، برمی گرداند. |
| نماد | نماد تیک تیک سهام شی داده فعلی را برمی گرداند. |
| تبادل | شناسه MIC مبادله مرتبط با شی داده فعلی را برمی گرداند. |
| split_factor | ضریب تقسیم را برمی گرداند، که برای تنظیم قیمت ها هنگام انشعاب، تقسیم معکوس یا پرداخت توزیع یک شرکت استفاده می شود. |
| سود سهام | سود تقسیمی را که توزیع سود بین سهامداران است برمی گرداند. |
| باز کن | قیمت بازگشایی اولیه سهام داده شده را برمی گرداند. |
| بالا | قیمت بالای اولیه سهام داده شده را برمی گرداند. |
| کم | قیمت پایین اولیه سهام داده شده را برمی گرداند. |
| بستن | قیمت بسته شدن خام سهام داده شده را برمی گرداند. |
| جلد | حجم خام تیک تیک سهام داده شده را برمی گرداند. |
| adj_open | قیمت باز تعدیل شده تیک تیک سهام داده شده را برمی گرداند. |
| adj_high | قیمت بالای تعدیل شده علامت سهام داده شده را برمی گرداند. |
| adj_low | قیمت پایین تنظیم شده مربوط به سهام داده شده را برمی گرداند. |
| adj_close | قیمت بسته شدن تعدیل شده نشانگر سهام داده شده را برمی گرداند. |
| adj_volume | حجم تنظیم شده نشانگر سهام داده شده را برمی گرداند. |
قیمت های تعدیل شده: قیمت های "تنظیم شده" مقادیر قیمت سهام هستند که پس از حسابداری برای هرگونه اقدامات شرکتی ، مانند تقسیم یا سود سهام ، به طور دقیق ارزش سهام داده شده را اصلاح می کنند. تنظیمات مطابق با روش "محاسبات CRSP" که توسط مرکز تحقیقات در قیمت های امنیتی (CRSP) ارائه شده است ، انجام می شود.
داده های Intraday موجود در: برنامه اصلی و بالاتر
علاوه بر قیمت سهام روزانه پایان روز ، API MarketStack همچنین از داده های داخلی با فواصل داده به عنوان یک دقیقه کوتاه پشتیبانی می کند. قیمت های Intraday برای کلیه تیک های سهام ایالات متحده موجود در بورس IEX (بورس سرمایه گذاران) در دسترس است.
برای به دست آوردن داده های Intraday ، می توانید از نقطه پایانی intraday API استفاده کرده و نمادهای تیک تیک سهام مورد نظر خود را مشخص کنید.
توجه: برای درخواست داده های Intraday برای نمادهای تک تیک ، می توانید از نقطه انتهایی API نیز استفاده کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
| هدف - شی | شرح |
|---|---|
| /intraday/[تاریخ] | تاریخ را در قالب YYYY-MM-DD مشخص کنید. همچنین می توانید زمان دقیقی را در قالب تاریخ ISO-8601 مشخص کنید ، به عنوان مثال2020-05-21t00: 00: 00+0000. مثال: /intraday /2020-01-01 |
| /intraday/آخرین | آخرین داده های Intraday موجود را برای یک یا چند صندوق سهام بدست آورید. |
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| نماد | [مورد نیاز] یک یا چند نماد سهام جدا شده با کاما (تیک) را برای درخواست خود مشخص کنید ، به عنوان مثالAAPL یا AAPL ، MSFT. هر نماد یک درخواست API را مصرف می کند. حداکثر: 100 نماد |
| تبادل | [اختیاری] با مشخص کردن شناسایی MIC بورس اوراق بهادار ، نتایج خود را بر اساس یک بورس سهام خاص فیلتر کنید. مثال: iexg |
| فاصله | [اختیاری] فاصله داده مورد نظر خود را مشخص کنید. مقادیر موجود: 1min ، 5min ، 10min ، 15min ، 30min ، 1 ساعت (پیش فرض) ، 3 ساعت ، 6 ساعت ، 12 ساعت و 24 ساعت. |
| مرتب سازی | [اختیاری] به طور پیش فرض ، نتایج بر اساس تاریخ/زمان نزولی طبقه بندی می شوند. برای مشخص کردن یک ترتیب مرتب سازی از این پارامتر استفاده کنید. مقادیر موجود: DESC (پیش فرض) ، ASC. |
| تاریخ از | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با عبور از تاریخ در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| تاریخ_تا | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با گذراندن یک تاریخ پایان در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
به روزرسانی های زمان واقعی: لطفاً توجه داشته باشید که فرکانس فرکانس داده زیر 15 دقیقه (15 دقیقه) فقط در صورتی که در برنامه حرفه ای یا بالاتر مشترک باشید ، پشتیبانی می شوند. اگر برنامه رایگان یا اساسی هستید ، لطفاً حساب خود را ارتقا دهید.
نمونه پاسخ API:
اگر درخواست API شما موفقیت آمیز بود، Marketstack API هم اطلاعات صفحه بندی و هم یک شی داده را برمی گرداند که شامل یک شی فرعی جداگانه برای هر تاریخ/زمان و نماد درخواست شده است. تمام اشیاء پاسخ در زیر توضیح داده شده است.
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| تاریخ | تاریخ/زمان دقیق UTC را که داده های داده شده در قالب ISO-8601 جمع آوری شده است، برمی گرداند. |
| نماد | نماد تیک تیک سهام شی داده فعلی را برمی گرداند. |
| تبادل | شناسه MIC مبادله مرتبط با شی داده فعلی را برمی گرداند. |
| باز کن | قیمت بازگشایی اولیه سهام داده شده را برمی گرداند. |
| بالا | قیمت بالای اولیه سهام داده شده را برمی گرداند. |
| کم | قیمت پایین اولیه سهام داده شده را برمی گرداند. |
| بستن | قیمت بسته شدن خام سهام داده شده را برمی گرداند. |
| آخر | آخرین تجارت اعدام شده نماد داده شده را در مبادله خود باز می گرداند. |
| جلد | حجم صندوق سهام داده شده را برمی گرداند. |
به روزرسانی های زمان واقعی موجود در: برنامه حرفه ای و بالاتر
برای مشتریانی که اشتراک فعال در برنامه حرفه ای دارند ، نقطه پایانی Intraday API MarketStack نیز قادر به ارائه داده های بازار در زمان واقعی است ، هر دقیقه ، هر 5 دقیقه یا هر 10 دقیقه به روز می شود.
برای به دست آوردن داده های زمان واقعی با استفاده از این نقطه پایانی ، به سادگی پارامتر فاصله API را اضافه کرده و آن را روی 1 دقیقه ، 5 دقیقه یا 10 دقیقه تنظیم کنید.
مثال درخواست API:
ویژگی های نقطه پایانی ، پارامترها و پاسخ API:
برای کسب اطلاعات در مورد ویژگی های نقطه پایانی ، درخواست پارامترهای و اشیاء پاسخ API ، لطفاً به بخش داده Intraday بروید.
داده های تاریخی موجود در: همه برنامه ها
قیمت های تاریخی سهام هم از نقطه پایانی API پایان روز (eod) و هم در روز (بین روز) در دسترس هستند. برای به دست آوردن داده های تاریخی، به سادگی از پارامترهای date_from و date_to همانطور که در درخواست مثال زیر نشان داده شده است استفاده کنید.
مثال درخواست API:
http get parameters درخواست:
برای جزئیات در مورد پارامترهای درخواست در نقطه پایانی داده eod، لطفاً به بخش داده های پایان روز بروید.
نمونه پاسخ API:
اشیاء پاسخ API:
برای جزئیات بیشتر در مورد اشیاء پاسخ API، لطفاً به بخش داده های پایان روز بروید.
توجه: داده های پایان روز تاریخی (eod) تا 30 سال قبل در دسترس هستند، در حالی که داده های درون روز (داخل روز) همیشه فقط 10000 ورودی آخر را برای هر یک از بازه های زمانی موجود ارائه می دهند. مثال: برای یک بازه زمانی 1 دقیقه ای، داده های روزانه روزانه تا 10000 دقیقه در دسترس است.
تقسیم داده های موجود در: همه طرح ها
با استفاده از APIs splits endpoint می توانید اطلاعاتی در مورد عامل تقسیم سهام برای نمادهای مختلف جستجو کنید. در زیر می توانید نمونه درخواست API را پیدا کرده و امتحان کنید.
برای به دست آوردن داده های تقسیم، می توانید از نقطه پایانی تقسیم API استفاده کنید و نمادهای سهام ترجیحی خود را مشخص کنید.
توجه: برای درخواست تقسیم داده ها برای نمادهای تکی، می توانید از نقطه پایانی Tickers API نیز استفاده کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| نماد | [مورد نیاز] یک یا چند نماد سهام جدا شده با کاما (تیک) را برای درخواست خود مشخص کنید ، به عنوان مثالAAPL یا AAPL ، MSFT. هر نماد یک درخواست API را مصرف می کند. حداکثر: 100 نماد |
| مرتب سازی | [اختیاری] به طور پیش فرض ، نتایج بر اساس تاریخ/زمان نزولی طبقه بندی می شوند. برای مشخص کردن یک ترتیب مرتب سازی از این پارامتر استفاده کنید. مقادیر موجود: DESC (پیش فرض) ، ASC. |
| تاریخ از | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با عبور از تاریخ در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| تاریخ_تا | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با گذراندن یک تاریخ پایان در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
نمونه پاسخ API:
اگر درخواست API شما موفقیت آمیز بود، Marketstack API هم اطلاعات صفحه بندی و هم یک شی داده را برمی گرداند که شامل یک شی فرعی جداگانه برای هر تاریخ/زمان و نماد درخواست شده است. تمام اشیاء پاسخ در زیر توضیح داده شده است.
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| تاریخ | تاریخ/زمان دقیق UTC را که داده های داده شده در قالب ISO-8601 جمع آوری شده است، برمی گرداند. |
| نماد | نماد تیک تیک سهام شی داده فعلی را برمی گرداند. |
| جلد | فاکتور تقسیم را برای آن نماد در تاریخ برمی گرداند. |
داده های سود سهام موجود در: همه برنامه ها
با استفاده از نقطه پایانی APIS سود سهام می توانید اطلاعات مربوط به سود سهام سهام را برای نمادهای مختلف جستجو کنید. شما می توانید یک درخواست API را در زیر پیدا کنید و امتحان کنید.
برای به دست آوردن داده های سود سهام ، می توانید از نقطه پایانی API در API استفاده کنید و نمادهای تیک تیک سهام مورد نظر خود را مشخص کنید.
توجه: برای درخواست داده های سود سهام برای نمادهای تک تیک ، می توانید از نقطه پایانی API نیز استفاده کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| نماد | [مورد نیاز] یک یا چند نماد سهام جدا شده با کاما (تیک) را برای درخواست خود مشخص کنید ، به عنوان مثالAAPL یا AAPL ، MSFT. هر نماد یک درخواست API را مصرف می کند. حداکثر: 100 نماد |
| مرتب سازی | [اختیاری] به طور پیش فرض ، نتایج بر اساس تاریخ/زمان نزولی طبقه بندی می شوند. برای مشخص کردن یک ترتیب مرتب سازی از این پارامتر استفاده کنید. مقادیر موجود: DESC (پیش فرض) ، ASC. |
| تاریخ از | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با عبور از تاریخ در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| تاریخ_تا | [اختیاری] نتایج را بر اساس یک بازه زمانی خاص با گذراندن یک تاریخ پایان در قالب YYYY-MM-DD فیلتر کنید. همچنین می توانید زمان دقیق را در قالب تاریخ ISO-8601 مشخص کنید، به عنوان مثال. 2020-05-21T00:00:00+0000. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
نمونه پاسخ API:
اگر درخواست API شما موفقیت آمیز بود، Marketstack API هم اطلاعات صفحه بندی و هم یک شی داده را برمی گرداند که شامل یک شی فرعی جداگانه برای هر تاریخ/زمان و نماد درخواست شده است. تمام اشیاء پاسخ در زیر توضیح داده شده است.
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| تاریخ | تاریخ/زمان دقیق UTC را که داده های داده شده در قالب ISO-8601 جمع آوری شده است، برمی گرداند. |
| نماد | نماد تیک تیک سهام شی داده فعلی را برمی گرداند. |
| جلد | سود سهام را برای آن نماد در تاریخ برمی گرداند. |
تیک های موجود در: همه برنامه ها
با استفاده از نقطه پایانی API ، می توانید اطلاعات مربوط به یک یا چند نماد تیک تیک سهام را جستجو کنید و همچنین داده های پایان روز ، زمان واقعی و بازار را برای تیکت های تک به دست آورید. شما می توانید یک درخواست API را در زیر پیدا کنید و امتحان کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
| هدف - شی | شرح |
|---|---|
| /Tickers/[نماد] | با اتصال آن به URL درخواست API ، به عنوان مثال ، اطلاعات مربوط به نماد تیکچر خاص را بدست آورید./Tickers/AAPL. |
| /Tickers/[نماد]/EOD | با اتصال /EOD به URL خود ، داده های پایان روز را برای یک صندوق سهام خاص بدست آورید ، به عنوان مثال/Tickers/AAPL/EOD. این مسیر از پارامترهای نقطه پایانی داده های پایان روز پشتیبانی می کند. |
| /Tickers/[Symbol]/Splits | با اتصال /تقسیم به URL خود ، داده های پایان روز را برای یک صندوق سهام خاص بدست آورید ، به عنوان مثال/Tickers/AAPL/Splits. این مسیر از پارامترهایی مانند تاریخ تاریخ تاریخ_ از تاریخ و date_to پشتیبانی می کند و همچنین می توانید نتایج DESC یا ASC را مرتب کنید. |
| /Tickers/[نماد]/سود سهام | با اتصال /سود سهام به URL خود ، داده های پایان روز را برای یک صندوق سهام خاص بدست آورید ، به عنوان مثال/Tickers/AAPL/سود سهام. این مسیر از پارامترهایی مانند تاریخ تاریخ تاریخ_ از تاریخ و date_to پشتیبانی می کند و همچنین می توانید نتایج DESC یا ASC را مرتب کنید. |
| /Tickers/[نماد]/Intraday | با وصل کردن /Intraday به URL خود ، داده های زمان واقعی و داخل را برای یک تیکار سهام خاص بدست آورید ، به عنوان مثال/Tickers/AAPL/intraday. این مسیر از پارامترهای نقطه پایانی داده های داخلی پشتیبانی می کند. |
| /Tickers/[نماد]/EOD/[تاریخ] | تاریخ را در قالب YYYY-MM-DD مشخص کنید. همچنین می توانید زمان دقیقی را در قالب تاریخ ISO-8601 مشخص کنید ، به عنوان مثال2020-05-21t00: 00: 00+0000. مثال: /EOD /2020-01-01 یا /intraday /2020-01-01 |
| /Tickers/[Symbol]/EOD/آخرین | آخرین داده های پایان روز را برای یک نماد سهام معین بدست آورید. مثال:/Tickers/AAPL/EOD/آخرین |
| /Tickers/[Symbol]/Intraday/Neart | آخرین داده های Intraday را برای یک نماد سهام خاص بدست آورید. مثال:/Tickers/AAPL/intraday/آخرین |
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| تبادل | [اختیاری] برای فیلتر کردن نتایج خود بر اساس یک بورس خاص ، از این پارامتر برای مشخص کردن شناسایی MIC بورس اوراق بهادار استفاده کنید. مثال: xnas |
| جستجو کردن | [اختیاری] از این پارامتر برای جستجوی سهام سهام با نام یا نماد تیک استفاده کنید. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
پاسخ API:
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| نام | نام کنه سهام داده شده را برمی گرداند. |
| نماد | نماد جعبه سهام داده شده را برمی گرداند. |
| stock_exchange>نام | نام بورس موجود در ارتباط با صندوق سهام داده شده را برمی گرداند. |
| stock_exchange>نامی | مخفف مخفف بورس اوراق بهادار مرتبط با کنه سهام داده شده را برمی گرداند. |
| stock_exchange>میکروفن | شناسایی MIC بورس اوراق بهادار مرتبط با تیک سهام داده شده را برمی گرداند. |
| stock_exchange>کشور | کشور بورس اوراق بهادار مرتبط با صندوق سهام داده شده را برمی گرداند. |
| stock_exchange>کد کشور | کد کشور 3 حرفی از بورس اوراق بهادار مرتبط با تیک سهام داده شده را برمی گرداند. |
| stock_exchange>شهر | شهر بورس اوراق بهادار مرتبط با صندوق سهام داده شده را برمی گرداند. |
| stock_exchange>سایت اینترنتی | URL وب سایت بورس اوراق بهادار مرتبط با کنه سهام داده شده را برمی گرداند. |
| timezone>منطقه زمانی | نام منطقه زمانی بورس موجود در ارتباط با صندوق سهام داده شده را برمی گرداند. |
| timezone>سعادت | مخفف منطقه زمانی بورس مربوط به تیکار سهام داده شده را برمی گرداند. |
| timezone>abbr_dst | بازگرداندن مخفف منطقه زمانی تابستان از بورس اوراق بهادار مرتبط با تیک سهام داده شده. |
شاخص های بازار موجود در: برنامه اصلی و بالاتر
API همچنین قادر به ارائه پایان روز برای 750+ از شاخص های اصلی جهان ، از جمله شاخص S& P 500 ، شاخص متوسط صنعتی داو جونز و همچنین شاخص کامپوزیت NASDAQ است. داده های فهرست هم بر اساس "آخرین" و هم از نظر تاریخی در دسترس است.
برای لیست یا دسترسی به داده های فهرست ، به سادگی از Indx به عنوان شناسایی MIC بورس خود عبور کنید ، همانطور که در مثالهای زیر مشاهده می شود. درخواست API مثال در زیر نحوه به دست آوردن داده های پایان روز برای شاخص بازار DJI را نشان می دهد.
مثال درخواست API:
http get parameters درخواست:
برای اطلاعات بیشتر در مورد پارامترهای درخواست ، لطفاً به بخش داده های پایان روز این مستندات مراجعه کنید.
پاسخ API:
اشیاء پاسخ API:
برای اطلاعات بیشتر در مورد اشیاء پاسخ ، لطفاً به بخش داده های پایان روز این مستندات مراجعه کنید.
شاخص های بازار در سایر نقاط پایانی API:
| هدف - شی | شرح |
|---|---|
| /مبادلات/indx/تیکرها | با عبور از Indx به عنوان شناسایی MIC Exchange ، تمام شاخص های موجود در بازار را بدست آورید. |
| /tickers/ociationsymbol | اطلاعات متا را برای یک شاخص خاص بازار بدست آورید. |
| /tickers/ociationsymbolociation. indx/eod | داده های پایان روز را برای یک شاخص خاص بازار بدست آورید. |
مبادلات موجود در: همه برنامه ها
با استفاده از نقطه انتهایی API مبادلات ، می توانید اطلاعاتی را در هر یک از 70+ بورس اوراق بهادار پشتیبانی شده توسط MarketStack جستجو کنید. شما می توانید یک درخواست API را در زیر پیدا کنید و امتحان کنید.
مثال درخواست API:
ویژگی های نقطه پایانی:
| هدف - شی | شرح |
|---|---|
| /مبادلات/[میکروفون] | با اتصال شناسایی MIC خود به URL درخواست API ، به عنوان مثال ، اطلاعات مربوط به بورس سهام خاص را بدست آورید./صرافی/xnas. |
| /مبادلات/[میکروفون]/تیکرها | با اتصال میکروفون مبادله و همچنین /تیک ، تمام تیک های موجود را برای یک مبادله خاص بدست آورید ، به عنوان مثال/صرافی/xnas/تیک. |
| /مبادلات/[MIC]/EOD | داده های پایان روز را برای همه تیک های موجود از یک مبادله خاص ، به عنوان مثال بدست آورید./صرافی/XNAS/EOD. برای پارامترها ، به نقطه پایانی داده های پایان روز مراجعه کنید. |
| /مبادلات/[MIC]/intraday | داده های داخلی را برای تیکت ها از یک مبادله خاص بدست آورید ، به عنوان مثال/صرافی/xnas/intraday. برای پارامترها ، به نقطه پایانی داده Intraday مراجعه کنید. |
| /مبادلات/[MIC]/EOD/[تاریخ] | داده های پایان روز را برای یک تاریخ خاص در قالب YYYY-MM-DD یا ISO-8601 بدست آورید. مثال:/مبادله/XNAS/EOD/2020-01-01. |
| /مبادلات/[MIC]/intraday/[تاریخ] | داده های روزانه را برای یک تاریخ و زمان خاص در قالب YYYY-MM-DD یا ISO-8601 دریافت کنید. مثال: /exchanges/IEXG/intraday/2020-05-21T00:00:00+0000 . |
| /exchanges/[mic]/eod/latest | آخرین داده های پایان روز را برای تیکرهای صرافی داده شده به دست آورید. مثال: /exchanges/XNAS/eod/latest |
| /exchanges/[mic]/intraday/latest | آخرین داده های روزانه را برای تیکرهای صرافی داده شده به دست آورید. مثال: /exchanges/IEXG/intraday/latest |
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| جستجو کردن | [اختیاری] از این پارامتر برای جستجوی بورس ها با نام یا MIC استفاده کنید. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
پاسخ API:
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| نام | نام بورس اوراق بهادار داده شده را برمی گرداند. |
| مخفف | مخفف بورس اوراق بهادار داده شده را برمی گرداند. |
| میکروفون | شناسه MIC بورس اوراق بهادار داده شده را برمی گرداند. |
| کشور | کشور بورس اوراق بهادار داده شده را برمی گرداند. |
| کد کشور | کد کشور 3 حرفی بورس اوراق بهادار داده شده را برمی گرداند. |
| شهر | شهر داده شده بورس را برمی گرداند. |
| سایت اینترنتی | نشانی وب سایت بورس اوراق بهادار داده شده را برمی گرداند. |
| timezone>منطقه زمانی | نام منطقه زمانی بورس اوراق بهادار داده شده را برمی گرداند. |
| timezone>سعادت | مخفف منطقه زمانی بورس اوراق بهادار داده شده را برمی گرداند. |
| timezone>abbr_dst | مخفف منطقه زمانی تابستانی بورس اوراق بهادار داده شده را برمی گرداند. |
ارزهای موجود در: همه طرح ها
با استفاده از نقطه پایانی API ارزها، می توانید تمام ارزهای پشتیبانی شده توسط Marketstack API را جستجو کنید. در زیر می توانید نمونه درخواست API را پیدا کرده و امتحان کنید.
مثال درخواست API:
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
پاسخ API:
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| رمز | کد 3 حرفی از ارز داده شده را برمی گرداند. |
| نام | نام ارز داده شده را برمی گرداند. |
| نماد | نماد متن ارز داده شده را برمی گرداند. |
| نماد_نهای | نماد متن بومی ارز داده شده را برمی گرداند. |
زمان های زمانی موجود در: همه برنامه ها
با استفاده از نقطه انتهایی API TimeZones می توانید اطلاعات مربوط به همه مناطق زمانی پشتیبانی شده را جستجو کنید. شما می توانید یک درخواست API را در زیر پیدا کنید و امتحان کنید.
مثال درخواست API:
http get parameters درخواست:
| هدف - شی | شرح |
|---|---|
| کلید دسترسی | [مورد نیاز] کلید دسترسی API خود را ، موجود در داشبورد حساب خود مشخص کنید. |
| حد | [اختیاری] یک محدودیت صفحه بندی (تعداد نتایج در هر صفحه) برای درخواست API خود تعیین کنید. مقدار حد پیش فرض 100 است، حداکثر مقدار مجاز مجاز 1000 است. |
| انحراف | [اختیاری] یک مقدار افست صفحه بندی برای درخواست API خود مشخص کنید. مثال: مقدار افست 100 همراه با مقدار حدی 10 نتایج 100-110 را نشان می دهد. مقدار پیش فرض 0 است که با اولین نتیجه موجود شروع می شود. |
پاسخ API:
اشیاء پاسخ API:
| شی پاسخ | شرح |
|---|---|
| pagination>حد | مقدار محدود صفحه بندی شما را برمی گرداند. |
| pagination>انحراف | مقدار افست صفحه بندی شما را برمی گرداند. |
| pagination>شمردن | تعداد نتایج را در صفحه فعلی برمی گرداند. |
| pagination>جمع | تعداد کل نتایج موجود را برمی گرداند. |
| منطقه زمانی | نام منطقه زمانی داده شده را برمی گرداند. |
| سعادت | اختصار منطقه زمانی داده شده را برمی گرداند. |
| abbr_dst | به اختصار زمان تابستان از منطقه زمانی داده شده برمی گردد. |
نمونه های کد
ما مجموعه ای از نمونه های کد دستی را در زبانهای مختلف برنامه نویسی از جمله PHP ، Python ، Node. js ، jQuery ، Go و Ruby تهیه کرده ایم. تمام نمونه های کد موجود را در زیر پیدا خواهید کرد.
بهترین استراتژی معاملات...
ما را در سایت بهترین استراتژی معاملات دنبال می کنید
برچسب :
نویسنده : صدرا ذوالریاستین
بازدید : 66
