Best Practices for Using the Daloopa API

To get started with our API, we recommend the following steps:

  1. Discover Supported Companies
    Begin by using the get_companies endpoint to identify the list of companies for which we provide datasheets. This endpoint returns detailed information, including company names, tickers, industries, and sectors.
  2. Fetch Historical Data
    After identifying the desired company, use the export/{ticker} endpoint to retrieve the full historical dataset for that company. This endpoint provides comprehensive financial information, formatted as a CSV file for easy integration into your workflows.
  3. Use the real_time Query Parameter
    The export/{ticker} endpoint includes a real_time query parameter, which controls how quickly you access incremental updates to the datasheet.
    • Set real_time=true during high-priority periods, such as earnings seasons, when immediate access to newly released financial data is critical. In this mode, datapoints are updated incrementally as they become available, allowing analysts to begin their work as soon as possible.
    • Set real_time=false to retrieve fully reviewed and finalized data, ensuring completeness and consistency. This option may take longer, depending on the SLA for the specific company.
  4. Work with Specific Data Points
    Each row in the CSV output represents a specific datapoint and includes a column named series_id, which corresponds to a unique line item in our datasheet. If you're only interested in certain datapoints/line items, use the series_id to filter the data.
    For more details on identifying relevant series_id values, refer to our documentation: Tag ID Preview Documentation.