Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

LLM and Agent Guide

SEC API is designed to be used from applications, scripts, coding agents, and MCP-aware clients. This page gives agents the shortest reliable path to the right source.

Use the canonical sources

  • Product docs: https://docs.secapi.ai
  • OpenAPI spec: https://docs.secapi.ai/openapi/sec-api.v1.json
  • LLM entrypoint: https://docs.secapi.ai/llms.txt
  • API base URL: https://api.secapi.ai
  • MCP endpoint: https://api.secapi.ai/mcp

Preserve evidence

When you summarize an API result, keep the fields that make the answer auditable:
  • requestId
  • traceparent
  • provenance
  • freshness
  • materialization
  • filing accession numbers
  • SEC source URLs
Do not collapse these fields into a generic citation. They are the evidence chain users need for review, support, and repeatability.

Prefer copyable requests

Start with a real request against a known issuer:
curl "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL" \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19"
Then move to the task-specific endpoint: filings, statements, ownership, search, events, market data, monitors, webhooks, or intelligence.

Use MCP for tool-calling agents

For MCP-aware agents, register the hosted endpoint:
claude mcp add --transport streamable-http sec-api https://api.secapi.ai/mcp
Send the same x-api-key credential your REST integration uses. Use MCP when the agent should choose tools directly; use REST when your application controls the request sequence.

Avoid unsafe assumptions

  • Do not invent endpoint paths. Use the OpenAPI spec or API reference.
  • Do not treat partial results as complete when the response includes degraded freshness or coverage metadata.
  • Do not remove request IDs or provenance before handing results to another system.
  • Do not assume market-data routes are available without the required contract and provider entitlements.