# FinancialData.Net

> A single read-only REST API for financial market data — equities, ETFs, indices, options, futures,
> crypto, forex, mutual funds — plus company fundamentals, financial statements and ratios, market
> news, event calendars, macroeconomic indicators, insider and institutional trading, ESG scores and
> investment-adviser records. 86 documented GET endpoints under https://financialdata.net/api/v1/,
> authenticated with an API key in the `key` query parameter, returning JSON or CSV. Much of the
> data is sourced from public US regulators (SEC, FINRA, Federal Reserve) and the payloads carry the
> standard securities identifier schemes (ISIN, LEI, CUSIP, FIGI, SEC CIK). A first-party hosted MCP
> server maps every endpoint to a tool for AI agents. Free tier available; five published plans.

FinancialData.Net publishes NO OpenAPI, AsyncAPI, GraphQL schema, Postman collection or llms.txt of
its own — this file is generated by API Evangelist from the provider's public documentation and from
live probes, and every artifact linked below records its own method and source. The provider's
documentation is server-rendered HTML and fully readable; the machine-readable contract is what is
missing.

Key facts an agent should know before calling:
- Auth is a QUERY PARAMETER, not a header: append `?key=API_KEY` (or `&key=API_KEY`) to every URL.
- Every operation is a GET. There is no write surface, so nothing here can be undone — and nothing
  needs to be.
- Pagination is `offset` only, on 57 of the 86 endpoints, with a per-call record cap of 300 or 500
  stated in each endpoint's description. Responses are bare JSON arrays: no total, no next link, no
  has_more. Keep incrementing `offset` until a short array comes back.
- Errors are `{"message": "<string>"}` with no machine-readable code; an unknown path returns HTML,
  not JSON.
- No rate-limit headers are returned. The ceiling comes from the plan: 300 requests/day on Free,
  10/s on Standard, 30/s on Premium and Professional, 50/s on Enterprise.
- Plan gating is real: 9 endpoints answer on Free, 43 on Standard, all 86 on Premium and above. The
  MCP server needs Professional or Enterprise.
- Timezones differ by surface: quotes are EST, minute bars are UTC, and no offset is in the payload.

## APIs

- [FinancialData.Net REST API](https://financialdata.net/documentation): 86 GET endpoints at
  https://financialdata.net/api/v1/ covering symbols, prices, quotes, fundamentals, statements,
  ratios, news, calendars, economic data, insider and institutional trading, ETFs, mutual funds, ESG
  and investment advisers.
- [FinancialData.Net MCP Server](https://financialdata.net/mcp-server): hosted remote MCP endpoint at
  https://financialdata.net/mcp?key=API_KEY. Every REST endpoint has a corresponding tool named
  get + PascalCase(path) — getStockSymbols, getIncomeStatements, getEtfPrices, getStockPrices.
  Professional and Enterprise plans only; anonymous tools/list returns JSON-RPC error -32001.

## Docs

- [Documentation](https://financialdata.net/documentation): every endpoint with parameters and a
  sample response.
- [MCP server setup](https://financialdata.net/mcp-server)
- [ChatGPT setup guide](https://financialdata.net/chatgpt-stock-data)
- [Excel add-in](https://financialdata.net/excel-addin): `=FDN(dataset, identifier, argument, maxRows)`
- [Pricing](https://financialdata.net/pricing)
- [Changelog](https://financialdata.net/changelog): 18 dated releases since 2024-12-10, all additive.
- [FAQ](https://financialdata.net/faq)
- [Status](https://financialdata.instatus.com)
- [Terms of Service](https://financialdata.net/terms-of-service)
- [Privacy Policy](https://financialdata.net/privacy-policy)
- [Contact](https://financialdata.net/contact-us) — info@financialdata.net

## SDKs

- [fdnpy](https://pypi.org/project/fdnpy/) — official Python SDK, v0.5.0 (2026-07-24).
  `pip install fdnpy`; `FinancialDataClient(api_key=...)` with a `get_<endpoint>()` method per
  endpoint, automatic pagination and retries.
  [Source](https://github.com/financialdatanet/fdnpy)
- No first-party JavaScript, Java, .NET, Go, Ruby, PHP or Rust client exists — npm, Maven Central,
  NuGet, pkg.go.dev, RubyGems, Packagist and crates.io were all queried and hold none.

## Artifacts

- [apis.yml](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/apis.yml)
- [MCP manifest](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/mcp/financialdata-net-mcp.yml)
- [Authentication](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/authentication/financialdata-net-authentication.yml)
- [Conventions](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/conventions/financialdata-net-conventions.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/data-model/financialdata-net-data-model.yml)
- [Response examples](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/examples/financialdata-net-response-examples.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/errors/financialdata-net-problem-types.yml)
- [Plans and pricing](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/plans/financialdata-net-plans-pricing.yml)
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/rate-limits/financialdata-net-rate-limits.yml)
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/lifecycle/financialdata-net-lifecycle.yml)
- [Changelog](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/changelog/financialdata-net-changelog.yml)
- [Conformance](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/conformance/financialdata-net-conformance.yml)
- [Packages](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/packages/financialdata-net-packages.yml)
- [Components](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/components/financialdata-net-components.yml)
- [Domain security](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/security/financialdata-net-domain-security.yml)
- [Well-known probe](https://raw.githubusercontent.com/api-evangelist/financialdata-net/main/well-known/financialdata-net-well-known.yml)

## Not published by this provider

- No OpenAPI, Swagger, GraphQL schema, gRPC/protobuf, WSDL or Postman collection.
- No AsyncAPI, webhooks or streaming surface.
- No /.well-known/ documents of any kind (security.txt, openid-configuration,
  oauth-authorization-server, api-catalog, ai-plugin.json, agent-card.json all 404).
- No A2A agent card.
- No sandbox or test environment — the Free plan is live data at a lower quota.
- No CLI.
- No published error reference, no rate-limit headers, no SLA, no deprecation policy.
- No SOC 2 / ISO 27001 / PCI / HIPAA compliance program, trust center or vulnerability-disclosure
  policy.