# Finks API

> Financial context for AI agents: search financial news, filings and market data by meaning, read the whole record behind a result, and screen US companies.

## Instructions for agents

- Base URL: https://data.finks.ai. Every route answers JSON.
- Auth: send `Authorization: Bearer $FINKS_API_KEY` on every request. Read the key from the environment; never print, log or commit it.
- Keys: every key (`fk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`) draws from your account's one credit balance: your plan's credits, then overage on paid plans. Get one: a free account at https://dashboard.finks.ai/signin comes with a key; https://dashboard.finks.ai/keys makes more.
- MCP: https://mcp.data.finks.ai/mcp (streamable HTTP), 11 read-only tools: sign in (OAuth) where the client supports it, else the same Bearer header.
- Contract: the OpenAPI 3 spec at https://finks.ai/docs/openapi.json lists every route and field.
- Errors: `{"error": {"code", "message", "request_id", "details"}}`. Branch on `code`; only `429 rate_limit.exceeded` sends `Retry-After`.
- Paging: Search, while `has_more` is true, resend the same body with `cursor` set to `next_cursor`. Screener, while `next_cursor` is set, resend the query with `query.cursor` set to it.

## Docs

- [Overview](https://finks.ai/docs.md): Connect, the base URL and the endpoints.
- [Quickstart](https://finks.ai/docs/quickstart.md): From a key to a search and the record behind a result.
- [Authentication](https://finks.ai/docs/authentication.md): Send your key, rotate and revoke it.
- [MCP server](https://finks.ai/docs/mcp.md): Give Claude, Cursor or any MCP client the Finks API tools.
- [Usage and limits](https://finks.ai/docs/limits.md): What is metered, rate limits, caps and how to check usage.
- [Errors](https://finks.ai/docs/errors.md): The error envelope, every code and what to do about it.

## Endpoints

- [Search](https://finks.ai/docs/reference/search.md): Find the news, filings and calls behind any market question.
- [Records](https://finks.ai/docs/reference/records.md): Go from a search result to the full story.
- [Screener](https://finks.ai/docs/reference/screener.md): Find the companies that match your criteria.
- [Company and filings](https://finks.ai/docs/reference/filings.md): Follow a company's filings and news as they land.
- [Account](https://finks.ai/docs/reference/account.md): Check your plan, your usage and what your key can reach.

## Optional

- [Every page in one file](https://finks.ai/llms-full.txt): the docs above as one Markdown file.
- [Agent skill](https://finks.ai/SKILL.md): set up Finks API in a coding agent (connect, authenticate, verify) and pick the right tool for a task.
- [Data Library](https://dashboard.finks.ai/data): the datasets, their sources and how often they update.