SEC EDGAR

This crate provides tools to query the SEC's EDGAR API.

Usage

Define USER_AGENT in your environment variables. According to the SEC, it must be in the format:

USER_AGENT="Sample Company Name AdminContact@<sample company domain>.com"

Sample Query:

use sec_edgar::edgar::{edgar_client, get_feed_entries, get_feed_entry_content};
use sec_edgar::edgar_query::cik_query::CIKQuery;
use sec_edgar::edgar_query::filing_types::FilingTypeOption::_10Q;
use sec_edgar::edgar_query::edgar_query_builder::{FilingInput, EdgarQueryBuilder};

async fn some_func() {
    let ticker = "c";
    // To save yourself a trip, you can store the file locally and query it instead.
    // The file can be downloaded from [here](https://www.sec.gov/include/ticker.txt).
    // let cik_query = CIKQuery::new(Some("./ignore/ticker.txt"))
    let cik_query = CIKQuery::new(None)
        .get_cik(ticker)
        .await
        .expect("ticker not found");
    let query = EdgarQueryBuilder::new(&cik_query)
        .set_filing_type(FilingInput::TypeFiling(_10Q))
        .build()
        .unwrap();
    let entries = get_feed_entries(edgar_client(), query).await;
    let filing_type = get_feed_entry_content(entries.first().unwrap())
        .await
        .filing_type
        .value;
}