Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

GET method of OLAP RESTful web service is used to read/request the data from the Eagle data warehouse.  Below are the list of GET Endpoints supported by OLAP REST API.


Details on Individual GET Endpoints

Following are details on individual GET endpoints.

 reportProfiles: A GET request to return a list of report profiles.

This gives the profile names of all types of Performance Calculations, OLAP Reports and Advance reports.

Performance Dictionaries

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/
reportProfiles

Examples:

Web Browser
performanceDictionaries
Regular Dictionaries

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/regularDictionaries

Global Attribution Fields

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

reportProfilescurl -u user:password “

globalAttributionFields

Curl

Grouping Rule Filters

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

reportProfiles

Sample response:

[
    {
        "instance": 257,
        "profileName": "13F Report",
        "reportType": "Advanced Reporting ",
        "updateUser": "BASELINE ADMIN",
        "updateDate": 1398830400000
    }
]

...

Details on Individual GET Endpoints

Following are details on individual GET endpoints.

 reportProfiles: A GET request to return a list of fieldsreport profiles.

This includes gives the profile names of all types of Regular fields, Advance fields, Special fields, and Performance fieldsPerformance Calculations, OLAP Reports and Advanced reports.

Resource path: /eagle/report/v1/

fields

reportProfiles

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

fields

reportProfiles

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

fields

reportProfiles

Sample response:

[
    {
        "
id
instance":
 139
 257,
        "
description
profileName": "
i Settlement Date
13F Report",
        "
indicator
reportType": "
T
Advanced Reporting ",
        "
type
updateUser": "
Date",
        "updateSource": "REGFA
BASELINE ADMIN",
        "updateDate":
 1268884800000
 1398830400000
    }
]

fieldsByIndicatorfields: A GET request to return the a list of report fields by field indicator.Fields of all types are assigned with an indicator respective to the database it belongs to and those are fetched with a filter mentioned in this endpoint

This includes all types of Regular fields, Advance fields, Special fields, and Performance fields.

Resource path: /eagle/report/v1/

fieldsByIndicator/{fieldIndicator}

fields

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

fieldsByIndicator/H

fields

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

fieldsByIndicator/H

fields

Sample response:

[
    {
        "id":
 143
 139,
        "description": "
i Book Value (lot)
i Settlement Date",
        "indicator": "
H
T",
        "type": "
Numeric
Date",
        "updateSource": "REGFA",
        "updateDate": 1268884800000
    }
]

entitiesfieldsByIndicator: A GET request to return a the list of report entitiesfields by field indicator.

This includes all types of entities like Portfolios, Performance composites, Reporting Composites, and Entity List etcFields of all types are assigned with an indicator respective to the database it belongs to and those are fetched with a filter mentioned in this endpoint.

Resource path: /eagle/report/v1/fieldsByIndicator/

entities

{fieldIndicator}

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entities

fieldsByIndicator/H

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/fieldsByIndicator/

entities

H

Sample response:

[
  
    {
        "id":
"23980"
 143,
"name
        "description": "
JKAUMC9
i Book Value (lot)",
"type
        "indicator": "
COMP
H"
    }
,
   {
"id
        "type": "
10120
Numeric",
"name
        "updateSource": "
ALLGIPS
REGFA",
"type":"LIST"    
        "updateDate": 1268884800000
    }
]

entityByIdentities: A GET request to return an entity based on its ID.        This is to filter a specific entity using an 8-digit Entity IDa list of report entities.

This includes all types of entities like Portfolios, Performance composites, Reporting Composites, and Entity List etc.

Resource path: /eagle/report/v1/

entity/{entity id}

entities

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entity/LTTEST02

entities

Curl

curl -u user:password https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entity/LTTEST02

entities

Sample response:

[
   {
     
      
 
"id":
 
"
LTTEST02
23980",
    
     
 
 "name":
 
"
LTTEST02
JKAUMC9",
     
      
 
"type":
 
"
PORT
COMP"

  
     },
]
For another Entity
[
  {   
   {
"id":
 
"
JKAUMC1
10120",
     
      "name":
 
"
JKAUMC1 Entity Name
ALLGIPS ",
     
      "type":
 
"
ACOM
LIST"

 
     }
]

entitiesByEntityNameLikeentityById: A GET request to return a list of entities that contain the specified value in the Entity name. This applies filters on the Entity name to query the list of Entities matching with the entity name filter.

...

an entity based on its ID.        

This is to filter a specific entity using an 8-digit Entity ID.

Resource path: /eagle/report/v1/

entitiesByEntityNameLike

entity/{entity

name

id}

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entitiesByEntityNameLike

entity/

JKA

LTTEST02

Curl

curl -u user:password https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entitiesByEntityNameLike

entity/

JKA

LTTEST02

Sample response:

[
 
   {
       
       "id":
 "
JKOPTST2
LTTEST02",
       
       "name":
 "
COPYJKACOM23
LTTEST02",
       
       "type":
 "
ACOM
PORT"
   
   }
,

]
For another Entity
[
  {   
        "
      "id":
 "
JKACOM36
JKAUMC1",
       
      "name":
"Copy of JKACOM3
 "JKAUMC1 Entity Name",
       
      "type":
 "ACOM"
   
  }
]

entitiesByTypeentitiesByEntityNameLike: A GET request to return a list of entities by entity type.This includes all types of entities like Portfolios, Performance composites, Reporting composites, Entity list, and Custom index. This endpoint is used to filter the entities by entity typethat contain the specified value in the Entity name. This applies filters on the Entity name to query the list of Entities matching with the entity name filter.

Resource path: /eagle/report/v1/

entitiesByType

entitiesByEntityNameLike/{entity

type

name}

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entitiesByType

entitiesByEntityNameLike/

COMP

JKA

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/

entitiesByType

entitiesByEntityNameLike/

COMP

JKA

Sample response:

[
  {
        "id": "
JKTXC34
JKOPTST2",
        "name": "
JK DQM VOL
COPYJKACOM23 
CMP34
",
        "type": "
COMP
ACOM"
    },

   
 {
        "id": "
JKTXC35
JKACOM36",
        "name": "
JK
Copy 
DQM
of 
VOL
JKACOM3 
CMP35
",
        "type": "
COMP
ACOM"
    }
]

POST Method of REST Endpoint

adhocReport is a feature supported to extract OLAP report output using both POST and GET method. This runs a PACE report service based on the request payload input parameters in JSON format.

Request Formats:

POST

...

entitiesByType: A GET request to return a list of entities by entity type.

This includes all types of entities like Portfolios, Performance composites, Reporting composites, Entity list, and Custom index. This endpoint is used to filter the entities by entity type.

Resource path: /eagle/report/v1/entitiesByType/{entity type}

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/entitiesByType/

adhocReport

COMP

Payload:


"reportName": "string", 
"entityId

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/entitiesByType/COMP

Sample response:

[
 {
        "id": "
string
JKTXC34",
 

        "
beginDate
name": "
YYYYMMDD
JK DQM VOL CMP34",
        "
endDate
type": "
YYYYMMDD
COMP"
    },
 

"fields
    {
        "id": "
string
JKTXC35",
        "
outputFormat
name": "
JSON/
JK 
JSON2/
DQM 
CSV/ TSV/ XLS/ ERX"
"benchmarkToPortfolio": true/false,
"constituentsAndBenchmarkToComposite": true/false,
"firstAlternateCurrency
VOL CMP35",
        "type": "
string
COMP"
,

"secondAlternateCurrrency": "string",
"fetchPriorFXRates": "number",
"benchmarkOverride": {
"Comparison Index 4":"string",
"Comparison Index 5": "string",
"IsEntities": true/false
},
}

GET

URL:
    }
]

entityTypes: A GET request to return a list of default Eagle entity types and custom entity types. This includes all types of default entities like Portfolios, Performance composites, reporting Composites, Entity List, Custom index etc., and user defined custom entity types.

Resource path: /eagle/report/v1/entityTypes

Examples:

Web Browser

https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/
adhocReport? 
entityTypes

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/entityTypes

Sample response:    

[
     {  
        "entityType": "COMP",
        "type": "Base",
        "basetype": null,
        "updateDate": "2020-03-03 09:33:32",
        "updateUser": "ALOMBARDO"
    }]

performanceDictionaries: A GET request to return a list of performance dictionaries, which  are otherwise called as stored performance models.

Resource path:   /eagle/report/v1/performanceDictionaries

Examples:

Web Browser

https://O171-q001-ww01.eagleinvsys.com/eagle/report/v1/performanceDictionaries

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/performanceDictionaries

Sample response:    

[
{
        "dictionaryId": "95271",
        "dictionaryName": "113169PA-Position_Detail_Anl Check",
        "dictionaryLevel": "1",
        "dictionaryLevelDesc": "Entity",
        "fieldAttributeId": "-1"
    }]  

regularDictionaries: A GET request to return a list of regular dictionaries.

Resource path:  /eagle/report/v1/regularDictionaries

Examples: 

Web Browser

https://O171-q001-ww01.eagleinvsys.com/eagle/report/v1/regularDictionaries

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/regularDictionaries

Sample response:    

[
 {
        "dictionaryId": "188",
        "dictionaryName": "AK DICTIONARY",
        "dictionaryLevel": "1",
        "dictionaryLevelDesc": "VK_Currency",
        "fieldAttributeId": "9334"
     }
]

groupingRuleRange: A GET request to return a list of grouping rule Range fields which are used to construct dynamic grouping.

Resource path: /eagle/report/v1/groupingRuleRange

Examples: 

Web Browser

https://O171-q001-ww01.eagleinvsys.com/eagle/report/v1/groupingRuleRange

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1groupingRuleRange

Sample response:    

[
{
        "aggregationID": 8178,
        "aggregationDescription": "AG Range GR Field",
        "fieldAttributeDescription": "eglDca-Cost",
        "fieldAttributeId": "6841"
    }]

groupingRuleFilter: A GET request to return a list of grouping rule filter fields, which are used to construct dynamic grouping.

Resource path: /eagle/report/v1/groupingRuleFilter

Examples: 

Web Browser

https://O171-q001-ww01.eagleinvsys.com/eagle/report/v1/groupingRuleFilter

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/groupingRuleFilter

Sample response:    

[
 {
        "guidelineID": 2,
        "guidelineName": "*M Transaction Type FIL",
        "guidelineDescription": "*M Transaction Type FIL",
        "updateSource": "DCLINTON",
        "updateDate": "2008-07-01 12:00:35",
        "comments": null
    },
  ]

globalAttributionFields: A GET request to return a list of global attribution fields of types Brinson Fachler, Karnosky Singer and Eagle Fixed Income style.

Resource path: /eagle/report/v1/globalAttributionFields

Examples: 

Web Browser

https://O171-q001-ww01.eagleinvsys.com/eagle/report/v1/globalAttributionFields

Curl

curl -u user:password “https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/globalAttributionFields

Sample response:    

[
    {
        "id": 14533,
        "description": "104102 - Bf",
        "analysisStyle": "Brinson - Fachler",
        "updateSource": "PERFSMOKE",
        "updateDate": "2013-05-10 06:19:01"
    }]

POST Method of REST Endpoint

adhocReport is a feature supported to extract OLAP report output using both POST and GET method. This runs a PACE report service based on the request payload input parameters in JSON format.

Request Formats:

POST

URL :   https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/adhocReport

Payload:

{
"reportName": "string",
"entityId": "string",
"beginDate": "YYYYMMDD",
"endDate": "YYYYMMDD",
"fields": "string",
"outputFormat": "JSON/ JSON2/ CSV/ TSV/ XLS/ ERX"
"benchmarkToPortfolio": true/false,
"constituentsAndBenchmarkToComposite": true/false,
"firstAlternateCurrency": "string",
"secondAlternateCurrrency": "string",
"fetchPriorFXRates": "number",
"benchmarkOverride": {
               "Comparison Index 4":"string",
               "Comparison Index 5": "string",
               "IsEntities": true/false 
               },
"groupingRuleOverride": {
    "groupModel": [{"simple": "fieldID"},{"range": "aggregationID"},{"perfModel": "dictionaryID"}],
    "calculationAndDisplay": {
        "calculateAttributionAndDisplay": "TOTAL/fieldID/aggregationID/SECURITY",
        "limitResultToLevelAbove": "DoNotLimit/Limit/LimitFetchDisplay/LimitFetchNotDisplay",
        "showBelowAttribution": "true/false",
        "hideBenchmarkOnlySecurities": "true/false"
    },
    "dynamicPerformance": {
       "portfolioLookThrough": true/false,
       "adjustSecurityToMatchParent": true/false,
       "applyFilterToBenchmark": true/false
    },
    "entityHierarchy":"BOTTOMUPBALANCED/TOPDOWNBALANCED/TOPDOWNUNBALANCED",
    "globalAttributionOptions": "Single-globalattributionFieldID"
  },
}

GET

URL: https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/adhocReportreportName=******&entityId=****,****&beginDate= YYYYMMDD &endDate= YYYYMMDD &fields= 7377,7373,11429,11779,11780&outputFormat=JSON JSON/ JSON2/ CSV/ TSV/ XLS/ ERX

Below are details of the input parameter and its values in the POST request payload and GET Request URL String of the adhocReport endpoint to extract and OLAP report data.

Single entity ID or multiple entity
  • For another benchmark assignment to override. 
  • Provide another assignment name. Benchmark assignment name can be retrieved using 'benchmarkDefinitions' endpoint.
  • Provide a boolean value false in 'IsEntities' flag for another benchmark assignment.
  • Either another entity or another benchmark assignment is allowed.

Input Parameter

Description

reportName

Name of the Report.  As the name indicates, report name should be provided in string format.

entityId

Description

reportName

Name of the Report.  As the name indicates, report name should be provided in string format.

entityId

Single entity ID or multiple entity IDs with comma (,) or tilde (~) as separator should be provided in string format.

beginDate

Beginning date of the report should be provided in this particular format (YYYYMMDD).

endDate

End Date of the report should be provided in this particular format (YYYYMMDD).

fields

  • Single field ID or multiple field IDs with comma (,) or tilde (
~) as separator should be provided in string format.

beginDate

Beginning date of the report should be provided in this particular format (YYYYMMDD).

endDate

End Date of the report should be provided in this particular format (YYYYMMDD).

fields

  • Single field ID or multiple field IDs with comma (,) or tilde (~) as separator should be provided in string format.
  • Fields related to entity or security characteristic should be given along with calculation or other performance fields.

outputFormat

  • Provide any one output format from the list JSON, JSON2, CSV, TSV, XLS, ERX to receive response in that particular format.
  • Any format apart from these given options will get you response in JSON2 format (default).
constituentsAndBenchmarkToCompositeProvide boolean value either true or false. This flag is applicable only for Composite Analysis report.
benchmartToPortfolioProvide boolean value either true or false. This flag is applicable for OLAP reports such as Performance Analysis, Positions and Entity And Client.
firstAlternateCurrencyProvide 3 letter predefined Currency code. For example, USD / CAD
secondAlternateCurrrencyProvide 3 letter predefined Currency code. For example, USD/CAD 
fetchPriorFXRatesProvide numeric value starting from 1 till 1000.

"benchmarkOverride":

      {
             "Comparison Index 4":"<Entity ID>",

              "Comparison Index 5": "<Entity ID>",

              "IsEntities": true

    }

  • For another entity to override as benchmark to replace already configured benchmark.  Provide another entity Id as benchmark.
  • Provide a boolean value true in 'IsEntities' flag for another entity override.
  • Either another entity or another benchmark assignment is allowed.

  "benchmarkOverride":

    {
              "Comparison Index 5": "Primary Comparison Index",

              "IsEntities": false

     }

Info

Note

Mandatory/Required parameters: reportName, beginDate, endDate, outputFormat

Optional parameters: fields, entities. If not given or given as empty string will submit and generate report with all fields and entities mapped with that respective report profile

.

 Sample POST Request with Payload:

Request URL:   https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/adhocReport

Payload:

...

  • ~) as separator should be provided in string format.
  • Fields related to entity or security characteristic should be given along with calculation or other performance fields.

outputFormat

  • Provide any one output format from the list JSON, JSON2, CSV, TSV, XLS, ERX to receive response in that particular format.
  • Any format apart from these given options will get you response in JSON2 format (default).
constituentsAndBenchmarkToCompositeProvide boolean value either true or false. This flag is applicable only for Composite Analysis report.
benchmartToPortfolioProvide boolean value either true or false. This flag is applicable for OLAP reports such as Performance Analysis, Positions and Entity And Client.
firstAlternateCurrencyProvide 3 letter predefined Currency code. For example, USD / CAD
secondAlternateCurrrencyProvide 3 letter predefined Currency code. For example, USD/CAD 
fetchPriorFXRatesProvide numeric value starting from 1 till 1000.

"benchmarkOverride":

      {
             "Comparison Index 4":"<Entity ID>",

              "Comparison Index 5": "<Entity ID>",

              "IsEntities": true

    }

  • For another entity to override as benchmark to replace already configured benchmark.  Provide another entity Id as benchmark.
  • Provide a boolean value true in 'IsEntities' flag for another entity override.
  • Either another entity or another benchmark assignment is allowed.

  "benchmarkOverride":

    {
              "Comparison Index 5": "Primary Comparison Index",

              "IsEntities": false

     }

  • For another benchmark assignment to override. 
  • Provide another assignment name. Benchmark assignment name can be retrieved using 'benchmarkDefinitions' endpoint.
  • Provide a boolean value false in 'IsEntities' flag for another benchmark assignment.
  • Either another entity or another benchmark assignment is allowed.



Info

Note

Mandatory/Required parameters: reportName, beginDate, endDate, outputFormat

Optional parameters: fields, entities. If not given or given as empty string will submit and generate report with all fields and entities mapped with that respective report profile

.

 Sample POST Request with Payload:

Request URL:   https://o171-q001-ww01.eagleinvsys.com/eagle/report/v1/adhocReport

Payload:

{
"reportName": "AG - GroupingRule Override GRModel1",
"entityId": "MTHREN8",
"beginDate": "20200504",
"endDate": "20200504",
"fields": "1087,1099,3277",
"outputFormat": "JSON, CSV"
"benchmarkToPortfolio": true,
"constituentsAndBenchmarkToComposite": false,
"firstAlternateCurrency": "GBP",
"secondAlternateCurrrency": "AUD",
"fetchPriorFXRates": "4",
"benchmarkOverride": {
               "Comparison Index 4":"Primary Comparison Index",
               "IsEntities": false           
               },
"groupingRuleOverride": {
    "groupModel": [{"simple": "1061"},{"range": "8178"},{"perfModel": "178"}],
    "calculationAndDisplay": {
        "calculateAttributionAndDisplay": "1060",
        "limitResultToLevelAbove": "LimitFetchDisplay",
        "showBelowAttribution": "true",
        "hideBenchmarkOnlySecurities": "true"
    },
    "dynamicPerformance": {
       "portfolioLookThrough": true,
       "adjustSecurityToMatchParent": true,
       "applyFilterToBenchmark": true
    },
    "entityHierarchy":"BOTTOMUPBALANCED",
    "globalAttributionOptions": "14533"
  },
}

GET METHOD:

Sample Request URL:

...