{"id":50727322,"url":"https://github.com/secapi-ai/secapi-go","last_synced_at":"2026-06-10T05:01:50.697Z","repository":{"id":359331525,"uuid":"1245088754","full_name":"secapi-ai/secapi-go","owner":"secapi-ai","description":"Official Go SDK for SEC API","archived":false,"fork":false,"pushed_at":"2026-06-09T23:22:44.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T01:11:45.121Z","etag":null,"topics":["financial-data","go","mcp","sdk","sec-api","sec-edgar","sec-filings"],"latest_commit_sha":null,"homepage":"https://docs.secapi.ai/go-sdk","language":"Go","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/secapi-ai.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":"2026-05-20T22:41:04.000Z","updated_at":"2026-06-09T23:22:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/secapi-ai/secapi-go","commit_stats":null,"previous_names":["secapi-ai/secapi-go"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/secapi-ai/secapi-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secapi-ai%2Fsecapi-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secapi-ai%2Fsecapi-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secapi-ai%2Fsecapi-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secapi-ai%2Fsecapi-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/secapi-ai","download_url":"https://codeload.github.com/secapi-ai/secapi-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secapi-ai%2Fsecapi-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34137570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["financial-data","go","mcp","sdk","sec-api","sec-edgar","sec-filings"],"created_at":"2026-06-10T05:01:49.956Z","updated_at":"2026-06-10T05:01:50.693Z","avatar_url":"https://github.com/secapi-ai.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SEC API Go SDK\n\nOfficial Go SDK for [SEC API](https://secapi.ai), the SEC data API designed for agents.\n\nSEC API turns SEC filings and adjacent market data into traceable, source-backed investor workflows. It provides REST, SDK, CLI, and hosted MCP surfaces over filings, statements, ownership, governance, market data, events, webhooks, and agent-ready intelligence workflows.\n\nUse this SDK when you want SEC API inside Go services, workers, command-line tools, or backend jobs while preserving the response metadata that matters: `requestId`, provenance, freshness, materialization state, trace references, accession numbers, and SEC source URLs.\n\n## Install\n\n```bash\ngo get github.com/secapi-ai/secapi-go\n```\n\n## Quick Start\n\n```go\npackage main\n\nimport (\n    \"fmt\"\n    \"os\"\n\n    secapi \"github.com/secapi-ai/secapi-go\"\n)\n\nfunc main() {\n    client := secapi.NewClient(os.Getenv(\"SECAPI_API_KEY\"))\n\n    entity, err := client.ResolveEntity(map[string]string{\"ticker\": \"AAPL\"})\n    if err != nil {\n        panic(err)\n    }\n\n    fmt.Println(entity[\"name\"])\n}\n```\n\n## Authentication\n\nCreate an API key from the SEC API site, then export it:\n\n```bash\nexport SECAPI_API_KEY=your_key_here\n```\n\nThe SDK sends your key with the `x-api-key` header.\n\n## Configuration\n\n```go\nclient := secapi.NewClient(os.Getenv(\"SECAPI_API_KEY\"))\nclient.BaseURL = \"https://api.secapi.ai\"\n```\n\n`NewSecApiClient` remains available as a compatibility alias for `NewClient`.\n\n## Common Workflows\n\nResolve a company:\n\n```go\nentity, err := client.ResolveEntity(map[string]string{\"ticker\": \"AAPL\"})\nif err != nil {\n    panic(err)\n}\nfmt.Println(entity[\"name\"])\n```\n\nFetch the latest 10-K:\n\n```go\nfiling, err := client.LatestFiling(map[string]string{\n    \"ticker\": \"AAPL\",\n    \"form\": \"10-K\",\n})\nif err != nil {\n    panic(err)\n}\nfmt.Println(filing[\"title\"], filing[\"filingDate\"])\n```\n\nFind high-risk dilution issuers:\n\n```go\nratings, err := client.DilutionRatings(map[string]string{\n    \"overall_risk\": \"high\",\n    \"limit\": \"10\",\n})\nif err != nil {\n    panic(err)\n}\nfmt.Println(ratings[\"object\"])\n```\n\n## Agent Setup\n\nGive this prompt to a coding agent:\n\n```text\nInstall github.com/secapi-ai/secapi-go in this Go service. Start with one entity lookup to confirm auth, then add a filing or ownership workflow that preserves requestId, freshness, provenance, and trace metadata in structured logs. Use https://docs.secapi.ai/llms.txt as the documentation index and prefer the OpenAPI spec over guessing endpoint paths.\n```\n\nFor broader agent instructions, use:\n\n- [`llms.txt`](https://docs.secapi.ai/llms.txt)\n- [Give this prompt to your agent](https://docs.secapi.ai/give-this-prompt-to-your-agent)\n- [LLM and agent guide](https://docs.secapi.ai/llm-guide)\n\n## Environment Variables\n\n| Variable | Description |\n|---|---|\n| `SECAPI_API_KEY` | SEC API key |\n| `SECAPI_BASE_URL` | API base URL override |\n\n## Validate\n\n```bash\ngo test ./...\ngo list -m github.com/secapi-ai/secapi-go\n```\n\n## Links\n\n- [SEC API](https://secapi.ai)\n- [Developer docs](https://docs.secapi.ai)\n- [Go SDK guide](https://docs.secapi.ai/go-sdk)\n- [API reference](https://docs.secapi.ai/api-reference)\n- [API playground](https://docs.secapi.ai/api-playground)\n- [Libraries and SDKs](https://docs.secapi.ai/libraries-and-sdks)\n- [Auth and pricing](https://docs.secapi.ai/auth-and-pricing)\n- [Freshness and trust](https://docs.secapi.ai/freshness-and-trust)\n- [Status](https://docs.secapi.ai/status)\n- [Support](https://docs.secapi.ai/support)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecapi-ai%2Fsecapi-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsecapi-ai%2Fsecapi-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecapi-ai%2Fsecapi-go/lists"}