Filings API Reference#

use finance_query::{Providers, edgar};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // EDGAR is keyless but SEC requires a contact email in the User-Agent.
    // Initialise it once per process (or set the EDGAR_EMAIL env var).
    edgar::init("you@example.com")?;

    let providers = Providers::builder().build().await?;
    let filings = providers.filings("AAPL");
    let result = filings.get().await?;

    for f in result.filings.iter().take(5) {
        println!(
            "{} {}: {}",
            f.filing_date.as_deref().unwrap_or("?"),
            f.filing_type.as_deref().unwrap_or("?"),
            f.filing_url.as_deref().unwrap_or("-")
        );
    }
    Ok(())
}

use finance_query::{Capability, Provider, Providers};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let providers = Providers::builder()
        .route(Capability::FILINGS, [Provider::CongressTrades, Provider::Edgar])
        .build()
        .await?;

    let filings = providers.filings("AAPL");
    for trade in filings.congressional_trades().await? {
        println!(
            "{} {}: {} {} on {}",
            trade.office.as_deref().unwrap_or("?"),
            trade.last_name.as_deref().unwrap_or("?"),
            trade.trade_type.as_deref().unwrap_or("?"),
            trade.amount.as_deref().unwrap_or("?"),
            trade.transaction_date.as_deref().unwrap_or("?")
        );
    }
    Ok(())
}

use finance_query::{FilingSectionForm, Providers};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let providers = Providers::builder().build().await?;
    let filings = providers.filings("AAPL");

    let submissions = filings.get().await?;
    let latest_10k = submissions
        .filings
        .iter()
        .find(|f| f.filing_type.as_deref() == Some("10-K"))
        .and_then(|f| f.accession_number.as_deref())
        .unwrap_or_default();

    for section in filings.sections(latest_10k, FilingSectionForm::TenK).await? {
        println!(
            "{}: {} chars",
            section.section.as_deref().unwrap_or("?"),
            section.content.as_deref().unwrap_or("").len()
        );
    }
    Ok(())
}

use finance_query::Providers;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let providers = Providers::builder().build().await?;
    let filings = providers.filings("AAPL");

    for factor in filings.risk_factors().await?.iter().take(5) {
        println!("{}", factor.title.as_deref().unwrap_or("?"));
    }
    Ok(())
}

use finance_query::{Providers, edgar};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    edgar::init("you@example.com")?;

    let providers = Providers::builder().build().await?;
    let filings = providers.filings("AAPL");

    for row in filings.fails_to_deliver().await? {
        println!(
            "{}: {:?} shares of {:?}",
            row.date.as_deref().unwrap_or("?"),
            row.quantity,
            row.name
        );
    }
    Ok(())
}