FACTSET Софтвер за API за директно проследување на трансакциски пораки
Информации за производот
Спецификации
- Име на производ: АПИ за директно проследување на пораки за трансакции
- Верзија: 1.0
- Прирачник за програмери и референтен датум: август 2023 година
Мотивација
Мотивацијата зад АПИ-то за директно проследување на трансакциски пораки е да обезбеди начин за поврзување на записите од кој било давател на OMS и интегрирање на трговските податоци со платформата за управување со портфолио во реално време (PMP) на FactSet за надзор на портфолиото, симулација на трговија, атрибуција на перформанси и анализа на повратот .
API програма
Во текот наview
Програмата API првично се фокусира на моторот за анализа на портфолио и се прошири за да вклучи и други аналитички мотори, производи и API од различни деловни единици.
Програмата го обезбедува следново:
- АПИ за директно проследување на пораки за трансакции
Сите API се хостирани под https://api.factset.com. Автентикацијата се ракува со помош на клучеви API, а овластувањето се ракува со користење на домашниот производ за претплати на FactSet. За повеќе информации за користење на API клучеви, посетете https://developer.factset.com/authentication.
Имајте предвид дека имињата на заглавието на барањата и одговорите на HTTP треба да се сметаат за нечувствителни на букви според HTTP стандардот. Препорачливо е да не се потпирате на совпаѓање на заглавија чувствителни на големи букви во вашиот код.
Упатство за употреба на производот
DSoTM API
Поднесување записи
- За да поднесете евиденција за трансакции, користете ја следнава крајна точка:
- POST /analytics/dsotm/v1/transactions
Побарајте заглавија
- Овластување
Стандардно заглавие на HTTP. Вредноста треба да го користи форматот „Основен“. - Содржина-Тип
Стандардно заглавие на HTTP. Вредноста треба да биде наведена како апликација/JSON за да покаже дека телото е во JSON формат.
Решавање проблеми
За информации за решавање проблеми, погледнете го делот 4 од Прирачникот и референцата за програмери.
Надградба на верзијата
Информациите за надградбите на верзиите може да се најдат во делот 5 од Прирачникот и референцата за програмери.
Најчесто поставувани прашања
- П: Која е целта на API-то за директно проследување на пораки за трансакции?
О: Целта на API-то за директно проследување на трансакциски пораки е да ги поврзе трговските податоци од кој било давател на OMS со платформата за управување со портфолио на FactSet за надзор на портфолиото, симулација на трговија, припишување на перформанси и анализа на повратот. - П: Каде можам да најдам повеќе информации за користење на API клучеви?
О: Повеќе информации за користење на копчињата API може да најдете на https://developer.factset.com/authentication.
Мотивација
Во 1997 година, FactSet го лансираше Portfolio Analysis 1.0, кој ја постави основата за Analytics. Набргу потоа, Portfolio Analysis 2.0 интегрираше анализа на ризик од трети лица продавачи, а потоа се прошири за да вклучи фиксен приход во 2004 година. FactSet сега нуди робустен пакет на производи за анализа на портфолио со повеќе средства кои го водат пазарот во флексибилност, аналитика и ширина. Денес, клиентите се потпираат на FactSet за интерактивна аналитика преку различни производи, како што се Анализа на портфолио (PA), SPAR, Алфа тестирање, Оптимизатори и табла за портфолио, како и дистрибуција на аналитика преку Портфолио Batcher, Publisher Flat Files, и документи на издавачот.
API програма
Во текот наview
Клиентите се движат кон градење на приспособено решение, водени од потребата да се зголеми продуктивноста преку консолидирање на информациите во едно корисничко искуство. Со изложување на аналитика, перформанси и ризик преку API, ви обезбедува софистициран канал за интеракција со водечката аналитика за повеќе средства на FactSet. Бидејќи пазарот продолжува да бара поголема транспарентност и податоци, FactSet ќе обезбеди флексибилни опции за исполнување на тие барања. API-ите ги надополнуваат тековните понуди на пакети за аналитика и ги олеснуваат партнерствата со тоа што ви дозволуваат да изградите приватни искуства, да се интегрирате со алатки за БИ од трета страна како Tableau и статистичките пакети од трети страни како RStudio и да ја зголемите контролата врз внатрешната потрошувачка на аналитика од FactSet.
Првиот сtagЕ од изложувањето на Analytics API ќе се фокусира на моторот за аналитика на портфолио. Од своето основање, програмата се прошири за да вклучи и други аналитички мотори, производи и API од други деловни единици.
Програмата го обезбедува следново:
- Комплет алатки за програмери за да се изгради доказ за концептот
- Униформно чувство на сите API-и на FactSet на ниво на претпријатие
- Почитување на индустриските стандарди
- Верзија на API
- Обемна документација и упатства на порталот за програмери
АПИ за директно проследување на пораки за трансакции
- Поврзете ги записите од кој било давател на OMS за да ги интегрирате вашите трговски податоци со платформата за управување со портфолио во реално време (PMP) на FactSet за надзор на портфолиото и симулација на трговија, или да се користат во моќниот мотор за аналитика на портфолио за анализа на наведување на перформанси и враќање.
- Сите API се хостирани под https://api.factset.com. Автентикацијата се ракува со помош на клучеви API, а овластувањето се ракува со користење на домашниот производ за претплати на FactSet. Можете да најдете повеќе информации за користење на копчињата API на https://developer.factset.com/authentication.
Имињата на заглавијата на барањата и одговорите на HTTP треба да се сметаат за нечувствителни на букви според HTTP стандардот. Ве молиме, не се потпирајте на совпаѓање на заглавијата со големи букви во вашиот код.
Поднесување записи
Поднесете трансакции
POST /analytics/dsotm/v1/transactions
Оваа крајна точка ги прифаќа записите на трансакциите и истовремено ги запишува во OMS_OFDB на наведеното портфолио и ги прави достапни во апликацијата PMP.
Побарајте заглавија
| Име на заглавие | Опис |
| Овластување | Стандардно заглавие на HTTP. Вредноста треба да го користи 'Основното ' формат. |
| Содржина-Тип | Стандардно заглавие на HTTP. Вредноста треба да наведе апликација/JSON (т.е. повикувачот треба да наведе дека телото е во JSON формат). |
Тело на барање
Телото за барање прифаќа збирка на параметри за пресметка. Параметрите се наведени подолу:
| Име на параметарот | Тип на податоци | Задолжително | Опис | Формат |
| егзекуции | Низа | бр | Список на записи за извршување | Детални полиња за евиденција се достапни овде |
| пласмани | Низа | бр | Список на записи за сместување | Детални полиња за евиденција се достапни овде |
| нарачки | Низа | бр | Список на записи за нарачки | Детални полиња за евиденција се достапни овде |
Заглавија на одговор
| Име на заглавие | Опис |
| X-DataDirect-Request-Клуч | Заглавие на клучот за барање на FactSet. |
| X-FactSet-Api-Request-Key | Клуч за единствено идентификување на барање за API на Analytics. Достапно само по успешна автентикација. |
| X-FactSet-Api-RateLimit-Limit | Број на дозволени барања за временскиот прозорец. |
| X-FactSet-Api-RateLimit-Remaining | Број на барања оставени за временскиот прозорец. |
| X-FactSet-Api-RateLimit-Reset | Преостанати секунди до ресетирање на ограничувањето на стапката. |
Се враќа
| HTTP статусен код | Опис |
| 202 | Очекуван одговор. |
| 400 | Неважечко тело на POST. |
| 401 | Недостасува или неважечка автентикација. |
| 403 | Корисникот е забранет со тековни акредитиви. |
| 415 | Недостасува/Невалиден тип на содржина. Заглавјето треба да се постави на апликација/json. |
| 429 | Ограничувањето на стапката беше достигнато. Обидете се повторно со барањата откако ќе го чекате времето наведено во заглавието повторно обид-после. |
| 500 | Грешка во серверот. Пријавете го заглавието X-DataDirect-Request-Key за да помогнете во решавањето проблеми. |
| 503 | Времето на барањето истече. Обидете се повторно со барањето за некое време. |
Забелешки
Дозволени се најмногу 50 POST барања во прозорец од 5 секунди за секое API. Истото може да се потврди со користење на различните заглавија Rate-Limit достапни во одговорот на 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-податоци директно барање-клуч: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
Полиња за снимање
Извршување Создавање
| Елемент | Тип | Опис | Задолжително |
| портфолио | Низа | Името на портфолиото. Пр: КЛИЕНТ:/DEMO.OFDB | ДА |
| трансакција-ид | Низа | Единствен ID за трансакцијата | ДА |
| симбол | Низа | Симбол кој одговара на инструментот со кој се тргува. На пример: AAPL | ДА |
| опис | Низа | Обично име, пр: FACTSET RESEARCH SYSTEMS, но може да биде поописно за деривати. | ДА |
| трговски тип | Низа | BL (Buy Long), BC (Buy to cover), SL (Sell Long) и SS (Sell Short) | ДА |
| статус | Низа | ACCT или CNCL, кратенка од ACCOUNTED и CANCELED | ДА |
| датум на тргување | Низа | Датум на тргување кој е во формат YYYYMMDD | ДА |
| трансакциски листови | Плови | Акции кои се нарачани и неизвршени | БР |
| износ | Плови | Количина на инструментот со кој се тргува | ДА |
| нето | Плови | Паричната вредност на трансакцијата, нето од брокерските трошоци. | ДА |
| бруто | Плови | Паричната вредност на трансакцијата, вклучувајќи ги и брокерските трошоци. | ДА |
| порамнувачка вредност | Плови | Паричната вредност на трансакцијата е вредност што е помножена со применлива девизна стапка за конвертирање на трансакцијата резервирана во локална валута во валута за известување. | ДА |
| датум на порамнување | Низа | Датум на порамнување во формат YYYYMMDD | ДА |
| валута | Низа | Кодот на валутата на полињата со готовинска вредност, нето износ и бруто износ. | ДА |
| девизниот курс | Плови | Девизна стапка која може да се подигне од страна на PA, помножена со полињата со готовинска вредност, Нето, бруто, за да се овозможи PA да ги прикажува трансакциите во валутата за известување. | БР |
| валута за порамнување iso | Низа | Шифра на валута за порамнувачка вредност | ДА |
| нареди | Низа | Единствениот идентификатор на нарачката е обезбеден од PM Hub. На пример: O_FDS_010623_1686393260254 | БР |
| родителски ID | Низа | Единствен идентификатор на родителскиот налог што треба да го обезбеди OMS. | БР |
Создавање нарачка
| Елемент | Тип | Опис | Задолжително |
| портфолио | Низа | Името на портфолиото. Пр: КЛИЕНТ:/DEMO.OFDB | ДА |
| трансакција-ид | Низа | Единствен ID за трансакцијата | ДА |
| симбол | Низа | Симбол кој одговара на инструментот со кој се тргува. На пример: AAPL | ДА |
| опис | Низа | Обично име, пр: FACTSET RESEARCH SYSTEMS, но може да биде поописно за деривати. | ДА |
| трговски тип | Низа | BL (Buy Long), BC (Buy to cover), SL (Sell Long) и SS (Sell Short) | ДА |
| статус | Низа | ACCT или CNCL, кратенка од ACCOUNTED и CANCELED | ДА |
| датум на тргување | Низа | Датум на тргување кој е во формат YYYYMMDD | ДА |
| трансакција-оставки | Плови | Акции кои се нарачани, но не извршени | БР |
| износ | Плови | Количина на инструментот со кој се тргува | ДА |
| валута iso | Низа | Кодот на валутата на полињата со готовинска вредност, нето износ и бруто износ. | ДА |
| девизниот курс | Плови | Девизна стапка која може да се подигне од страна на PA, помножена со полињата со готовинска вредност, Нето, бруто, за да се овозможи PA да ги прикажува трансакциите во валутата за известување. | БР |
| нарачка ID | Низа | Единствениот идентификатор на нарачката е обезбеден од PM Hub. На пример: O_FDS_010623_1686393260254 | БР |
Создавање поставеност
| Елемент | Тип | Опис | Задолжително |
| портфолио | Низа | Името на портфолиото. Пр: КЛИЕНТ:/DEMO.OFDB | ДА |
| трансакција-ид | Низа | Единствен ID за трансакцијата | ДА |
| симбол | Низа | Симбол кој одговара на инструментот со кој се тргува. На пример: AAPL | ДА |
| опис | Низа | Обично име, пр: FACTSET RESEARCH SYSTEMS, но може да биде поописно за деривати. | ДА |
| трговски тип | Низа | BL (Buy Long), BC (Buy to cover), SL (Sell Long) и SS (Sell Short) | ДА |
| статус | Низа | ACCT или CNCL, кратенка од ACCOUNTED и CANCELED | ДА |
| датум на тргување | Низа | Датум на тргување кој е во формат YYYYMMDD | ДА |
| трансакција-оставки | Плови | Акции кои се нарачани, но не извршени | БР |
| износ | Плови | Количина на инструментот со кој се тргува | ДА |
| валута iso | Низа | Кодот на валутата на полињата со готовинска вредност, нето износ и бруто износ. | ДА |
| девизниот курс | Плови | Девизна стапка која може да се подигне од страна на PA, помножена со полињата со готовинска вредност, Нето, бруто, за да се овозможи PA да ги прикажува трансакциите во валутата за известување. | БР |
| валута за порамнување iso | Низа | Шифра на валута за порамнувачка вредност | ДА |
| нарачка ID | Низа | Единствениот идентификатор на нарачката е обезбеден од PM Hub. На пример: O_FDS_010623_1686393260254 | БР |
| родител ID | Низа | Единствен идентификатор на родителскиот налог што треба да го обезбеди OMS. | БР |
Решавање проблеми
Следниве чекори се препорачуваат за смена на грешки од кое било од различните API:
- Снимете го заглавието на одговорот X-DataDirect-Request-Key за да може инженерскиот тим на API на FactSet да го анализира вашето конкретно барање/одговор.
- Запишете го телото за одговор кога одговорот е одговор на грешка. Сите HTTP статусни кодови еднакви и поголеми од 400 се сметаат за одговори на грешка.
- Обратете се до тимот на вашата сметка со горенаведените информации за помош.
Надградба на верзијата
- FactSet ќе поддржува стари верзии на API за ограничено време. Вистинското време за поддршка ќе зависи од API и изданиетоtage (т.е. бета или производство). Сите промени, дополнувања на функционалности и поправени грешки во претходните верзии ќе бидат документирани во дневникот за промени.
- Инженерскиот тим на API на FactSet ќе работи со клиентите за да обезбеди непречена транзиција кон понови верзии.
Авторски права © 2023 FactSet Research Systems Inc. Сите права се задржани.
FactSet Research Systems Inc. | www.factset.com.
Документи / ресурси
 |
FACTSET Софтвер за API за директно проследување на трансакциски пораки [pdf] Упатство за корисникот Верзија 1.0, Софтвер за API за пораки за трансакции, софтвер за API за пораки за трансакции, софтвер за API за пораки за трансакции, софтвер за API за пораки, софтвер за API, софтвер |