How can I use the API to retrieve the change history information of a specific RIC?

rice

Find more posts tagged with

ric

rics

#content

#product

ric change

Accepted answers

ujjawal_khandelwal

@rice , thank you for pointing out.
Better to use OrganizationID which is at the company level.
InstrumentID tracks the changes in RICs at instrument level while OrganizationID tracks at the Org level.

InstrumentID = Doesn't change when RICs are renamed, delisted, relisted etc.

OrganizationID = Links instruments related to an organization

So, in your case, if you want to find the changes at Org level, better to use OrganizationID itself. Hope it helps!

All comments

Jirapongse

@rice

Thank you for reaching out to us.

Please clarify what you mean by the change history information for a specific RIC.

rice

For example, if META was previously FB, is it possible to retrieve this change history via API?

ujjawal_khandelwal

Hi @rice,
Yes, it is possible to retrieve historical RICs for a company. For that we need to rely on PERM ID an identifier which doesn't change the way RICs change.
Below is one of the methods I could think of:

import lseg.data as ld

ld.open_session()   #assuming workspace is running on your machine
perm_id = ld.get_data(
                     universe= ['META.O'], 
                     fields= ['TR.InstrumentID'])
print(perm_id)

Once you have the perm_id you can make another call to get the RICs where the universe is the perm_id, but you need to define the time frame.

historical_rics = ld.get_history(
                      universe = ['21475078980'], 
                      fields = ['TR.RIC'], 
                      interval = '1Y', 
                      start = '2000-01-01', 
                      end = '2026-04-01')
print(historical_rics)

Hope this helps. Please let us know if you need help further by continuing on this thread : )

Thank you!

Jirapongse

@rice

I also found this one:

df = ld.get_data(
                 universe = ['META.O'], 
                 fields = ['TR.CommonName','TR.AlsoKnownAsName','TR.FormerlyKnownAsName'])
df

You can use the Data Item Browser tool to search for fields and parameters.

Otherwse, you can also use the Search API.

df = ld.get_data(
    universe = ['META.O'],
    fields = ['TR.OrganizationID'])
df

ld.discovery.search(
    view = ld.discovery.Views.ORGANISATIONS,
    filter = f"OAPermID eq '4297297477'",
    select = "PreviousNames"
    )

ld.discovery.search(
    view = ld.discovery.Views.SEARCH_ALL,
    filter = f"RIC eq 'META.O'",
    select = "SymbolHistoryScope"
    )

For more information regarding the Search API, please refer to this Building Search into your Application Workflow article.

rice

Is TR.InstrumentID unique and immutable for each RIC? TR.OrganizationID doesn't seem to be—for example, GOOGL.OQ and GOOG.OQ share the same OrganizationID, but their InstrumentIDs are different.

EXPLORE OUR SITES