nonderivativeHoldingsScrape: nonderivativeHoldingsScrape

Description Usage Arguments Value Examples

View source: R/nonderivativeHoldingsScrape.R

Description

The function takes the dataframe returned by secUrlDownload and scrapes and compiles a dataframe of all the nonderivative holdings that meet the keyword crtiera. If no criteria is set, all holdings from the dataframe returned by secUrlDownload are scraped. Note that the logic for the keywords is "OR." Thus if a user sets multiple footnoteKeywords and a keyword for issuerKeywords, if a holding has only one of the footnoteKeywords and none of the issuerKeywords, the holding will still be scraped.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
nonderivativeHoldingsScrape(
  index,
  form,
  name,
  email,
  footnoteKeywords = NA,
  issuerKeywords = NA,
  issuerTradingSymbol = NA,
  rptOwnerKeywords = NA
)

Arguments

index

A local object that was returned by utilizing the secUrlDownload. It contains the URLs necessary to grab each text version of the filed Form 4 or 5.

form

Define if the form is a Form 4 or Form 5. Must match the type used in secUrlDownload.

name

Specify your name. This is required by the SEC.

email

Specify your email. This is required by the SEC.

footnoteKeywords

The character vector containing any specified key words to be searched in the form's footnotes. Default is NA.

issuerKeywords

The character vector containing any specified key words to be searched within the issuer block. Criteria can include the firms CIK or name. Values must be captilized to match against SEC values. Default value is NA.

issuerTradingSymbol

The character vector containing any specified stock tickers. Values must be captilized to match against SEC values. Default value is NA.

rptOwnerKeywords

The character vector contianing any specified key words to be searched within the rptOwner block. Values must be captilized to match against SEC values. Additionally, the format is LAST NAME, FIRST NAME. The criteria can include the individuals CIK, address, or name. Default value is NA.

Value

A dataframe containing containing the scraped information where each row represents a nonderivative holding. The holding observations can be grouped by form through the URL variable within the dataframe.

Examples

1
2
3
dat <- nonderivativeHoldingsScrape(index = tempIndex, form = 4,
name = "Your Name", email = "yourEmail@yourEmail.com",
rptOwnerKeywords = c("SMITH JOHN"))

insiderTrades documentation built on Oct. 5, 2021, 1:06 a.m.