Each time the service is invoked (by sending an Adapptr file or XML file directly to the enrichment service) we will scan through the instruments to enrich, firstly checking any customer supplied data using Bring Your Own Data (BYOD), then using the FundApps ETF library.
<aside> 💡 Any data supplied via Bring Your Own Data (BYOD) will be checked and used first if available. BYOD does not count towards your ETF library usage.
</aside>
When scanning through the ETF library for matches to customer supplied Instruments we will check for direct matches (Customer supplied ETF to FundApps ETF) as well as Benchmark matches (Index based instruments).
Any matches at the composite level we find will be used to add constituent weightings to these instruments. Constituents are cross referenced against your outright holdings of the underlying and related accordingly. Once matched in the library, this will count as 1 use of your allowance.
ETF usage is tracked for up to a year at which point the usage token will be re-allocated back into your allowance.
<aside> 💡 The same entry in the FundApps ETF library may be utilised to enrich multiple instruments, either directly or via benchmark ISINs.
</aside>
To check the ETF Library utilization the customer can use the follow API:
<https://NAME-svc.fundapps.co/api/adapptr/v2/composites/usage>
Where NAME is replaced with your FundApps tenant name
The API is similar to all our others, requiring basic authorization using an API user and password configured in the main FundApps platform.
API Responses typically follow the below format:
{
"used": 2,
"contracted": 10,
"etfsUsed": [
{
"etfISIN": "DE000A0F5UK5",
"etfBenchmarkISIN": "EU0009658632"
},
{
"etfISIN": "IE0005042456"
}
]
}