FACTSET Uporabniški priročnik za programsko opremo API za neposredno pretakanje transakcijskih sporočil

Motivacija
Motivacija API-ja za neposredno pretakanje transakcijskih sporočil je zagotoviti način za povezovanje zapisov katerega koli ponudnika OMS in integracijo trgovinskih podatkov s FactSetovo platformo za upravljanje portfelja v realnem času (PMP) za nadzor nad portfeljem, simulacijo trgovanja, dodeljevanje uspešnosti in analizo donosov. .

Program API

konecview
Program API se je sprva osredotočal na analitični mehanizem portfelja in se je razširil na druge analitične motorje, izdelke in API-je iz različnih poslovnih enot.

Program zagotavlja naslednje:

API za neposredno pretakanje transakcijskih sporočil

Vsi API-ji gostujejo pod https://api.factset.com. Avtentikacija se izvaja s ključi API, avtorizacija pa z lastnim naročniškim izdelkom FactSet. Za več informacij o uporabi ključev API obiščite https://developer.factset.com/authentication.

Upoštevajte, da je treba v skladu s standardom HTTP imena glav zahtev in odgovorov HTTP upoštevati, da ne razlikujejo med velikimi in malimi črkami. Priporočljivo je, da se ne zanašate na ujemanje glav v kodi, ki razlikuje med velikimi in malimi črkami.

Navodila za uporabo izdelka

DSoTM API

Pošiljanje zapisov

Za predložitev zapisov transakcij uporabite naslednjo končno točko:
POST /analytics/dsotm/v1/transactions

Zahtevaj glave

Pooblastilo
Standardna glava HTTP. Vrednost mora uporabljati »osnovno« obliko.

Vrsta vsebine
Standardna glava HTTP. Vrednost mora biti podana kot aplikacija/JSON, da nakaže, da je telo v formatu JSON.

Odpravljanje težav
Za informacije o odpravljanju težav glejte razdelek 4 Priročnika za razvijalce in sklicevanja.

Nadgradnja različice
Informacije o nadgradnjah različic najdete v razdelku 5 Priročnika za razvijalce in sklicevanja.

pogosta vprašanja

V: Kaj je namen API-ja za neposredno pretakanje transakcijskih sporočil?
O: Namen API-ja za neposredno pretakanje transakcijskih sporočil je povezati podatke o trgovanju katerega koli ponudnika OMS s platformo za upravljanje portfelja FactSet za nadzor portfelja, simulacijo trgovanja, dodeljevanje uspešnosti in analizo donosov.

V: Kje lahko najdem več informacij o uporabi ključev API?
O: Več informacij o uporabi ključev API najdete na https://developer.factset.com/authentication.

Motivacija

Leta 1997 je FactSet lansiral Portfolio Analysis 1.0, ki je postavil temelje za Analytics. Kmalu zatem je Portfolio Analysis 2.0 integriral analitiko tveganja tretjih ponudnikov, nato pa se je leta 2004 razširil na fiksni dohodek. FactSet zdaj ponuja robusten nabor izdelkov za analizo portfelja z več sredstvi, ki so vodilni na trgu glede prilagodljivosti, analitike in širine. Danes se stranke zanašajo na FactSet za interaktivno analitiko prek različnih izdelkov, kot so Portfolio Analysis (PA), SPAR, Alpha Testing, Optimizers in Portfolio Dashboard, kot tudi distribucijo analitike prek Portfolio Batcher, Publisher Flat Files in dokumenti založnika.

Program API

konecview

Stranke se usmerjajo k izdelavi rešitve po meri, ki jo vodi potreba po povečanju produktivnosti s konsolidacijo informacij v eno uporabniško izkušnjo. Z razkrivanjem analitike, zmogljivosti in tveganja prek API-jev vam zagotavlja prefinjen kanal za interakcijo z vodilno analitiko več sredstev FactSet. Ker trg še naprej zahteva več preglednosti in podatkov, bo FactSet zagotovil prilagodljive možnosti za izpolnitev teh zahtev. API-ji dopolnjujejo trenutno ponudbo analitičnih zbirk in olajšajo partnerstva, saj vam omogočajo ustvarjanje zasebnih izkušenj, integracijo z orodji BI tretjih oseb, kot je Tableau, in statističnimi paketi tretjih oseb, kot je RStudio, ter povečajo nadzor nad interno porabo analitike iz FactSet.

Prvi stagRazkrivanje API-jev Analytics se bo osredotočilo na mehanizem za analizo portfelja. Od svoje ustanovitve se je program razširil na druge analitične mehanizme, izdelke in API-je iz drugih poslovnih enot.

Program zagotavlja naslednje:

Zbirka orodij za razvijalce za izdelavo dokaza koncepta
Enoten občutek v vseh API-jih podjetja FactSet na ravni podjetja
Upoštevanje industrijskih standardov
Versionirani API-ji
Obsežna dokumentacija in vadnice na portalu za razvijalce

API za neposredno pretakanje transakcijskih sporočil

Povežite zapise katerega koli ponudnika OMS, da integrirate svoje trgovinske podatke s FactSet-ovo platformo za upravljanje portfelja (PMP) v realnem času za nadzor nad portfeljem in simulacijo trgovanja ali za uporabo v zmogljivem mehanizmu za analizo portfelja za analizo dodeljevanja uspešnosti in donosov.
Vsi API-ji gostujejo pod https://api.factset.com. Preverjanje pristnosti se izvaja s ključi API, avtorizacija pa z lastnim naročniškim izdelkom FactSet. Več informacij o uporabi ključev API najdete na https://developer.factset.com/authentication.

V skladu s standardom HTTP imena glave zahtev in odgovorov HTTP ne razlikujejo med velikimi in malimi črkami. Ne zanašajte se na ujemanje glav v vaši kodi, ki razlikuje med velikimi in malimi črkami.

Pošiljanje zapisov

Predloži transakcije
POST /analytics/dsotm/v1/transactions

Ta končna točka sprejme zapise transakcij in jih hkrati zapiše v OMS_OFDB podanega portfelja ter jih da na voljo v aplikaciji PMP.

Zahtevaj glave

Ime glave	Opis
Pooblastilo	Standardna glava HTTP. Vrednost mora uporabiti »Osnovno ' format.
Vsebina-Vrsta	Standardna glava HTTP. Vrednost mora podati aplikacijo/JSON (tj. klicatelj mora podati, da je telo v formatu JSON).

Telo zahteve
Telo zahteve sprejme zbirko parametrov za izračun. Parametri so opisani spodaj:

Ime parametra	Vrsta podatkov	Obvezno	Opis	Oblika
usmrtitve	Array	št	Seznam izvršilnih evidenc	Podrobna polja zapisa so na voljo tukaj
umestitve	Array	št	Seznam evidenc umestitev	Podrobna polja zapisa so na voljo tukaj
naročila	Array	št	Seznam evidenc naročil	Podrobna polja zapisa so na voljo tukaj

Glave odzivov

Ime glave	Opis
X-DataDirect-Request-Ključ	Glava ključa zahteve FactSet.
X-FactSet-Api-Request-Key	Ključ za edinstveno identifikacijo zahteve API Analytics. Na voljo samo po uspešnem preverjanju pristnosti.
X-FactSet-Api-RateLimit-Limit	Število dovoljenih zahtev za časovno okno.
X-FactSet-Api-RateLimit-Remaining	Število preostalih zahtev za časovno okno.
X-FactSet-Api-RateLimit-Reset	Število preostalih sekund do ponastavitve omejitve hitrosti.

Vračila

Koda stanja HTTP	Opis
202	Pričakovan odziv.
400	Neveljavno telo POST-a.
401	Manjkajoče ali neveljavno preverjanje pristnosti.
403	Uporabnik je prepovedan s trenutnimi poverilnicami.
415	Manjka/neveljavna glava Content-Type. Glava mora biti nastavljena na application/json.
429	Omejitev stopnje je bila dosežena. Znova poskusite zahteve po čakanju na čas, naveden v glavi ponovnega poskusa.
500	Napaka strežnika. Zabeležite glavo X-DataDirect-Request-Key za pomoč pri odpravljanju težav.
503	Časovna omejitev zahteve je potekla. Čez nekaj časa znova poskusite z zahtevo.

Opombe
Dovoljenih je največ 50 zahtev POST v 5-sekundnem oknu za vsak API. Enako je mogoče preveriti z različnimi glavami Rate-Limit, ki so na voljo v odgovoru API-ja.

X-FactSet-Api-RateLimit-Limit – število dovoljenih zahtev za časovno okno.
X-FactSet-Api-RateLimit-Remaining – število preostalih zahtev za časovno okno.

X-FactSet-Api-RateLimit-Reset – Število preostalih sekund do ponastavitve omejitve hitrosti.

Examples

Zahteva:
OBJAVI https://api.factset.com/analytics/dsotm/v1/transactions.

Naslovi:

content-type: aplikacija/json
Pooblastilo: Osnovno RkRTX0RFTU9fVVMt********************************
Accept-Encoding: gzip
vsebina-dolžina: 201

Telo:

odgovor:
HTTP 202 Sprejeto

Naslovi:

x-data ključ neposredne zahteve: zpdo6aebv58fiaoi
x-factset-api-request-key: 6p2d41m4sw1yfh0h

Zapisna polja

Izvedba Ustvarjanje

Element	Vrsta	Opis	Obvezno
portfelj	Niz	Ime portfelja. Primer: CLIENT:/DEMO.OFDB	DA
Številka transakcije	Niz	Enolični ID za transakcijo	DA
simbol	Niz	Simbol, ki ustreza instrumentu, s katerim se trguje. Primer: AAPL	DA
opis	Niz	Običajno ime, npr.: FACTSET RESEARCH SYSTEMS, vendar bi lahko bilo bolj opisno za izpeljanke.	DA
vrsta trgovine	Niz	BL (Buy Long), BC (Buy to cover), SL (Sell Long) in SS (Sell Short)	DA
stanje	Niz	ACCT ali CNCL, okrajšava za ACCOUNTED in CANCELED	DA
datum trgovanja	Niz	Datum trgovanja v obliki LLLLMMDD	DA
transakcijski listi	Lebdi	Delnice, ki so bile odrejene in neizvršene	št
znesek	Lebdi	Količina instrumenta, s katerim se trguje	DA
net	Lebdi	Denarna vrednost transakcije brez stroškov posredovanja.	DA
bruto	Lebdi	Denarna vrednost transakcije, vključno s stroški posredovanja.	DA
poravnalna vrednost	Lebdi	Denarna vrednost transakcije je vrednost, ki je bila pomnožena z veljavnim deviznim tečajem za pretvorbo transakcije, knjižene v lokalni valuti, v valuto poročanja.	DA
datum poravnave	Niz	Datum poravnave v obliki LLLLMMDD	DA
valuta	Niz	Koda valute polj z gotovinsko vrednostjo, Neto znesek in Bruto znesek.	DA
devizni tečaj	Lebdi	Devizni tečaj, ki ga lahko prevzame PA, pomnožen s polji z denarno vrednostjo, Neto, Bruto, da PA omogoči prikaz transakcij v valuti poročanja.	št
poravnalna valuta iso	Niz	Koda valute za vrednost poravnave	DA
naročeno	Niz	Enolični identifikator naročila zagotavlja PM Hub. Primer: O_FDS_010623_1686393260254	št
parentId	Niz	Enolični identifikator nadrejenega naročila, ki ga zagotovi OMS.	št

Izdelava naročila

Element	Vrsta	Opis	Obvezno
portfelj	Niz	Ime portfelja. Primer: CLIENT:/DEMO.OFDB	DA

Številka transakcije	Niz	Enolični ID za transakcijo	DA
simbol	Niz	Simbol, ki ustreza instrumentu, s katerim se trguje. Primer: AAPL	DA
opis	Niz	Običajno ime, npr.: FACTSET RESEARCH SYSTEMS, vendar bi lahko bilo bolj opisno za izpeljanke.	DA
vrsta trgovine	Niz	BL (Buy Long), BC (Buy to cover), SL (Sell Long) in SS (Sell Short)	DA
stanje	Niz	ACCT ali CNCL, okrajšava za ACCOUNTED in CANCELED	DA
datum trgovanja	Niz	Datum trgovanja v obliki LLLLMMDD	DA
transakcijski listi	Lebdi	Delnice, ki so bile odrejene, a niso bile izvršene	št
znesek	Lebdi	Količina instrumenta, s katerim se trguje	DA
valuta iso	Niz	Koda valute polj z gotovinsko vrednostjo, Neto znesek in Bruto znesek.	DA
devizni tečaj	Lebdi	Devizni tečaj, ki ga lahko prevzame PA, pomnožen s polji z denarno vrednostjo, Neto, Bruto, da PA omogoči prikaz transakcij v valuti poročanja.	št
Številka naročila	Niz	Enolični identifikator naročila zagotavlja PM Hub. Primer: O_FDS_010623_1686393260254	št

Ustvarjanje umestitve

Element	Vrsta	Opis	Obvezno
portfelj	Niz	Ime portfelja. Primer: CLIENT:/DEMO.OFDB	DA
Številka transakcije	Niz	Enolični ID za transakcijo	DA
simbol	Niz	Simbol, ki ustreza instrumentu, s katerim se trguje. Primer: AAPL	DA
opis	Niz	Običajno ime, npr.: FACTSET RESEARCH SYSTEMS, vendar bi lahko bilo bolj opisno za izpeljanke.	DA
vrsta trgovine	Niz	BL (Buy Long), BC (Buy to cover), SL (Sell Long) in SS (Sell Short)	DA
stanje	Niz	ACCT ali CNCL, okrajšava za ACCOUNTED in CANCELED	DA
datum trgovanja	Niz	Datum trgovanja v obliki LLLLMMDD	DA
transakcijski listi	Lebdi	Delnice, ki so bile odrejene, a niso bile izvršene	št
znesek	Lebdi	Količina instrumenta, s katerim se trguje	DA
valuta iso	Niz	Koda valute polj z gotovinsko vrednostjo, Neto znesek in Bruto znesek.	DA

devizni tečaj	Lebdi	Devizni tečaj, ki ga lahko prevzame PA, pomnožen s polji z denarno vrednostjo, Neto, Bruto, da PA omogoči prikaz transakcij v valuti poročanja.	št
poravnalna valuta iso	Niz	Koda valute za vrednost poravnave	DA
Številka naročila	Niz	Enolični identifikator naročila zagotavlja PM Hub. Primer: O_FDS_010623_1686393260254	št
ID starša	Niz	Enolični identifikator nadrejenega naročila, ki ga zagotovi OMS.	št

Odpravljanje težav

Za odpravljanje napak katerega koli od različnih API-jev priporočamo naslednje korake:

Zabeležite glavo odgovora X-DataDirect-Request-Key, tako da lahko inženirska skupina API-ja FactSet analizira vašo specifično zahtevo/odgovor.
Zabeležite telo odgovora, če je odgovor odgovor na napako. Vse statusne kode HTTP, ki so enake in večje od 400, se štejejo za odzive na napake.

Za pomoč se obrnite na svojo skupino za račun z zgornjimi informacijami.

Nadgradnja različice

FactSet bo omejen čas podpiral stare različice API-ja. Dejanski čas podpore bo odvisen od API-ja in izdajetage (tj. beta ali proizvodnja). Vse kritične spremembe, dodatki funkcionalnosti in popravki napak v prejšnjih različicah bodo dokumentirani v dnevniku sprememb.

Inženirska ekipa API-ja FactSet bo sodelovala s strankami, da bi zagotovila gladek prehod na novejše različice.

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

Dokumenti / Viri

Programska oprema API za neposredno pretakanje transakcijskih sporočil [pdf] Uporabniški priročnik
Različica 1.0, programska oprema API za neposredno pretakanje transakcijskih sporočil, programska oprema API za pretakanje transakcijskih sporočil, programska oprema API za transakcijska sporočila, programska oprema API za sporočila, programska oprema API, programska oprema

Reference

Uporabniški priročnik

Programska oprema API za neposredno pretakanje transakcijskih sporočil

Informacije o izdelku