edgar-rs

Async Rust client for the SEC EDGAR API with built-in rate limiting.

Features

• Full coverage of the EDGAR public API (tickers, submissions, documents, XBRL, full-text search)
• Automatic rate limiting (10 req/s default, per SEC fair access policy)
• Strongly typed responses with serde
• Cik newtype for type-safe CIK number handling
• Async/await with reqwest and tokio

Installation

cargo add edgar-rs

Or add to your Cargo.toml:

[dependencies]
edgar-rs = "0.1"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Quick start

use edgar_rs::{ClientBuilder, Cik};

#[tokio::main]
async fn main() -> edgar_rs::Result<()> {
    // SEC requires a User-Agent identifying your application
    let client = ClientBuilder::new("MyApp/1.0 contact@example.com")
        .build()?;

    // Fetch all company tickers
    let tickers = client.get_tickers().await?;
    println!("Total tickers: {}", tickers.len());

    // Get Apple's submission data
    let submission = client.get_submission(Cik::new(320193)).await?;
    println!("Company: {}", submission.name);

    Ok(())
}

API coverage

Rate limiting

SEC EDGAR requires all automated tools to limit requests to 10 per second. This client enforces that by default. You can adjust it via ClientBuilder::rate_limit(), but going above 10 is not recommended.

License

MIT