Skip to content

Finks Agents API: hosted financial agents for your app

Ship financial AI features faster. Hand off a question, and a Finks agent searches, reads, and answers, with every claim quoting its source.

Start building
Example

Prepare me for my meeting with a client who holds Apple, JPMorgan, and Exxon Mobil. What changed since we last met in August?

All three holdings reported since August: Apple grew revenue 12%, JPMorgan earned $15.3 billion through a securities loss, and Exxon returned $9.4 billion to shareholders.Apple 8-KJPM 8-KXOM 8-K

Apple

  • Results: fiscal fourth-quarter revenue rose 12% to $114.5 billion, and diluted EPS rose 14% to $2.10Apple 8-K.
  • Tariff refunds: added about 1 point to gross margin and $0.05 to EPSApple 8-K.
  • Income and debt: a $0.27 dividend is payable November 16Apple 8-K, and Apple sold $7.5 billion of notes on November 9Apple notes.

JPMorgan

  • Results: third-quarter net income was $15.3 billion, or $15.8 billion excluding $658 million of securities lossesJPM 8-K.
  • Credit: the provision for credit losses was $2.7 billion, including a $539 million reserve buildJPM 8-K.
  • Wealth: assets under management reached $5.2 trillion, up 13%JPM 8-K.

Exxon Mobil

  • Results: third-quarter earnings were $15.4 billion, with $25.7 billion of operating cash flowXOM 8-K.
  • Shareholder returns: $9.4 billion returned in the quarter, a $1.07 dividend payable December 10, and $20 billion of buybacks planned for 2027XOM 8-K.
  • Refining: Exxon reported record year-to-date refining performanceXOM 8-K.

Building an agent yourself

A financial agent needs tools, a loop that runs them, and a check on what it writes.

  1. 01Wire up the toolsSearch, read, and screen each need a schema, a client, and error handling.
  2. 02Run the loopPlan the steps, call the tools, read the results, and know when to stop.
  3. 03Check every claimMatch each sentence to a source before a user sees it.

Finks runs that loop for you: one call returns an answer with every claim quoting its source.

What a run returns

Every step the agent took, then an answer whose claims each quote what it read.

  1. 1statusRunning, then succeeded or failed
  2. 2traceEach step the agent took
  3. 3answer.textThe answer
  4. 4claimsEach claim, with the source text it quotes word for word

Response

{  "research_id": "rsch_…",1  "status": "succeeded",2  "trace": [    { "step": 1, "label": "…", "route": "/v1/search", "status": 200 },    …  ],  "answer": {    "found": true,3    "text": "…",4    "claims": [      { "text": "…", "citations": [{ "title": "…", "quote": "…" }] },      …    ]  }}

Put an agent on every workflow

  • Fintech and brokerage apps

    Answer users' questions about any company, inside your app.

  • Wealth platforms

    Hand off meeting prep and client updates.

  • Research teams

    Get a cited first pass on any company.

Connect the Finks MCP server or API in minutes

Add the Finks MCP server to Claude, ChatGPT, Cursor, or any MCP client, or call the REST API from your product.

  • AI apps

    Paste one URL into Claude, ChatGPT, or Grok and sign in.

  • Coding agents

    One command adds Finks to Claude Code, Codex, or Gemini CLI.

  • REST API

    One key and one request return cited results to your product.

Start building

Get set up in minutes on the free tier.

Questions about the Finks Agents API

What is the Finks Agents API?

A hosted agent for financial questions. POST /v1/research takes a question; Finks searches its data, reads what it needs, and returns an answer whose claims each quote their source.

How is it different from the Search API?

POST /v1/search returns ranked results for your own agent to reason over. POST /v1/research runs the agent for you and returns the finished answer.

How long does a run take?

Fast mode usually takes about a minute; Research mode reads more and takes up to two minutes. Poll GET /v1/research/{research_id} every two seconds until it finishes.

How do I know the answer is right?

Each claim carries citations that quote the text Finks served, word for word, and the run checks those quotes before it writes the answer.

Is it available now?

The Agents API is in beta. Talk to us for access.

Put Finks agents in your product

The Agents API is in beta. Talk to us for access, or start free with search.

Start building