Guru / Insider Data

Guru List

List all gurus and personlized gurus.

Request

GET /gurulist

Example

GET https://api.gurufocus.com/public/user/{api_token}/gurulist

Response

Response will be an object containing the list of guru names with ids. Each data point includes:
  • Guru ID
  • Guru Name
  • Guru Image
  • Firm Name
  • Number of stocks
  • Total equity (in Millions)
  • Turnover
  • Latest update date
  • CIK
  • Portfolio Date
  • Fund Ticker
{
  "all": {
    "us": [
      [
        "7",
        "Warren Buffett",
        "https://static.gurufocus.com/images/gurupics/1/warren-buffett-small.jpg",
        "Berkshire Hathaway Inc",
        "45",
        "313257",
        "0",
        "2024-01-05",
        "0001067983",
        "2023-09-30",
        ""
      ],
      [
        "1",
        "Vanguard Health Care Fund",
        "https://static.gurufocus.com/images/gurupics/1/vanguad_healthcare_small.jpg",
        "Vanguard Health Care Fund",
        "100",
        "44139",
        "3",
        "2023-11-29",
        "",
        "2023-09-30",
        "VGHCX"
      ],
      [
        "2",
        "Mason Hawkins",
        "https://static.gurufocus.com/images/gurupics/1/mason-hawkins-small.jpg",
        "Southeastern Asset Management",
        "45",
        "2700",
        "11",
        "2023-11-17",
        "0000807985",
        "2023-09-30",
        ""
      ]
    ],
    "plus": [],
    "international": []
  },
  "my": {
    "default": [
      "1",
      "2",
      "3"
    ]
  }
}

Guru Stock Picks

List guru stock picks using guru id and date. This API mainly provides data for the guru stock picks page.

Please notice that the portfolio is from the start_date to the end_date. If the end_date is not set, it will take data from the start_date to now. Also, each query can get 500 stocks at most. Therefore, if there are more than 500 stocks, you need to loop for the page parameter until the return value is empty.

Request

GET /guru/{id}/picks/{start_date}/{page}?end_date={end_date?}

Parameters

  • id Required
    Guru id got from Guru List API
  • start_date Required
    Starting date for guru picks. Date format is YYYY-mm-dd
  • page Required
    Page number of results
  • end_date Optional
    end_date for guru picks. Default is current date. Date format is YYYY-mm-dd

Example

GET https://api.gurufocus.com/public/user/{api_token}/guru/7/picks/2019-03-31/1?end_date=2019-07-01

Response

Response will be an object containing the list of gurus stock picks. Results are sorted by time in descending order; if there are multiple data points in a date, they are sorted by the absolute value of trans_share from largest to smallest.
{
  "Warren Buffett": {
    "port": [
      {
        "symbol": "JPM",
        "exchange": "NYSE",
        "company": "JPMorgan Chase & Co",
        "price": 109.16,
        "currency": "$",
        "GuruName": "Warren Buffett",
        "type": "quarterly",
        "RecmDate": "2019-03-31",
        "RecmAction": "Add",
        "trans_share": 0.48,
        "RecmPrice": 103,
        "price_min": 97.11,
        "price_max": 107.19,
        "change": 5.98,
        "share_current": 59514932,
        "industry": "Banks - Global",
        "sector": "Financial Services",
        "symbol_ori": "JPM",
        "currency_txt": "USD",
        "comment": "Add 18.75%"
      }
    ]
  }
}

Guru Aggregated Portfolio

List aggregated portfolios. This API mainly provides data for the aggregated portfolio page.

Request

GET /guru/{id}/aggregated?page={page?}&portdate={portdate?}

Parameters

  • id Required
    Guru id got from Guru List API
  • portdate Optional
    Date for guru picks
  • page Optional
    Page number of results. Each page contains up to 200 stocks. Therefore, if there are more than 200 stocks, you need to loop for the page parameter until the return value of "port" is empty.

Example

GET https://api.gurufocus.com/public/user/{api_token}/guru/7/aggregated?page=1&portdate=2022-06-30

Response

Response will be an object containing the list of gurus portfolios. Stocks in the portfolio are sorted by position in descending order. Each query contains up to 200 data points.
{
  "7": {
    "summary": {
      "firm": "Berkshire Hathaway",
      "num_new": 1,
      "number_of_stocks": 48,
      "equity": 199484,
      "turnover": 1,
      "country": "USA",
      "date": "2019-05-15"
    },
    "port": [
      {
        "13f_date": "2019-03-31",
        "share": 249589329,
        "symbol": "AAPL",
        "exchange": "NAS",
        "industry": "Consumer Electronics",
        "sector": "Technology",
        "company": "Apple Inc",
        "price": 190.15,
        "currency": "$",
        "52l": 33.91,
        "52h": 18.55,
        "mktcap": "874894.420",
        "pe": "16.00",
        "yield": "1.56",
        "change": 0,
        "value": 47409494,
        "position": 23.77,
        "impact": 0,
        "pct": 5.42,
        "symbol_ori": "AAPL",
        "currency_txt": "USD"
      }
    ]
  }
}

Latest Insider Trades

Get list of latest insider trades ordered by insider transctions time.

Request

GET /insider_updates?page={page?}&date={date?}

Parameters

  • page Optional
    Page number of results.
  • date Optional
    Date of insider transaction. Date format is YYYY-mm-dd.
  • region Optional
    Select insider trades from a specific region.
    options of region:
    • USA
    • Canada
    • UK/Ireland
    • Europe
    • Asia
    • Oceania
    • Latin America
    • Africa
    • India/Pakistan
  • file_date Optional
    Filing date of insider transaction. Date format is YYYY-mm-dd.
  • sort Optional
    Sort results by result field.
  • order Optional
    Sort order of results, use 'desc' for descending order, 'asc' for ascending order. The default is 'desc'.

Example

GET https://api.gurufocus.com/public/user/{api_token}/insider_updates?page=1&date=2020-01-01

Response

Response will be an array containing the list of insider trades ordered by transaction date. Each query contains up too 300 data points. The parameter page can be changed to get more data.
[
  {
    "symbol": "NAS:TECD",
    "exchange": "NAS",
    "position": "Director",
    "date": "2019-06-07",
    "type": "S",
    "trans_share": 2200,
    "final_share": 10637,
    "price": 95.29,
    "cost": 209.6,
    "insider": "HARCZAK HARRY J JR"
  },
  {
    "symbol": "NYSE:WCC",
    "exchange": "NYSE",
    "position": "Director",
    "date": "2019-06-07",
    "type": "S",
    "trans_share": 1513,
    "final_share": 11151,
    "price": 48.97,
    "cost": 74.1,
    "insider": "UTTER LYNN M"
  }
]

Insider CEO/CFO buys

Get list of companies whose CEO/CFOs are buying or selling their own stock.

Request

GET /insider_buys/{insider_type}?page={page?}&within_days={within_days?}

Parameters

  • insider_type Required
    Insider type, using 'insider_ceo' for ceo data, using 'insider_cfo' for cfo data.
  • page Optional
    Page number of results.
  • within_days Optional
    Specify the date range of the results, from the current date back to the specified number of days before the current date. The value of this parameter can be 7, 14, 30, 60, 90, 180, 365.

Example

GET https://api.gurufocus.com/public/user/{api_token}/insider_buys/insider_ceo?page=1

Response

Response will be an array containing the list of insider transactions for the last 5 years which is ordered by insider transction time. Each query contains up too 300 data points. The parameter page can be changed to get more data.
[
  {
    "exchange": "OTCPK",
    "symbol": "VPLM",
    "company": "Voip-Pal.com Inc",
    "name": "Barbara Baggio",
    "position": "WIFE OF CEO",
    "date": "2024-01-19",
    "type": "S",
    "trans_share": 1049750,
    "shares_change": -0.69,
    "trade_price": 0.02,
    "cost": 20995,
    "final_share": 151323995,
    "change_from_insider_trade": -11.03,
    "file_date": "2024-01-22"
  },
  {
    "exchange": "NYSE",
    "symbol": "MSM",
    "company": "MSC Industrial Direct Co Inc",
    "name": "Erik Gershwind",
    "position": "President and CEO",
    "date": "2024-01-19",
    "type": "S",
    "trans_share": 60939,
    "shares_change": -3.97,
    "trade_price": 96.57,
    "cost": 5884880,
    "final_share": 1473534,
    "change_from_insider_trade": 1.17,
    "file_date": "2024-01-22"
  },
  {
    "exchange": "NAS",
    "symbol": "ABOS",
    "company": "Acumen Pharmaceuticals Inc",
    "name": "Daniel Joseph Oconnell",
    "position": "President and CEO",
    "date": "2024-01-19",
    "type": "S",
    "trans_share": 15200,
    "shares_change": -2.94,
    "trade_price": 3.47,
    "cost": 52744,
    "final_share": 502485,
    "change_from_insider_trade": -2.31,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "CLSD",
    "company": "Clearside Biomedical Inc",
    "name": "George M Lasezkay",
    "position": "CEO",
    "date": "2024-01-19",
    "type": "S",
    "trans_share": 18000,
    "shares_change": -3.71,
    "trade_price": 1.27,
    "cost": 22860,
    "final_share": 466577,
    "change_from_insider_trade": -5.51,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "QCOM",
    "company": "Qualcomm Inc",
    "name": "Cristiano R Amon",
    "position": "President & CEO",
    "date": "2024-01-19",
    "type": "S",
    "trans_share": 8100,
    "shares_change": -2.97,
    "trade_price": 149.5,
    "cost": 1210950,
    "final_share": 264967,
    "change_from_insider_trade": 2.25,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "OPK",
    "company": "OPKO Health Inc",
    "name": "Frost Phillip Md Et Al",
    "position": "CEO & Chairman, 10% Owner",
    "date": "2024-01-19",
    "type": "P",
    "trans_share": 500000,
    "shares_change": 0.21,
    "trade_price": 0.98,
    "cost": 490000,
    "final_share": 239064353,
    "change_from_insider_trade": 3.06,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "AEHR",
    "company": "Aehr Test Systems",
    "name": "Gayn Erickson",
    "position": "President and CEO",
    "date": "2024-01-18",
    "type": "S",
    "trans_share": 4871,
    "shares_change": -1.13,
    "trade_price": 17.39,
    "cost": 84706.7,
    "final_share": 427935,
    "change_from_insider_trade": -5.75,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "EQIX",
    "company": "Equinix Inc",
    "name": "Charles J Meyers",
    "position": "CEO and President",
    "date": "2024-01-18",
    "type": "S",
    "trans_share": 8718,
    "shares_change": -53.29,
    "trade_price": 793.92,
    "cost": 6921390,
    "final_share": 7642,
    "change_from_insider_trade": 1.05,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NAS",
    "symbol": "VCEL",
    "company": "Vericel Corp",
    "name": "Dominick Colangelo",
    "position": "President and CEO",
    "date": "2024-01-18",
    "type": "S",
    "trans_share": 33452,
    "shares_change": -16.44,
    "trade_price": 38.28,
    "cost": 1280540,
    "final_share": 169985,
    "change_from_insider_trade": 9.8,
    "file_date": "2024-01-19"
  },
  {
    "exchange": "NYSE",
    "symbol": "SIG",
    "company": "Signet Jewelers Ltd",
    "name": "Virginia Drosos",
    "position": "CEO",
    "date": "2024-01-18",
    "type": "S",
    "trans_share": 35000,
    "shares_change": -3.62,
    "trade_price": 95.93,
    "cost": 3357550,
    "final_share": 932740,
    "change_from_insider_trade": 5.93,
    "file_date": "2024-01-19"
  }
]

Insider Cluster buys

Get list of stocks that have been bought by the most number of insiders.

Request

GET /insider_buys/insider_cluster_buy?page={page?}&within_days={within_days?}

Parameters

  • page Optional
    Page number of results.
  • within_days Optional
    Specify the date range of the results, from the current date back to the specified number of days before the current date. The value of this parameter can be 7, 14, 30, 60, 90, 180, 365.

Example

GET https://api.gurufocus.com/public/user/{api_token}/insider_buys/insider_cluster_buy?page=1

Response

Response will be an array containing the list of insider trades for the last 5 years. Each query contains up too 300 data points. The parameter page can be changed to get more data.
[
  {
    "exchange": "AMEX",
    "symbol": "RCG",
    "company": "RENN Fund Inc",
    "insider_buy_count": 776,
    "insider_buy_count_unique": 9,
    "buy_total_shares": 549285,
    "buy_price_avg": 2.04,
    "buy_price_value": 1126049.5702209473,
    "buy_change_from_average": -20.588235294117645,
    "buy_company_held_shares": 7.8
  },
  {
    "exchange": "NYSE",
    "symbol": "HY",
    "company": "Hyster-Yale Materials Handling Inc",
    "insider_buy_count": 590,
    "insider_buy_count_unique": 31,
    "buy_total_shares": 1180433,
    "buy_price_avg": 58.86,
    "buy_price_value": 68691955.86230469,
    "buy_change_from_average": 17.821950390757724,
    "buy_company_held_shares": 6.9
  },
  {
    "exchange": "NYSE",
    "symbol": "KFS",
    "company": "Kingsway Financial Services Inc",
    "insider_buy_count": 314,
    "insider_buy_count_unique": 11,
    "buy_total_shares": 3498161,
    "buy_price_avg": 5.04,
    "buy_price_value": 14066291.194763184,
    "buy_change_from_average": 69.64285714285715,
    "buy_company_held_shares": 12.4
  },
  {
    "exchange": "NAS",
    "symbol": "TURN",
    "company": "180 Degree Capital Corp",
    "insider_buy_count": 256,
    "insider_buy_count_unique": 6,
    "buy_total_shares": 831210.0525782704,
    "buy_price_avg": 6.04,
    "buy_price_value": 4880170.732971191,
    "buy_change_from_average": -32.94701986754967,
    "buy_company_held_shares": 8.3
  },
  {
    "exchange": "NAS",
    "symbol": "BWFG",
    "company": "Bankwell Financial Group Inc",
    "insider_buy_count": 219,
    "insider_buy_count_unique": 13,
    "buy_total_shares": 169657,
    "buy_price_avg": 26.87,
    "buy_price_value": 4472194.199829102,
    "buy_change_from_average": 9.415705247487896,
    "buy_company_held_shares": 2.2
  },
  {
    "exchange": "NAS",
    "symbol": "NGM",
    "company": "NGM Biopharmaceuticals Inc",
    "insider_buy_count": 200,
    "insider_buy_count_unique": 5,
    "buy_total_shares": 28297645,
    "buy_price_avg": 11.76,
    "buy_price_value": 363939154.49316406,
    "buy_change_from_average": -89.1156462585034,
    "buy_company_held_shares": 34.2
  },
  {
    "exchange": "NAS",
    "symbol": "MMLP",
    "company": "Martin Midstream Partners LP",
    "insider_buy_count": 195,
    "insider_buy_count_unique": 7,
    "buy_total_shares": 2890750,
    "buy_price_avg": 3.37,
    "buy_price_value": 8503467.925689697,
    "buy_change_from_average": -30.26706231454006,
    "buy_company_held_shares": 7.4
  },
  {
    "exchange": "AMEX",
    "symbol": "RVP",
    "company": "Retractable Technologies Inc",
    "insider_buy_count": 194,
    "insider_buy_count_unique": 3,
    "buy_total_shares": 1628257,
    "buy_price_avg": 1.95,
    "buy_price_value": 4045898.2207565308,
    "buy_change_from_average": -37.43589743589744,
    "buy_company_held_shares": 5.4
  },
  {
    "exchange": "NAS",
    "symbol": "GBDC",
    "company": "Golub Capital BDC Inc",
    "insider_buy_count": 190,
    "insider_buy_count_unique": 8,
    "buy_total_shares": 3988723,
    "buy_price_avg": 14.2,
    "buy_price_value": 54721116.498046875,
    "buy_change_from_average": 9.366197183098592,
    "buy_company_held_shares": 2.4
  },
  {
    "exchange": "NAS",
    "symbol": "OPK",
    "company": "OPKO Health Inc",
    "insider_buy_count": 188,
    "insider_buy_count_unique": 11,
    "buy_total_shares": 33239895,
    "buy_price_avg": 2.03,
    "buy_price_value": 63291185.142578125,
    "buy_change_from_average": -50.24630541871921,
    "buy_company_held_shares": 4.3
  }
]

Double/Triple buys

Get list of Double/Triple insider trades.

Request

GET /insider_buys/{insider_type}?page={page?}&within_days={within_days?}

Parameters

  • insider_type Required
    Insider type, using 'insider_double' for double buys, using 'insider_triple' for triple buys.
  • page Optional
    Page number of results.
  • within_days Optional
    Specify the date range of the results, from the current date back to the specified number of days before the current date. The value of this parameter can be 7, 14, 30, 60, 90, 180, 365.

Example

GET https://api.gurufocus.com/public/user/{api_token}/insider_buys/insider_double?page=1

Response

Response will be an array containing the list of stocks with number of insider and guru buys for the last 5 years. Each query contains up too 300 data points. The field buy_add_count stand for the number of gurus that bought shares in a company. The parameter page can be changed to get more data.
[
  {
    "exchange": "AMEX",
    "symbol": "RCG",
    "company": "RENN Fund Inc",
    "buy_add_count": 1,
    "insider_buy_count": 777,
    "insider_buy_shares": 549385
  },
  {
    "exchange": "NYSE",
    "symbol": "HY",
    "company": "Hyster-Yale Materials Handling Inc",
    "buy_add_count": 3,
    "insider_buy_count": 592,
    "insider_buy_shares": 1180633
  },
  {
    "exchange": "NYSE",
    "symbol": "KFS",
    "company": "Kingsway Financial Services Inc",
    "buy_add_count": 0,
    "insider_buy_count": 314,
    "insider_buy_shares": 3498161
  },
  {
    "exchange": "NAS",
    "symbol": "BWFG",
    "company": "Bankwell Financial Group Inc",
    "buy_add_count": 2,
    "insider_buy_count": 219,
    "insider_buy_shares": 169657
  },
  {
    "exchange": "NAS",
    "symbol": "NGM",
    "company": "NGM Biopharmaceuticals Inc",
    "buy_add_count": 1,
    "insider_buy_count": 200,
    "insider_buy_shares": 28297645
  },
  {
    "exchange": "AMEX",
    "symbol": "RVP",
    "company": "Retractable Technologies Inc",
    "buy_add_count": 1,
    "insider_buy_count": 195,
    "insider_buy_shares": 1628357
  },
  {
    "exchange": "NAS",
    "symbol": "GBDC",
    "company": "Golub Capital BDC Inc",
    "buy_add_count": 3,
    "insider_buy_count": 190,
    "insider_buy_shares": 3988723
  },
  {
    "exchange": "NAS",
    "symbol": "OPK",
    "company": "OPKO Health Inc",
    "buy_add_count": 1,
    "insider_buy_count": 188,
    "insider_buy_shares": 33239895
  },
  {
    "exchange": "AMEX",
    "symbol": "FGH",
    "company": "FG Group Holdings Inc",
    "buy_add_count": 0,
    "insider_buy_count": 188,
    "insider_buy_shares": 2277410
  },
  {
    "exchange": "NAS",
    "symbol": "VOXX",
    "company": "VOXX International Corp",
    "buy_add_count": 0,
    "insider_buy_count": 185,
    "insider_buy_shares": 9923334
  }
]

Politician List

List all politicians.

Request

GET /politicians

Example

GET https://api.gurufocus.com/public/user/{api_token}/politicians

Response

Response will be an array containing the list of politician id and names with basic information.
[
  {
    "id": 1,
    "full_name": "Dan Sullivan",
    "position": "senator",
    "district": "AK00",
    "state": "AK",
    "party": "Republican"
  },
  {
    "id": 2,
    "full_name": "Thomas R. Carper",
    "position": "senator",
    "district": "DE00",
    "state": "DE",
    "party": "Democrat"
  },
  {
    "id": 3,
    "full_name": "Maria Cantwell",
    "position": "senator",
    "district": "WA00",
    "state": "WA",
    "party": "Democrat"
  },
  {
    "id": 4,
    "full_name": "Tommy Tuberville",
    "position": "senator",
    "district": "AL00",
    "state": "AL",
    "party": "Republican"
  },
  {
    "id": 5,
    "full_name": "Jacky Rosen",
    "position": "senator",
    "district": "NV00",
    "state": "NV",
    "party": "Democrat"
  },
  {
    "id": 6,
    "full_name": "Michael C. Burgess",
    "position": "representative",
    "district": "TX26",
    "state": "TX",
    "party": "Republican"
  },
  {
    "id": 7,
    "full_name": "Nancy Pelosi",
    "position": "representative",
    "district": "CA11",
    "state": "CA",
    "party": "Democrat"
  }
]

Latest Politician Transactions

Get list of latest politician transactions.

Request

GET /politicians/transactions?page={page?}&asset_type={asset_type?}&id={id?}&sort={sort?}&order={order?}

Parameters

  • page Optional
    Page number of results
  • asset_type Optional
    Asset type of politician transaction, the default value is Common_Stock.
    options of asset_type:
    • All
    • Common_Stock
    • Option
    • ETF
    • Preferred_Stock
    • Bond
    • Units
    • Warrant
    • Other
  • id Optional
    Get transactions of the specified politician, politician id could be found in Politician List API.
  • sort Optional
    Sorting results on 'disclosure_date' or 'transaction_date', the default is 'disclosure_date'.
  • order Optional
    Sort order of results, use 'desc' for descending order, 'asc' for ascending order. The default is 'desc'.

Example

GET https://api.gurufocus.com/public/user/{api_token}/politicians/transactions?page=1&asset_type=Common_Stock

Response

Response will be an array containing the most recent politician trades. Each query contains up too 300 data points. The parameter page can be changed to get more data.
[
  {
    "symbol": "ROK",
    "company": "Rockwell Automation Inc",
    "exchange": "NYSE",
    "industry": 31070020,
    "class": "Common Stock",
    "stockid": "US09CP",
    "option_type": "",
    "strike_price": "",
    "trans_type": "purchase",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "SWKS",
    "company": "Skyworks Solutions Inc",
    "exchange": "NAS",
    "industry": 31130020,
    "class": "Common Stock",
    "stockid": "US05JM",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_full",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "SCCO",
    "company": "Southern Copper Corp",
    "exchange": "NYSE",
    "industry": 10150020,
    "class": "Common Stock",
    "stockid": "US09F6",
    "option_type": "",
    "strike_price": "",
    "trans_type": "purchase",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "TSLA",
    "company": "Tesla Inc",
    "exchange": "NAS",
    "industry": 10200020,
    "class": "Common Stock",
    "stockid": "US05PU",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_full",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "MMM",
    "company": "3M Co",
    "exchange": "NYSE",
    "industry": 31030010,
    "class": "Common Stock",
    "stockid": "US08H1",
    "option_type": "",
    "strike_price": "",
    "trans_type": "purchase",
    "amount": "$15,001 - $50,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "UNP",
    "company": "Union Pacific Corp",
    "exchange": "NYSE",
    "industry": 31080030,
    "class": "Common Stock",
    "stockid": "US09XE",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_full",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "WU",
    "company": "The Western Union Co",
    "exchange": "NYSE",
    "industry": 10360010,
    "class": "Common Stock",
    "stockid": "US0A51",
    "option_type": "",
    "strike_price": "",
    "trans_type": "purchase",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-17",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "A",
    "company": "Agilent Technologies Inc",
    "exchange": "NYSE",
    "industry": 20660010,
    "class": "Common Stock",
    "stockid": "US0664",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_partial",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-16",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "ADP",
    "company": "Automatic Data Processing Inc",
    "exchange": "NAS",
    "industry": 31020050,
    "class": "Common Stock",
    "stockid": "US01YS",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_full",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-16",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  },
  {
    "symbol": "CSX",
    "company": "CSX Corp",
    "exchange": "NAS",
    "industry": 31080030,
    "class": "Common Stock",
    "stockid": "US02UD",
    "option_type": "",
    "strike_price": "",
    "trans_type": "sale_partial",
    "amount": "$1,001 - $15,000",
    "disclosure_date": "2023-11-16",
    "transaction_date": "2023-10-16",
    "expiration_date": "",
    "id": 4,
    "full_name": "Tommy Tuberville",
    "official_full": "Tommy Tuberville",
    "position": "senator",
    "state": "AL",
    "party": "Republican"
  }
]
        

Insider List

List all insiders.

Request

GET /insider_list?page={page?}

Parameters

  • page Optional
    Page number of results, default is 1.

Example

GET https://api.gurufocus.com/public/user/{api_token}/insider_list?page=1

Response

Response will be an object containing the list of insiders with basic information. Each query contains 200 data points.
{
  "data": [
    {
      "cik": "0001181886",
      "name": "J Todd Mitchell",
      "address": "DEVON ENERGY CORPORATION, 20 N. BROADWAY, OKLAHOMA CITY OK 73102",
      "latest_transaction_date": "2011-03-01",
      "Companys": [
        "DVN"
      ]
    },
    {
      "cik": "0001177123",
      "name": "William F Hirt",
      "address": "3270 KINGSTON COURT, ERIE PA 16506",
      "latest_transaction_date": "",
      "Companys": [
        "ERIE"
      ]
    },
    {
      "cik": "0001256303",
      "name": "A Timothy Godwin",
      "address": "",
      "latest_transaction_date": "2003-11-04",
      "Companys": [
        "NTGR"
      ]
    },
    {
      "cik": "0001244360",
      "name": "Abby M Oneill",
      "address": "MFS INVESTMENT MANAGEMENT, 500 BOYLSTON STREET, BOSTON MA 02116",
      "latest_transaction_date": "",
      "Companys": [
        "MFM",
        "MMT",
        "MGF",
        "MIN",
        "MCR",
        "MFV"
      ]
    }
  ],
  "currentPage": 1,
  "lastPage": 1154
}

Gurus Real Time Stock Picks

List stock purchases and sales that Gurus have made within the prior 20 weeks. The report time lag can be as short as 3 days after the date of the transaction. This API mainly provides data for the guru real time stock picks page.

Request

GET /guru_realtime_picks?page={page?}&action={action?}&portdate={portdate?}

Parameters

  • page Optional
    Page number of results, default is 1.
  • action Optional
    Buy/Sell type of guru real time pick, the default value is 'all'.
    options of action:
    • all
    • add
    • buy
    • buy_add
    • reduce
    • sell
    • sell_reduce
  • portdate Optional
    Date for guru picks. Date format is YYYY-mm-dd.

Example

GET https://api.gurufocus.com/public/user/{api_token}/guru_realtime_picks?page=1

Response

Response will be an object containing the list of guru real time stock picks. Each query contains 20 data points.
{
  "data": [
    {
      "currency": "USD",
      "company": "Liberty SiriusXM Group",
      "action": "Add",
      "portdate": "2024-04-08",
      "impact": 0.02,
      "price": 26.09,
      "price_avg": 27.41,
      "change": 3.7,
      "comment": "Add 3.7%",
      "shares": 67909913,
      "guru_name": "Warren Buffett",
      "symbol": "LSXMK",
      "exchange": "NAS"
    },
    {
      "currency": "USD",
      "company": "Liberty SiriusXM Group",
      "action": "Add",
      "portdate": "2024-04-08",
      "impact": 0.01,
      "price": 26.16,
      "price_avg": 27.33,
      "change": 3.43,
      "comment": "Add 3.43%",
      "shares": 33878329,
      "guru_name": "Warren Buffett",
      "symbol": "LSXMA",
      "exchange": "NAS"
    },
    {
      "currency": "USD",
      "company": "Crescent Capital BDC Inc",
      "action": "Reduce",
      "portdate": "2024-04-08",
      "impact": -0.31,
      "price": 17.15,
      "price_avg": 17.09,
      "change": -12.8,
      "comment": "Reduce -12.8%",
      "shares": 1824805,
      "guru_name": "Prem Watsa",
      "symbol": "CCAP",
      "exchange": "NAS"
    },
    {
      "currency": "USD",
      "company": "Liberty SiriusXM Group",
      "action": "Add",
      "portdate": "2024-03-28",
      "impact": 0.06,
      "price": 26.09,
      "price_avg": 29.1,
      "change": 13.13,
      "comment": "Add 13.13%",
      "shares": 65486288,
      "guru_name": "Warren Buffett",
      "symbol": "LSXMK",
      "exchange": "NAS"
    }
  ],
  "total": 402,
  "currentPage": "1",
  "lastPage": 21
}