FACTSET Direktang Pag-stream Sa Mga Mensahe sa Transaksyon API Software
Impormasyon sa Produkto
Mga detalye
- Ngalan sa Produkto: Direkta nga Pag-stream sa Transaction Messages API
- Bersyon: 1.0
- Manual sa Developer ug Petsa sa Reperensya: Agosto 2023
Pagdasig
Ang motibasyon luyo sa Direct Streaming of Transaction Messages API mao ang paghatag og paagi sa pagkonektar sa mga rekord gikan sa bisan unsang OMS provider ug paghiusa sa trade data sa FactSet's real-time Portfolio Management Platform (PMP) para sa portfolio oversight, trade simulation, performance attribution, ug returns analysis .
Programa sa API
Tapos naview
Ang API Program sa sinugdan nagpunting sa portfolio analytics engine ug gipalapdan aron maapil ang ubang mga makina sa analytics, produkto, ug mga API gikan sa lainlaing mga yunit sa negosyo.
Ang programa naghatag sa mosunod:
- Direkta nga Pag-stream sa Transaction Messages API
Ang tanan nga mga API gi-host sa ilawom https://api.factset.com. Ang authentication gidumala gamit ang API Keys, ug ang pagtugot gidumala gamit ang in-house nga mga subskripsyon nga produkto sa FactSet. Para sa dugang nga impormasyon sa paggamit sa API Keys, palihog bisitaha https://developer.factset.com/authentication.
Palihug timan-i nga ang HTTP request ug response header names kinahanglan isipon nga case insensitive sumala sa HTTP Standard. Girekomenda nga dili magsalig sa case-sensitive nga pagpares sa mga header sa imong code.
Mga Instruksyon sa Paggamit sa Produkto
DSoTM API
Pagsumiter sa mga Rekord
- Aron isumite ang mga rekord sa transaksyon, gamita ang mosunod nga endpoint:
- POST /analytics/dsotm/v1/transactions
Paghangyo sa mga ulohan
- Awtorisasyon
Standard nga HTTP header. Ang bili kinahanglan nga gamiton ang 'Basic' nga pormat. - Type-Content
Standard nga HTTP header. Ang bili kinahanglang ipiho isip aplikasyon/JSON aron ipakita nga ang lawas anaa sa JSON nga format.
Pag-troubleshoot
Para sa impormasyon sa pag-troubleshoot, palihog tan-awa ang seksyon 4 sa Manwal ug Reference sa Developer.
Pag-upgrade sa Bersyon
Ang impormasyon bahin sa mga pag-upgrade sa bersyon makita sa seksyon 5 sa Manwal ug Reference sa Developer.
FAQ
- P: Unsa ang katuyoan sa Direktang Pag-stream sa Transaction Messages API?
A: Ang katuyoan sa Direct Streaming of Transaction Messages API mao ang pagkonektar sa trade data gikan sa bisan unsang OMS provider sa FactSet's Portfolio Management Platform para sa portfolio oversight, trade simulation, performance attribution, ug returns analysis. - P: Asa man ko makakitag dugang impormasyon bahin sa paggamit sa API Keys?
A: Dugang nga impormasyon bahin sa paggamit sa API Keys makita sa https://developer.factset.com/authentication.
Pagdasig
Sa 1997, ang FactSet naglunsad sa Portfolio Analysis 1.0, nga nagtakda sa pundasyon alang sa Analytics. Sa wala madugay pagkahuman, ang Portfolio Analysis 2.0 naghiusa sa mga analytics sa peligro gikan sa mga tigbaligya sa ikatulo nga partido, ug dayon gipalapdan aron maapil ang Fixed Income kaniadtong 2004. Ang FactSet karon nagtanyag usa ka lig-on nga suite sa mga produkto nga analisa sa portfolio nga multi-asset nga nanguna sa merkado sa pagka-flexible, analytics, ug gilapdon. Karon, ang mga kliyente nagsalig sa FactSet alang sa interactive analytics pinaagi sa lainlaing mga produkto, sama sa Portfolio Analysis (PA), SPAR, Alpha Testing, Optimizers, ug Portfolio Dashboard, ingon man ang pag-apod-apod sa analytics pinaagi sa Portfolio Batcher, Publisher Flat Files, ug mga dokumento sa Publisher.
Programa sa API
Tapos naview
Ang mga kliyente nagpadayon sa paghimo sa usa ka kostumbre nga solusyon, nga gimaneho sa panginahanglan nga madugangan ang pagka-produktibo pinaagi sa pagkonsolida sa kasayuran sa usa ka kasinatian sa gumagamit. Pinaagi sa pagbutyag sa analytics, performance, ug risgo pinaagi sa mga API, naghatag kini kanimo og usa ka sopistikado nga channel aron makig-uban sa nanguna nga multi-asset analytics sa FactSet. Samtang ang merkado nagpadayon sa pagpangayo ug dugang nga transparency ug data, ang FactSet maghatag ug flexible nga mga kapilian aron matubag ang mga gipangayo. Ang mga API nagsangkap sa kasamtangan nga analytics suite nga mga halad ug nagpadali sa mga panag-uban pinaagi sa pagtugot kanimo sa paghimo og mga pribadong kasinatian, pag-integrate sa mga third-party nga BI tool sama sa Tableau, ug mga third-party stat packages sama sa RStudio, ug pagdugang sa kontrol sa internal nga konsumo sa analytics gikan sa FactSet.
Ang unang stage sa pagbutyag sa mga Analytics API magtutok sa portfolio analytics engine. Sukad sa pagsugod niini, ang programa nagpalapad nga naglakip sa ubang mga makina sa analytics, produkto, ug mga API gikan sa ubang mga yunit sa negosyo.
Ang programa naghatag sa mosunod:
- Toolkit sa developer aron makahimo og pruweba sa konsepto
- Uniporme nga bation sa tanan nga mga enterprise-scale API sa FactSet
- Pagsunod sa mga sumbanan sa industriya
- Mga bersyon nga API
- Daghang dokumentasyon ug mga panudlo sa portal sa developer
Direkta nga Pag-stream sa Transaction Messages API
- Ikonektar ang mga rekord gikan sa bisan unsang OMS provider aron i-integrate ang imong trade data sa FactSet's real-time Portfolio Management Platform (PMP) para sa portfolio oversight ug trade simulation, o gamiton sa gamhanang Portfolio Analytics Engine for Performance Attribution and Returns analysis.
- Ang tanan nga mga API gi-host sa ilawom https://api.factset.com. Ang authentication gidumala gamit ang API Keys ug ang pagtugot gidumala gamit ang in-house nga mga subskripsyon nga produkto sa FactSet. Makita nimo ang dugang nga impormasyon bahin sa paggamit sa API Keys sa https://developer.factset.com/authentication.
Ang HTTP nga hangyo ug tubag nga mga ngalan sa header kinahanglan isipon nga case insensitive sumala sa HTTP Standard. Palihug ayaw pagsalig sa case-sensitive nga pagpares sa mga ulohan sa imong code.
Pagsumiter sa mga Rekord
Isumiter ang mga Transaksyon
POST /analytics/dsotm/v1/transactions
Kini nga endpoint modawat sa mga rekord sa transaksyon ug dungan nga isulat kini ngadto sa piho nga portfolio sa OMS_OFDB ug himoon kini nga anaa sa PMP nga aplikasyon.
Paghangyo sa mga ulohan
| Ngalan sa ulohan | Deskripsyon |
| Awtorisasyon | Standard nga HTTP header. Ang bili kinahanglan nga gamiton ang 'Basic ' format. |
| Kontento-Type | Standard nga HTTP header. Ang kantidad kinahanglan nga ipiho ang aplikasyon/JSON (ie, ang nagtawag kinahanglan nga ipiho nga ang lawas naa sa format nga JSON). |
Lawas sa Paghangyo
Gidawat sa lawas sa hangyo ang usa ka koleksyon sa mga parameter sa pagkalkula. Ang mga parameter gilatid sa ubos:
| Ngalan sa parameter | Matang sa datos | Gikinahanglan | Deskripsyon | Porma |
| mga pagpatay | Array | Dili | Listahan sa mga rekord sa pagpatay | Ang mga detalyadong talaan sa talaan anaa dinhi |
| mga pagbutang | Array | Dili | Listahan sa mga rekord sa pagbutang | Ang mga detalyadong talaan sa talaan anaa dinhi |
| mga order | Array | Dili | Listahan sa mga rekord sa order | Ang mga detalyadong talaan sa talaan anaa dinhi |
Mga Ulohan sa Tubag
| Ngalan sa ulohan | Deskripsyon |
| X-DataDirect-Request-yawe | Ang hangyo sa FactSet nga yawe nga ulohan. |
| X-FactSet-Api-Request-Key | Yawe sa talagsaon nga pag-ila sa usa ka hangyo sa Analytics API. Magamit ra pagkahuman sa malampuson nga pag-authenticate. |
| X-FactSet-Api-RateLimit-Limit | Gidaghanon sa gitugot nga mga hangyo alang sa window window. |
| X-FactSet-Api-RateLimit-Nabilin | Gidaghanon sa mga hangyo nga nahabilin alang sa bintana sa oras. |
| X-FactSet-Api-RateLimit-Reset | Gidaghanon sa mga segundo nga nahabilin hangtod ma-reset ang limitasyon sa rate. |
Mibalik
| HTTP status code | Deskripsyon |
| 202 | Gipaabot nga tubag. |
| 400 | Dili balido nga POST nga lawas. |
| 401 | Nawala o dili balido nga panghimatuud. |
| 403 | Ang tiggamit gidid-an sa kasamtangan nga mga kredensyal. |
| 415 | Nawala/Dili balido nga Content-Type header. Ang header kinahanglan nga ibutang sa application/json. |
| 429 | Naabot ang limitasyon sa rate. Sulayi pag-usab ang mga hangyo human sa paghulat sa oras nga gitakda sa pagsulay-pagkahuman sa ulohan. |
| 500 | Sayop sa server. Pag-log sa X-DataDirect-Request-Key header aron makatabang sa pag-troubleshoot. |
| 503 | Nag-time out ang hangyo. Sulayi pag-usab ang hangyo sa pipila ka panahon. |
Mga komento
Labing taas nga 50 ka POST nga mga hangyo gitugotan sa usa ka 5-segundos nga bintana alang sa matag API. Ang parehas mahimong mapamatud-an gamit ang lainlaing mga ulohan sa Rate-Limit nga magamit sa tubag sa API.
- X-FactSet-Api-RateLimit-Limit - Gidaghanon sa gitugotan nga mga hangyo alang sa window sa oras.
- X-FactSet-Api-RateLimit-Remaining - Gidaghanon sa mga hangyo nga nahabilin alang sa window sa oras.
- X-FactSet-Api-RateLimit-Reset - Gidaghanon sa mga segundo nga nahabilin hangtod sa pag-reset sa limitasyon sa rate.
Examples
hangyo:
POST https://api.factset.com/analytics/dsotm/v1/transactions.
Mga ulohan:
- matang sa sulod: aplikasyon/json
- Awtorisasyon: Basic RkRTX0RFTU9fVVMt******************************
- Dawata-Pag-encode: gzip
- gitas-on sa sulod: 201
Lawas:
tubag:
HTTP 202 Gidawat
Mga ulohan:
- x-data nga direkta nga hangyo-key: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
Record Fields
Pagbuhat sa Pagpatay
| elemento | Type | Deskripsyon | Mandatory |
| portfolio | String | Ang ngalan sa portfolio. Ex: CLIENT:/DEMO.OFDB | OO |
| transaction-id | String | Talagsaon nga ID alang sa transaksyon | OO |
| simbolo | String | Simbolo nga katumbas sa gibaligya nga instrumento. Pananglitan: AAPL | OO |
| paghulagway | String | Kasagaran usa ka ngalan, Ex: FACTSET RESEARCH SYSTEMS, apan mahimong mas deskriptibo alang sa mga derivatives. | OO |
| matang sa pamatigayon | String | BL (Buy Long), BC (Buy to cover), SL (Sell Long) ug SS (Sell Short) | OO |
| kahimtang | String | ACCT o CNCL, mubo sa ACCOUNTED ug CANCELED | OO |
| petsa sa pamatigayon | String | Petsa sa pamatigayon nga anaa sa format nga YYYYMMDD | OO |
| transaksyon dahon | Lutaw | Mga bahin nga gi-order ug wala gipatuman | DILI |
| kantidad | Lutaw | Ang gidaghanon sa instrumento nga gibaligya | OO |
| pukot | Lutaw | Ang kantidad sa salapi sa transaksyon, net sa gasto sa brokerage. | OO |
| grabe | Lutaw | Ang kantidad sa salapi sa transaksyon, lakip ang mga gasto sa brokerage. | OO |
| bili sa settlement | Lutaw | Ang kantidad sa salapi sa transaksyon usa ka kantidad nga gipadaghan sa usa ka magamit nga rate sa FX aron mabag-o ang transaksyon nga gi-book sa lokal nga salapi ngadto sa nagreport nga salapi. | OO |
| petsa sa settlement | String | Petsa sa settlement sa format nga YYYYMMDD | OO |
| kwarta | String | Ang currency code sa cash valued fields, Net Amount ug Gross Amount. | OO |
| foreign exchange rate | Lutaw | Ang rate sa FX nga mahimong makuha sa PA, gipadaghan sa mga natad sa kantidad nga salapi, Net, Gross, aron tugutan ang PA nga magpakita sa mga transaksyon sa pagreport sa currency. | DILI |
| settlement currency iso | String | Kodigo sa currency alang sa Settlement Value | OO |
| nagmando | String | Ang talagsaong identifier sa Order gihatag sa PM Hub. Ex: O_FDS_010623_1686393260254 | DILI |
| parentId | String | Talagsaong identifier sa Parent Order nga ihatag sa OMS. | DILI |
Pagbuhat sa Order
| elemento | Type | Deskripsyon | Mandatory |
| portfolio | String | Ang ngalan sa portfolio. Ex: CLIENT:/DEMO.OFDB | OO |
| transaction-id | String | Talagsaon nga ID alang sa transaksyon | OO |
| simbolo | String | Simbolo nga katumbas sa gibaligya nga instrumento. Pananglitan: AAPL | OO |
| paghulagway | String | Kasagaran usa ka ngalan, Ex: FACTSET RESEARCH SYSTEMS, apan mahimong mas deskriptibo alang sa mga derivatives. | OO |
| matang sa pamatigayon | String | BL (Buy Long), BC (Buy to cover), SL (Sell Long) ug SS (Sell Short) | OO |
| kahimtang | String | ACCT o CNCL, mubo sa ACCOUNTED ug CANCELED | OO |
| petsa sa pamatigayon | String | Petsa sa pamatigayon nga anaa sa format nga YYYYMMDD | OO |
| transaksyon-mga dahon | Lutaw | Mga bahin nga gi-order apan wala gipatuman | DILI |
| kantidad | Lutaw | Ang gidaghanon sa instrumento nga gibaligya | OO |
| currency iso | String | Ang currency code sa cash valued fields, Net Amount ug Gross Amount. | OO |
| foreign exchange rate | Lutaw | Ang rate sa FX nga mahimong makuha sa PA, gipadaghan sa mga natad sa kantidad nga salapi, Net, Gross, aron tugutan ang PA nga magpakita sa mga transaksyon sa pagreport sa currency. | DILI |
| order Id | String | Ang talagsaong identifier sa Order gihatag sa PM Hub. Ex: O_FDS_010623_1686393260254 | DILI |
Pagbuhat sa Placement
| elemento | Type | Deskripsyon | Mandatory |
| portfolio | String | Ang ngalan sa portfolio. Ex: CLIENT:/DEMO.OFDB | OO |
| transaction-id | String | Talagsaon nga ID alang sa transaksyon | OO |
| simbolo | String | Simbolo nga katumbas sa gibaligya nga instrumento. Pananglitan: AAPL | OO |
| paghulagway | String | Kasagaran usa ka ngalan, Ex: FACTSET RESEARCH SYSTEMS, apan mahimong mas deskriptibo alang sa mga derivatives. | OO |
| matang sa pamatigayon | String | BL (Buy Long), BC (Buy to cover), SL (Sell Long) ug SS (Sell Short) | OO |
| kahimtang | String | ACCT o CNCL, mubo sa ACCOUNTED ug CANCELED | OO |
| petsa sa pamatigayon | String | Petsa sa pamatigayon nga anaa sa format nga YYYYMMDD | OO |
| transaksyon-mga dahon | Lutaw | Mga bahin nga gi-order apan wala gipatuman | DILI |
| kantidad | Lutaw | Ang gidaghanon sa instrumento nga gibaligya | OO |
| currency iso | String | Ang currency code sa cash valued fields, Net Amount ug Gross Amount. | OO |
| foreign exchange rate | Lutaw | Ang rate sa FX nga mahimong makuha sa PA, gipadaghan sa mga natad sa kantidad nga salapi, Net, Gross, aron tugutan ang PA nga magpakita sa mga transaksyon sa pagreport sa currency. | DILI |
| settlement currency iso | String | Kodigo sa currency alang sa Settlement Value | OO |
| order Id | String | Ang talagsaong identifier sa Order gihatag sa PM Hub. Ex: O_FDS_010623_1686393260254 | DILI |
| ginikanan Id | String | Talagsaong identifier sa Parent Order nga ihatag sa OMS. | DILI |
Pag-troubleshoot
Girekomenda ang mosunod nga mga lakang aron masulbad ang mga sayup gikan sa bisan unsang lainlaing mga API:
- Irekord ang X-DataDirect-Request-Key response header aron ang FactSet's API engineering team makaanalisar sa imong piho nga hangyo/tubag.
- Irekord ang tubag nga lawas kung ang tubag usa ka tubag sa sayup. Ang tanan nga HTTP status code nga katumbas ug labaw sa 400 giisip nga mga tubag sa sayup.
- Tawga ang imong account team gamit ang impormasyon sa ibabaw alang sa tabang.
Pag-upgrade sa Bersyon
- Ang FactSet mosuporta sa daan nga mga bersyon sa API sa limitadong panahon. Ang aktuwal nga oras sa suporta magdepende sa API ug sa pagpagawas sa stage (ie, beta o produksyon). Ang tanan nga mga pagbag-o sa paglapas, pagdugang sa pagpaandar, ug pag-ayo sa bug sa mga naunang bersyon idokumento sa changelog.
- Ang team sa engineering sa API sa FactSet makigtambayayong sa mga kliyente aron masiguro ang hapsay nga pagbalhin ngadto sa mas bag-ong mga bersyon.
Copyright © 2023 FactSet Research Systems Inc. Tanang katungod gigahin.
FactSet Research Systems Inc. | www.factset.com.
Mga Dokumento / Mga Kapanguhaan
 |
FACTSET Direktang Pag-stream Sa Mga Mensahe sa Transaksyon API Software [pdf] Giya sa Gumagamit Bersyon 1.0, Direkta nga Pag-stream Sa Mga Mensahe sa Transaksyon API Software, Pag-stream sa Mga Mensahe sa Transaksyon API Software, Mga Mensahe sa Transaksyon API Software, Messages API Software, API Software, Software |