Hedge Fund Monitor

Series Information and Data: Multiple Series

https://data.financialresearch.gov/hf/v1/series/multifull

Description

Returns all the data and metadata for all given series. A hashed object is returned with a top-level key of the mnemonic. Below that are two keys:

Key Description
timeseries contains each of the series of data points associated with this mnemonic. Each series is keyed by its subseries name.
metadata contains a full hash of all series information associated with this mnemonic.

Parameters

  • mnemonics - Comma separated list of mnemonics (unique identifiers) for all series for which you want to retrieve data. This parameter is required.
  • start_date - First date in "YYYY-MM-DD" format for which you want to receive data. If no start_date is given, "1901-01-01" is used.
  • end_date - Last date in "YYYY-MM-DD" format for which you want to receive data. If no end_date is given, today's date is used.
  • periodicity - Converts the series to the given periodicity. Available values are:
    Value Description
    A Calendar Year End
    AS Calendar Year Start
    D Daily
    M Calendar Month End
    MS Calendar Month Start
    W Weekly (Sunday Start)
    B Business Day (Weekday)
    BM Business Month End
    BMS Business Month Start
    Q Quarter End
    BQ Business Quarter End
    QS Quarter Start
    BQS Business Quarter Start
    BA Business Year End
    BAS Business Year Start
  • how - How to calculate the value for the given periodicity. By default the last value in that period is given. Available values are:
    Value Description
    first First Value of the Period
    last Last Value of the Period
    mean Mean Value for the Period
    median Median Value for the Period
    sum Sum of All Values in the Period
  • remove_nulls - If this parameter is set to "true" all nulls in the series will be removed.
  • time_format - The format for the dates in the series. By default they are returned as strings in the format: YYYY-MM-DD. Available values are:
    Value Description
    date Returned as a string in the format: YYYY-MM-DD
    ms Returned as an integer of the number of milliseconds since epoch (1970-01-01)

Examples

Call:
https://data.financialresearch.gov/hf/v1/series/multifull?mnemonics=REPO-DVP_AR_G30-P,REPO-DVP_AR_LE30-P
Output:
{
  "REPO-DVP_AR_G30-P": {
    "timeseries": {
      "aggregation": [
        [
          "2019-10-21",
          1.91
        ],
        [
          "2019-10-22",
          1.91
        ],
  ...
  "metadata": {
      "mnemonic": "REPO-DVP_AR_G30-P",
      "description": {
        "vintage_approach": "Final",
        "vintage": "Preliminary",
  ...
  "REPO-DVP_AR_LE30-P": {
    "timeseries": {
      "aggregation": [
        [
          "2019-10-21",
          1.9
        ],
        [
          "2019-10-22",
          1.93
        ],
        [
          "2019-10-23",
          1.93
        ],
      ...
      "metadata": {
      "mnemonic": "REPO-DVP_AR_LE30-P",
      "description": {
        "vintage_approach": "Final",
        "vintage": "Preliminary",
      ...
}

Version

This API endpoint is available in the following versions of the OFR API.

1