{"id":36419352,"url":"https://github.com/earningsfeed/earningsfeed-rust","last_synced_at":"2026-01-11T17:03:25.243Z","repository":{"id":330345190,"uuid":"1122475599","full_name":"earningsfeed/earningsfeed-rust","owner":"earningsfeed","description":"Official Rust SDK for the EarningsFeed API - SEC filings, insider transactions, and institutional holdings","archived":false,"fork":false,"pushed_at":"2025-12-24T20:36:59.000Z","size":47,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-26T10:37:53.043Z","etag":null,"topics":["13f","api-client","finance","form-4","insider-trading","rust","rust-sdk","sec","sec-filings","stocks"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/earningsfeed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T20:15:34.000Z","updated_at":"2025-12-25T02:33:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/earningsfeed/earningsfeed-rust","commit_stats":null,"previous_names":["earningsfeed/earningsfeed-rust"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/earningsfeed/earningsfeed-rust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earningsfeed%2Fearningsfeed-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earningsfeed%2Fearningsfeed-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earningsfeed%2Fearningsfeed-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earningsfeed%2Fearningsfeed-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/earningsfeed","download_url":"https://codeload.github.com/earningsfeed/earningsfeed-rust/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earningsfeed%2Fearningsfeed-rust/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28314261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T14:58:17.114Z","status":"ssl_error","status_checked_at":"2026-01-11T14:55:53.580Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["13f","api-client","finance","form-4","insider-trading","rust","rust-sdk","sec","sec-filings","stocks"],"created_at":"2026-01-11T17:03:24.463Z","updated_at":"2026-01-11T17:03:25.238Z","avatar_url":"https://github.com/earningsfeed.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EarningsFeed Rust SDK\n\n[![Crates.io](https://img.shields.io/crates/v/earningsfeed)](https://crates.io/crates/earningsfeed)\n[![docs.rs](https://img.shields.io/docsrs/earningsfeed)](https://docs.rs/earningsfeed)\n\nOfficial Rust client for the [EarningsFeed API](https://earningsfeed.com/api) — SEC filings, insider transactions, and institutional holdings.\n\n## Installation\n\nAdd to your `Cargo.toml`:\n\n```toml\n[dependencies]\nearningsfeed = \"0.1\"\ntokio = { version = \"1\", features = [\"rt-multi-thread\", \"macros\"] }\n```\n\n## Quick Start\n\n```rust\nuse earningsfeed::EarningsFeed;\n\n#[tokio::main]\nasync fn main() -\u003e Result\u003c(), earningsfeed::Error\u003e {\n    let client = EarningsFeed::new(\"your_api_key\")?;\n\n    // Get recent 10-K and 10-Q filings\n    let params = earningsfeed::ListFilingsParams::builder()\n        .forms(vec![\"10-K\", \"10-Q\"])\n        .limit(10)\n        .build();\n\n    let filings = client.filings().list(\u0026params).await?;\n    for filing in filings.items {\n        println!(\"{}: {} - {}\", filing.form_type, filing.company_name, filing.title);\n    }\n\n    // Get a company profile\n    let apple = client.companies().get(320193).await?;\n    println!(\"{} ({})\", apple.name, apple.primary_ticker.unwrap_or_default());\n\n    Ok(())\n}\n```\n\n## Features\n\n- **Async/await** — Built on tokio and reqwest\n- **Streaming pagination** — Auto-pagination with `Stream`\n- **Type-safe** — Full Rust type definitions\n- **Builder patterns** — Ergonomic parameter construction\n\n## Usage\n\n### SEC Filings\n\n```rust\nuse earningsfeed::{EarningsFeed, ListFilingsParams};\nuse futures::StreamExt;\nuse std::pin::pin;\n\nlet client = EarningsFeed::new(\"your_api_key\")?;\n\n// List filings with filters\nlet params = ListFilingsParams::builder()\n    .ticker(\"AAPL\")\n    .forms(vec![\"10-K\", \"10-Q\", \"8-K\"])\n    .limit(25)\n    .build();\n\nlet filings = client.filings().list(\u0026params).await?;\n\n// Iterate through all filings (auto-pagination)\nlet params = ListFilingsParams::builder()\n    .ticker(\"AAPL\")\n    .forms(vec![\"8-K\"])\n    .build();\n\nlet filings_resource = client.filings();\nlet mut stream = pin!(filings_resource.iter(params));\n\nwhile let Some(result) = stream.next().await {\n    let filing = result?;\n    println!(\"{}\", filing.title);\n}\n\n// Get filing details with documents\nlet detail = client.filings().get(\"0000320193-24-000123\").await?;\nfor doc in detail.documents {\n    println!(\"{}: {}\", doc.doc_type, doc.filename);\n}\n```\n\n### Insider Transactions\n\n```rust\nuse earningsfeed::{EarningsFeed, ListInsiderParams, TransactionDirection};\nuse futures::StreamExt;\nuse std::pin::pin;\n\nlet client = EarningsFeed::new(\"your_api_key\")?;\n\n// Recent insider purchases\nlet params = ListInsiderParams::builder()\n    .ticker(\"AAPL\")\n    .direction(TransactionDirection::Buy)\n    .codes(vec![\"P\"]) // Open market purchases\n    .limit(50)\n    .build();\n\nlet purchases = client.insider().list(\u0026params).await?;\n\nfor txn in purchases.items {\n    println!(\n        \"{}: {} shares @ ${:.2}\",\n        txn.person_name,\n        txn.shares.unwrap_or_default(),\n        txn.price_per_share.unwrap_or_default()\n    );\n}\n\n// Large sales across all companies\nlet params = ListInsiderParams::builder()\n    .direction(TransactionDirection::Sell)\n    .min_value(1_000_000)\n    .build();\n\nlet insider_resource = client.insider();\nlet mut stream = pin!(insider_resource.iter(params));\n\nwhile let Some(result) = stream.next().await {\n    let txn = result?;\n    println!(\"{}: ${}\", txn.company_name.unwrap_or_default(), txn.transaction_value.unwrap_or_default());\n}\n```\n\n### Institutional Holdings (13F)\n\n```rust\nuse earningsfeed::{EarningsFeed, ListInstitutionalParams};\nuse futures::StreamExt;\nuse std::pin::pin;\n\nlet client = EarningsFeed::new(\"your_api_key\")?;\n\n// Who owns Apple?\nlet params = ListInstitutionalParams::builder()\n    .ticker(\"AAPL\")\n    .min_value(1_000_000_000) // $1B+ positions\n    .build();\n\nlet holdings = client.institutional().list(\u0026params).await?;\n\nfor h in holdings.items {\n    println!(\"{}: {} shares (${:.0})\", h.manager_name, h.shares, h.value);\n}\n\n// Track a specific fund (Berkshire Hathaway)\nlet params = ListInstitutionalParams::builder()\n    .manager_cik(1067983)\n    .build();\n\nlet institutional_resource = client.institutional();\nlet mut stream = pin!(institutional_resource.iter(params));\n\nwhile let Some(result) = stream.next().await {\n    let h = result?;\n    println!(\"{}: {} shares\", h.issuer_name, h.shares);\n}\n```\n\n### Companies\n\n```rust\nuse earningsfeed::{EarningsFeed, SearchCompaniesParams};\n\nlet client = EarningsFeed::new(\"your_api_key\")?;\n\n// Get company profile\nlet company = client.companies().get(320193).await?;\nprintln!(\"{}\", company.name);\nprintln!(\"Ticker: {}\", company.primary_ticker.unwrap_or_default());\nif let Some(sic) = company.sic_codes.first() {\n    println!(\"Industry: {}\", sic.description.as_deref().unwrap_or(\"Unknown\"));\n}\n\n// Search companies\nlet params = SearchCompaniesParams::builder()\n    .q(\"software\")\n    .state(\"CA\")\n    .limit(10)\n    .build();\n\nlet results = client.companies().search(\u0026params).await?;\nfor company in results.items {\n    println!(\"{} ({})\", company.name, company.ticker.unwrap_or_default());\n}\n```\n\n## Error Handling\n\n```rust\nuse earningsfeed::{EarningsFeed, Error};\n\nlet client = EarningsFeed::new(\"your_api_key\")?;\n\nmatch client.filings().get(\"invalid-accession\").await {\n    Ok(filing) =\u003e println!(\"Found: {}\", filing.title),\n    Err(Error::NotFound { path }) =\u003e println!(\"Filing not found: {}\", path),\n    Err(Error::RateLimit { reset_at }) =\u003e {\n        println!(\"Rate limited. Resets at: {:?}\", reset_at);\n    }\n    Err(Error::Authentication) =\u003e println!(\"Invalid API key\"),\n    Err(e) =\u003e println!(\"Error: {}\", e),\n}\n```\n\n## Configuration\n\n```rust\nuse earningsfeed::{EarningsFeed, ClientConfig};\nuse std::time::Duration;\n\n// Custom configuration\nlet config = ClientConfig::builder()\n    .api_key(\"your_api_key\")\n    .timeout(Duration::from_secs(60))\n    .base_url(\"https://earningsfeed.com\") // Optional, this is the default\n    .build()?;\n\nlet client = EarningsFeed::with_config(config)?;\n```\n\n## API Reference\n\nFull API documentation: [earningsfeed.com/api/docs](https://earningsfeed.com/api/docs)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fearningsfeed%2Fearningsfeed-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fearningsfeed%2Fearningsfeed-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fearningsfeed%2Fearningsfeed-rust/lists"}