FACTSET व्यवहार संदेशांचे थेट प्रवाह API सॉफ्टवेअर वापरकर्ता मार्गदर्शक

प्रेरणा
पोर्टफोलिओ निरीक्षण, व्यापार सिम्युलेशन, कार्यप्रदर्शन विशेषता आणि रिटर्न्स विश्लेषणासाठी FactSet च्या रिअल-टाइम पोर्टफोलिओ मॅनेजमेंट प्लॅटफॉर्म (PMP) सह कोणत्याही OMS प्रदात्याकडून रेकॉर्ड कनेक्ट करण्याचा मार्ग प्रदान करणे आणि व्यापार डेटा एकत्रित करण्याचा मार्ग प्रदान करणे हे व्यवहार संदेश API च्या थेट प्रवाहामागील प्रेरणा आहे. .

API प्रोग्राम

ओव्हरview
API प्रोग्राम सुरुवातीला पोर्टफोलिओ विश्लेषण इंजिनवर लक्ष केंद्रित करतो आणि विविध व्यवसाय युनिट्समधील इतर विश्लेषण इंजिन, उत्पादने आणि API समाविष्ट करण्यासाठी त्याचा विस्तार केला आहे.

कार्यक्रम खालील प्रदान करतो:

व्यवहार संदेश API चे थेट प्रवाह

सर्व API अंतर्गत होस्ट केलेले आहेत https://api.factset.com. प्रमाणीकरण API की वापरून हाताळले जाते आणि FactSet चे इन-हाउस सबस्क्रिप्शन उत्पादन वापरून अधिकृतता हाताळली जाते. API की वापरण्याबाबत अधिक माहितीसाठी, कृपया भेट द्या https://developer.factset.com/authentication.

कृपया लक्षात ठेवा की HTTP विनंती आणि प्रतिसाद शीर्षलेख नावे HTTP मानकानुसार केस असंवेदनशील मानली जावीत. तुमच्या कोडमधील शीर्षलेखांच्या केस-संवेदनशील जुळणीवर अवलंबून न राहण्याची शिफारस केली जाते.

उत्पादन वापर सूचना

DSoTM API

नोंदी जमा करणे

व्यवहार रेकॉर्ड सबमिट करण्यासाठी, खालील एंडपॉइंट वापरा:
POST/analytics/dsotm/v1/व्यवहार

शीर्षलेखांची विनंती करा

अधिकृतता
मानक HTTP शीर्षलेख. मूल्याला 'मूलभूत' स्वरूप वापरण्याची आवश्यकता आहे.

सामग्री-प्रकार
मानक HTTP शीर्षलेख. मुख्य भाग JSON फॉरमॅटमध्ये आहे हे दर्शविण्यासाठी मूल्य अनुप्रयोग/JSON म्हणून निर्दिष्ट करणे आवश्यक आहे.

समस्यानिवारण
समस्यानिवारण माहितीसाठी, कृपया विकसकाच्या मॅन्युअल आणि संदर्भातील कलम 4 पहा.

आवृत्ती अपग्रेड
आवृत्ती सुधारणांबद्दल माहिती विकसकाच्या मॅन्युअल आणि संदर्भाच्या कलम 5 मध्ये आढळू शकते.

वारंवार विचारले जाणारे प्रश्न

प्रश्न: व्यवहार संदेश API च्या थेट प्रवाहाचा उद्देश काय आहे?
A: ट्रान्झॅक्शन मेसेजेस API च्या डायरेक्ट स्ट्रीमिंगचा उद्देश पोर्टफोलिओ निरीक्षण, ट्रेड सिम्युलेशन, परफॉर्मन्स अॅट्रिब्युशन आणि रिटर्न्स अॅनालिसिससाठी FactSet च्या पोर्टफोलिओ मॅनेजमेंट प्लॅटफॉर्मसह कोणत्याही OMS प्रदात्याकडून व्यापार डेटा कनेक्ट करणे आहे.

प्रश्न: API की वापरण्याबद्दल मला अधिक माहिती कोठे मिळेल?
A: API की वापरण्याबद्दल अधिक माहिती येथे मिळू शकते https://developer.factset.com/authentication.

प्रेरणा

1997 मध्ये, FactSet ने पोर्टफोलिओ विश्लेषण 1.0 लाँच केले, ज्याने Analytics साठी पाया तयार केला. लवकरच, पोर्टफोलिओ विश्लेषण 2.0 ने तृतीय-पक्ष विक्रेत्यांकडून जोखीम विश्लेषणे एकत्रित केली आणि नंतर 2004 मध्ये निश्चित उत्पन्न समाविष्ट करण्यासाठी विस्तारित केले. FactSet आता बहु-मालमत्ता पोर्टफोलिओ विश्लेषण उत्पादनांचा एक मजबूत संच ऑफर करते जे लवचिकता, विश्लेषणे आणि रुंदीमध्ये बाजाराचे नेतृत्व करतात. आज, क्लायंट पोर्टफोलिओ विश्लेषण (PA), SPAR, अल्फा टेस्टिंग, ऑप्टिमायझर्स आणि पोर्टफोलिओ डॅशबोर्ड, तसेच पोर्टफोलिओ बॅचर, प्रकाशक फ्लॅट द्वारे विश्लेषणाचे वितरण यांसारख्या विविध उत्पादनांद्वारे परस्परसंवादी विश्लेषणासाठी FactSet वर अवलंबून असतात. Files, आणि प्रकाशक दस्तऐवज.

API प्रोग्राम

ओव्हरview

ग्राहक एक सानुकूल समाधान तयार करण्याच्या दिशेने वाटचाल करत आहेत, जे एका वापरकर्त्याच्या अनुभवामध्ये माहिती एकत्रित करून उत्पादकता वाढवण्याची गरज आहे. API द्वारे विश्लेषणे, कार्यप्रदर्शन आणि जोखीम उघड करून, ते तुम्हाला FactSet च्या आघाडीच्या बहु-मालमत्ता विश्लेषणाशी संवाद साधण्यासाठी एक अत्याधुनिक चॅनेल प्रदान करते. बाजार अधिक पारदर्शकता आणि डेटाची मागणी करत असल्याने, FactSet त्या मागण्या पूर्ण करण्यासाठी लवचिक पर्याय प्रदान करेल. APIs सध्याच्या विश्लेषण संच ऑफरिंगला पूरक आहेत आणि तुम्हाला खाजगी अनुभव तयार करण्यास, Tableau सारख्या तृतीय-पक्ष BI साधनांसह आणि RStudio सारख्या तृतीय-पक्ष स्टेट पॅकेजेससह एकत्रित करण्याची परवानगी देऊन आणि FactSet वरून विश्लेषणाच्या अंतर्गत वापरावर नियंत्रण वाढवून भागीदारी सुलभ करतात.

प्रथम एसtagई एक्स्पोजिंग अॅनालिटिक्स एपीआय पोर्टफोलिओ अॅनालिटिक्स इंजिनवर लक्ष केंद्रित करेल. त्याच्या स्थापनेपासून, इतर व्यवसाय युनिट्समधील इतर विश्लेषण इंजिन, उत्पादने आणि API समाविष्ट करण्यासाठी प्रोग्रामचा विस्तार झाला आहे.

कार्यक्रम खालील प्रदान करतो:

संकल्पनेचा पुरावा तयार करण्यासाठी विकसक टूलकिट
FactSet च्या एंटरप्राइझ-स्केल API मध्ये एकसमान अनुभव
उद्योग मानकांचे पालन
आवृत्ती केलेले API
डेव्हलपर पोर्टलवर विस्तृत दस्तऐवज आणि ट्यूटोरियल

व्यवहार संदेश API चे थेट प्रवाह

पोर्टफोलिओ निरीक्षण आणि ट्रेड सिम्युलेशनसाठी FactSet च्या रिअल-टाइम पोर्टफोलिओ मॅनेजमेंट प्लॅटफॉर्म (PMP) सह तुमचा व्यापार डेटा एकत्रित करण्यासाठी किंवा परफॉर्मन्स अॅट्रिब्यूशन आणि रिटर्न्स विश्लेषणासाठी शक्तिशाली पोर्टफोलिओ अॅनालिटिक्स इंजिनमध्ये वापरण्यासाठी कोणत्याही OMS प्रदात्याकडून रेकॉर्ड कनेक्ट करा.
सर्व API अंतर्गत होस्ट केलेले आहेत https://api.factset.com. प्रमाणीकरण API की वापरून हाताळले जाते आणि FactSet चे इन-हाउस सबस्क्रिप्शन उत्पादन वापरून अधिकृतता हाताळली जाते. तुम्ही API की वापरण्याबद्दल अधिक माहिती येथे शोधू शकता https://developer.factset.com/authentication.

HTTP विनंती आणि प्रतिसाद शीर्षलेख नावे HTTP मानकानुसार केस असंवेदनशील मानली जावीत. कृपया तुमच्या कोडमधील शीर्षलेखांच्या केस-संवेदनशील जुळणीवर अवलंबून राहू नका.

नोंदी जमा करणे

व्यवहार सबमिट करा
POST/analytics/dsotm/v1/व्यवहार

हा एंडपॉईंट व्यवहाराच्या नोंदी स्वीकारतो आणि त्याच वेळी त्यांना निर्दिष्ट पोर्टफोलिओच्या OMS_OFDB वर लिहितो आणि PMP ऍप्लिकेशनमध्ये उपलब्ध करून देतो.

शीर्षलेखांची विनंती करा

शीर्षलेखाचे नाव	वर्णन
अधिकृतता	मानक HTTP शीर्षलेख. मूल्य 'मूलभूत' वापरणे आवश्यक आहे ' स्वरूप.
सामग्री-प्रकार	मानक HTTP शीर्षलेख. मूल्याला ऍप्लिकेशन/JSON निर्दिष्ट करणे आवश्यक आहे (म्हणजे, कॉलरने मुख्य भाग JSON स्वरूपात असल्याचे निर्दिष्ट करणे आवश्यक आहे).

विनंती शरीर
विनंती मुख्य भाग गणना पॅरामीटर्सचा संग्रह स्वीकारतो. पॅरामीटर्स खाली दिले आहेत:

पॅरामीटर नाव	डेटा प्रकार	आवश्यक आहे	वर्णन	स्वरूप
फाशी	ॲरे	नाही	अंमलबजावणीच्या नोंदींची यादी	तपशीलवार रेकॉर्ड फील्ड येथे उपलब्ध आहेत
प्लेसमेंट	ॲरे	नाही	प्लेसमेंट रेकॉर्डची यादी	तपशीलवार रेकॉर्ड फील्ड येथे उपलब्ध आहेत
ऑर्डर	ॲरे	नाही	ऑर्डर रेकॉर्डची यादी	तपशीलवार रेकॉर्ड फील्ड येथे उपलब्ध आहेत

प्रतिसाद शीर्षलेख

शीर्षलेखाचे नाव	वर्णन
एक्स-डेटा डायरेक्ट-विनंती-की	FactSet च्या विनंती की शीर्षलेख.
X-FactSet-Api-विनंती-की	अनन्यपणे Analytics API विनंती ओळखण्यासाठी की. यशस्वी प्रमाणीकरणानंतरच उपलब्ध.
X-FactSet-Api-RateLimit-मर्यादा	टाइम विंडोसाठी अनुमत विनंत्यांची संख्या.
X-FactSet-Api-RateLimit-उर्वरित	टाइम विंडोसाठी राहिलेल्या विनंत्यांची संख्या.
X-FactSet-Api-RateLimit-रीसेट	दर मर्यादा रीसेट होईपर्यंत उर्वरित सेकंदांची संख्या.

परतावा

HTTP स्थिती कोड	वर्णन
202	अपेक्षित प्रतिसाद.
400	अवैध POST मुख्य भाग.
401	गहाळ किंवा अवैध प्रमाणीकरण.
403	वापरकर्त्यास वर्तमान क्रेडेन्शियलसह निषिद्ध आहे.
415	गहाळ/अवैध सामग्री-प्रकार शीर्षलेख. शीर्षलेख अनुप्रयोग/json वर सेट करणे आवश्यक आहे.
429	दर मर्यादा गाठली होती. री-ट्राय-आफ्टर हेडरमध्ये नमूद केलेल्या वेळेची प्रतीक्षा केल्यानंतर विनंत्यांचा पुन्हा प्रयत्न करा.
500	सर्व्हर त्रुटी. समस्यानिवारणात मदत करण्यासाठी X-DataDirect-Request-Key शीर्षलेख लॉग करा.
503	विनंती कालबाह्य. काही वेळाने विनंतीचा पुन्हा प्रयत्न करा.

शेरा
प्रत्येक API साठी 50-सेकंद विंडोमध्ये जास्तीत जास्त 5 POST विनंत्यांना अनुमती आहे. API प्रतिसादात उपलब्ध विविध दर-मर्यादा शीर्षलेख वापरून ते सत्यापित केले जाऊ शकते.

X-FactSet-Api-RateLimit-Limit – टाइम विंडोसाठी अनुमत विनंत्यांची संख्या.
X-FactSet-Api-RateLimit-Remaining – टाइम विंडोसाठी उरलेल्या विनंत्यांची संख्या.

X-FactSet-Api-RateLimit-Reset – दर मर्यादा रीसेट होईपर्यंत उर्वरित सेकंदांची संख्या.

Exampलेस

विनंती:
पोस्ट https://api.factset.com/analytics/dsotm/v1/transactions.

शीर्षलेख:

सामग्री-प्रकार: अनुप्रयोग/json
अधिकृतता: मूलभूत RkRTX0RFTU9fVVMt******************************
स्वीकार-एनकोडिंग: gzip
सामग्री-लांबी: 201

शरीर:

प्रतिसाद:
HTTP 202 स्वीकारले

शीर्षलेख:

x-data direct-request-key: zpdo6aebv58fiaoi
x-factset-api-request-key: 6p2d41m4sw1yfh0h

रेकॉर्ड फील्ड

अंमलबजावणी निर्मिती

घटक	प्रकार	वर्णन	अनिवार्य
पोर्टफोलिओ	स्ट्रिंग	पोर्टफोलिओचे नाव. उदा: क्लायंट:/DEMO.OFDB	होय
व्यवहार-आयडी	स्ट्रिंग	व्यवहारासाठी युनिक आयडी	होय
चिन्ह	स्ट्रिंग	व्यापार केलेल्या इन्स्ट्रुमेंटशी संबंधित चिन्ह. उदा: AAPL	होय
वर्णन	स्ट्रिंग	सहसा नाव, उदा: FACTSET संशोधन प्रणाली, परंतु डेरिव्हेटिव्हसाठी अधिक वर्णनात्मक असू शकते.	होय
व्यापार प्रकार	स्ट्रिंग	BL (लाँग विकत घ्या), BC (कव्हर करण्यासाठी खरेदी करा), SL (लाँग विक्री करा) आणि SS (लहान विक्री करा)	होय
स्थिती	स्ट्रिंग	ACCT किंवा CNCL, ACCOUNTED आणि CANCELED साठी लहान	होय
व्यापार तारीख	स्ट्रिंग	व्यापार तारीख जी YYYYMMDD फॉरमॅटमध्ये आहे	होय
व्यवहाराची पाने	तरंगणे	ज्या शेअर्सची ऑर्डर देण्यात आली आहे आणि त्याची अंमलबजावणी झाली नाही	नाही
रक्कम	तरंगणे	व्यापार केलेल्या साधनाचे प्रमाण	होय
निव्वळ	तरंगणे	व्यवहाराचे रोख मूल्य, ब्रोकरेज खर्चाचे निव्वळ.	होय
स्थूल	तरंगणे	ब्रोकरेज खर्चासह व्यवहाराचे रोख मूल्य.	होय
सेटलमेंट मूल्य	तरंगणे	व्यवहाराचे रोख मूल्य हे असे मूल्य आहे जे स्थानिक चलनात बुक केलेले व्यवहार अहवाल चलनात रूपांतरित करण्यासाठी लागू असलेल्या FX दराने गुणाकार केले आहे.	होय
सेटलमेंट तारीख	स्ट्रिंग	सेटलमेंटची तारीख YYYYMMDD फॉरमॅटमध्ये	होय
चलन	स्ट्रिंग	रोख मूल्याच्या फील्डचा चलन कोड, निव्वळ रक्कम आणि एकूण रक्कम.	होय
परकीय चलन दर	तरंगणे	एफएक्स रेट जो PA द्वारे उचलला जाऊ शकतो, रोख मूल्य असलेल्या फील्डसह गुणाकार केला जातो, नेट, ग्रॉस, PA ला अहवाल देणाऱ्या चलनामध्ये व्यवहार दर्शवू शकतो.	नाही
सेटलमेंट चलन iso	स्ट्रिंग	सेटलमेंट मूल्यासाठी चलन कोड	होय
आदेश दिले	स्ट्रिंग	ऑर्डरचा युनिक आयडेंटिफायर PM Hub द्वारे प्रदान केला जातो. उदा: O_FDS_010623_1686393260254	नाही
पालक आयडी	स्ट्रिंग	OMS द्वारे प्रदान केल्या जाणार्‍या पालक ऑर्डरचा अद्वितीय ओळखकर्ता.	नाही

ऑर्डर निर्मिती

घटक	प्रकार	वर्णन	अनिवार्य
पोर्टफोलिओ	स्ट्रिंग	पोर्टफोलिओचे नाव. उदा: क्लायंट:/DEMO.OFDB	होय

व्यवहार-आयडी	स्ट्रिंग	व्यवहारासाठी युनिक आयडी	होय
चिन्ह	स्ट्रिंग	व्यापार केलेल्या इन्स्ट्रुमेंटशी संबंधित चिन्ह. उदा: AAPL	होय
वर्णन	स्ट्रिंग	सहसा नाव, उदा: FACTSET संशोधन प्रणाली, परंतु डेरिव्हेटिव्हसाठी अधिक वर्णनात्मक असू शकते.	होय
व्यापार प्रकार	स्ट्रिंग	BL (लाँग विकत घ्या), BC (कव्हर करण्यासाठी खरेदी करा), SL (लाँग विक्री करा) आणि SS (लहान विक्री करा)	होय
स्थिती	स्ट्रिंग	ACCT किंवा CNCL, ACCOUNTED आणि CANCELED साठी लहान	होय
व्यापार तारीख	स्ट्रिंग	व्यापार तारीख जी YYYYMMDD फॉरमॅटमध्ये आहे	होय
व्यवहाराची पाने	तरंगणे	ज्या शेअर्सची ऑर्डर देण्यात आली आहे परंतु त्याची अंमलबजावणी झाली नाही	नाही
रक्कम	तरंगणे	व्यापार केलेल्या साधनाचे प्रमाण	होय
चलन iso	स्ट्रिंग	रोख मूल्याच्या फील्डचा चलन कोड, निव्वळ रक्कम आणि एकूण रक्कम.	होय
परकीय चलन दर	तरंगणे	एफएक्स रेट जो PA द्वारे उचलला जाऊ शकतो, रोख मूल्य असलेल्या फील्डसह गुणाकार केला जातो, नेट, ग्रॉस, PA ला अहवाल देणाऱ्या चलनामध्ये व्यवहार दर्शवू शकतो.	नाही
ऑर्डर आयडी	स्ट्रिंग	ऑर्डरचा युनिक आयडेंटिफायर PM Hub द्वारे प्रदान केला जातो. उदा: O_FDS_010623_1686393260254	नाही

प्लेसमेंट निर्मिती

घटक	प्रकार	वर्णन	अनिवार्य
पोर्टफोलिओ	स्ट्रिंग	पोर्टफोलिओचे नाव. उदा: क्लायंट:/DEMO.OFDB	होय
व्यवहार-आयडी	स्ट्रिंग	व्यवहारासाठी युनिक आयडी	होय
चिन्ह	स्ट्रिंग	व्यापार केलेल्या इन्स्ट्रुमेंटशी संबंधित चिन्ह. उदा: AAPL	होय
वर्णन	स्ट्रिंग	सहसा नाव, उदा: FACTSET संशोधन प्रणाली, परंतु डेरिव्हेटिव्हसाठी अधिक वर्णनात्मक असू शकते.	होय
व्यापार प्रकार	स्ट्रिंग	BL (लाँग विकत घ्या), BC (कव्हर करण्यासाठी खरेदी करा), SL (लाँग विक्री करा) आणि SS (लहान विक्री करा)	होय
स्थिती	स्ट्रिंग	ACCT किंवा CNCL, ACCOUNTED आणि CANCELED साठी लहान	होय
व्यापार तारीख	स्ट्रिंग	व्यापार तारीख जी YYYYMMDD फॉरमॅटमध्ये आहे	होय
व्यवहाराची पाने	तरंगणे	ज्या शेअर्सची ऑर्डर देण्यात आली आहे परंतु त्याची अंमलबजावणी झाली नाही	नाही
रक्कम	तरंगणे	व्यापार केलेल्या साधनाचे प्रमाण	होय
चलन iso	स्ट्रिंग	रोख मूल्याच्या फील्डचा चलन कोड, निव्वळ रक्कम आणि एकूण रक्कम.	होय

परकीय चलन दर	तरंगणे	एफएक्स रेट जो PA द्वारे उचलला जाऊ शकतो, रोख मूल्य असलेल्या फील्डसह गुणाकार केला जातो, नेट, ग्रॉस, PA ला अहवाल देणाऱ्या चलनामध्ये व्यवहार दर्शवू शकतो.	नाही
सेटलमेंट चलन iso	स्ट्रिंग	सेटलमेंट मूल्यासाठी चलन कोड	होय
ऑर्डर आयडी	स्ट्रिंग	ऑर्डरचा युनिक आयडेंटिफायर PM Hub द्वारे प्रदान केला जातो. उदा: O_FDS_010623_1686393260254	नाही
पालक आयडी	स्ट्रिंग	OMS द्वारे प्रदान केल्या जाणार्‍या पालक ऑर्डरचा अद्वितीय ओळखकर्ता.	नाही

समस्यानिवारण

कोणत्याही भिन्न API मधील त्रुटींचे निवारण करण्यासाठी खालील चरणांची शिफारस केली जाते:

X-DataDirect-Request-Key प्रतिसाद शीर्षलेख रेकॉर्ड करा जेणेकरून FactSet चा API अभियांत्रिकी कार्यसंघ तुमच्या विशिष्ट विनंती/प्रतिसादाचे विश्लेषण करू शकेल.
जेव्हा प्रतिसाद त्रुटी प्रतिसाद असतो तेव्हा प्रतिसाद मुख्य भाग रेकॉर्ड करा. सर्व HTTP स्थिती कोड 400 च्या समान आणि त्याहून अधिक त्रुटी प्रतिसाद मानले जातात.

सहाय्यासाठी वरील माहितीसह तुमच्या खाते टीमशी संपर्क साधा.

आवृत्ती अपग्रेड

FactSet मर्यादित काळासाठी जुन्या API आवृत्त्यांचे समर्थन करेल. वास्तविक समर्थन वेळ API आणि प्रकाशन s वर अवलंबून असेलtage (म्हणजे बीटा किंवा उत्पादन). सर्व ब्रेकिंग बदल, कार्यक्षमता जोडणे आणि मागील आवृत्त्यांमधील दोष निराकरणे चेंजलॉगमध्ये दस्तऐवजीकरण केली जातील.

FactSet चा API अभियांत्रिकी कार्यसंघ नवीन आवृत्त्यांमध्ये सहज संक्रमण सुनिश्चित करण्यासाठी क्लायंटसह कार्य करेल.

FactSet Research Systems Inc. | www.factset.com.

कागदपत्रे / संसाधने

FACTSET व्यवहार संदेश API सॉफ्टवेअरचे थेट प्रवाह [pdf] वापरकर्ता मार्गदर्शक
आवृत्ती 1.0, व्यवहार संदेश API सॉफ्टवेअरचे थेट प्रवाह, व्यवहार संदेश API सॉफ्टवेअरचे प्रवाह, व्यवहार संदेश API सॉफ्टवेअर, संदेश API सॉफ्टवेअर, API सॉफ्टवेअर, सॉफ्टवेअर

संदर्भ

वापरकर्ता मॅन्युअल

FACTSET व्यवहार संदेश API सॉफ्टवेअरचे थेट प्रवाह

उत्पादन माहिती